User manual

Before you begin

Agres connects to the mail servers you configure. Your provider may require an app-specific password. OAuth-only accounts are not supported. Loading remote images or opening links contacts their hosts; sender-domain signals do not guarantee that a message is safe. Agres asks permission to show notifications. You can review that permission in the iOS Settings app; you can still open Agres to check mail if alerts are disabled.

Connect your first mailbox

1. Have your mail provider’s incoming and outgoing server settings ready.
2. Open the upper-left menu.
3. Choose Accounts.
4. Tap Add.
5. Enter a name for the account in Display Name.
6. Enter your address in Email Address.
7. Enter the account password or provider-issued app password in Password.
8. Under Incoming, choose the provider’s Protocol: IMAP or POP3.
9. Enter the incoming server in Host.
10. Enter the incoming Port.
11. Set Use TLS or Use STARTTLS according to the provider’s instructions.
12. Under SMTP (Send), enter the outgoing server in Host.
13. Enter the outgoing Port.
14. Set the outgoing Use TLS or Use STARTTLS option according to the provider’s instructions.
15. Tap Test Connection.
16. Review the connection result.
17. Tap Save when the test and account details are correct.

What to expect. The account appears in Accounts and downloaded messages appear in E-mail. A provider may require an app-specific password. Leave Allow untrusted TLS (debug) disabled for normal use.

Find and organize email

1. Choose E-mail at the top.
2. Select Unread, Read, Pinned, Sent, Drafts, or Trash to choose the list.
3. Tap the magnifying glass to search.
4. Enter a subject, address, or text from a downloaded message.
5. For IMAP accounts, tap Search on Server if you need to search mail that is not downloaded.
6. Open a message from the sender you want to categorize.
7. Tap the ellipsis beside the sender address.
8. Choose a category, or General to remove the assignment.

What to expect. The list shows the chosen mode or search results. Create categories through Menu > Categories before assigning them. Categories are local to Agres and do not create server folders. Opening unread mail marks it read; the temporary Undo control can reverse that change.

Flag a familiar name using an unexpected domain

1. Open the upper-left menu.
2. Choose Categories.
3. Tap Add.
4. Enter a category name such as Suspicious.
5. Tap Save.
6. Return to the upper-left menu.
7. Choose Sender Domain Check.
8. Tap Add.
9. Enter the name shown in the sender’s emails in Sender Name.
10. Enter an independently verified official domain in Add domain (e.g. example.com).
11. Tap the green + beside the domain field.
12. Repeat the domain-entry and + actions for each additional official domain.
13. Tap Save.
14. Set Mismatch Category to the category you created.
15. Open a message from that sender.
16. Inspect the shield beside the sender information.

What to expect. Orange indicates an unexpected domain for a registered name, green indicates a match, and gray means unregistered. These signals do not guarantee safety. If no domain is added to the list before saving, every message using that registered name is treated as suspicious. Keep Show images off for messages you do not trust.

Reply to a message

1. Open the message you want to answer.
2. Tap the reply arrow.
3. Choose whether to include other recipients if the app asks.
4. Review the recipients.
5. Write your reply.
6. Tap Send when it is ready.

What to expect. The reply is sent through the account’s outgoing server. If sending fails, an Unable to Send alert shows the error. Tap OK to return to the message; its recipients, text, and attachments remain in the compose screen. Review the error, recipient addresses, and the account’s SMTP (Send) settings before trying again.

Make a calendar event from a message

1. Open the message you want to follow up on.
2. Tap the calendar button.
3. Enter the event Title.
4. Enable All-day only if the event lasts all day.
5. Choose Start.
6. Choose End.
7. Tap Add.

What to expect. The event appears in Calendar with a link to the message. The link remains usable while the account and source message are available. For a task instead of an event, the message’s checklist button opens Add To Do, with What needs to be done?, optional dates, and an Add button.

Break a follow-up into smaller steps

1. Open To Do from the top of the main screen.
2. Tap + to open Add To Do, or tap the pencil beside an existing task.
3. Enter the main task in What needs to be done? (Title when editing).
4. Enter a step in Add sub task under Sub Tasks.
5. Tap Add beside that field.
6. Tap the new step’s title to add smaller steps within it.
7. Return to the main task editor.
8. Tap Add at the top, or Save for an existing task.

The task and its steps appear in To Do. Tap a task title with child items to expand them. The status icon lets you choose New, Started, or Completed. Completing a parent completes its children; changing a child updates the parent’s progress. Use the pencil to edit a task, including its optional Start Date and Due Date.

To reorganize an existing task, open its ellipsis menu and choose Move under…, then tap a parent task. The task and its children move together. Move out one level and Make top-level reverse nesting; Move up and Move down reorder siblings. A task cannot be placed inside its own descendants. If no parent is offered, clear the search or choose a different task.

Removing a step in the editor also removes its nested children. A step with children asks for confirmation. To remove a task from the list, use Edit and its deletion control. Keep a backup before deleting work you may need later; the app does not offer an undo for task deletion.

Keep a meeting invitation beside its email

1. Open an email containing a standard iCalendar meeting invitation.
2. Wait for the full message to load.
3. Review the Meeting invitation section and its import status.
4. Open Calendar to find an invitation reported as Added to Agres Calendar.
5. Open the event’s linked email when you need the original details.

Supported one-off invitations are added to Agres’s local calendar automatically when the email is opened. Newer updates replace the matching imported event; a matching cancellation removes it when that email is opened. This does not send an acceptance or decline, and it does not add events to Apple Calendar.

Recurring invitations and unsupported dates or time zones are displayed with an explanation rather than imported automatically. A meeting response is not a new invitation. Check the original attachment if an invitation cannot be read. If saving fails, reopen the email to retry. Deleting an imported event does not make the same invitation import again; use the calendar button to create a local event manually if needed.

Make HTML email easier to read

1. Open a message that includes an HTML body.
2. Choose HTML in the body selector.
3. Use − or + beside HTML zoom to adjust the display.

The range is 75% to 250%, in 25% steps. The selected zoom is remembered. If the message has no HTML body, choose another available format, such as Plain. Show images controls remote images; leave it off for messages you do not trust. Opening a link contacts its destination.

Review permissions and privacy information

1. Open the upper-left menu.
2. Choose Privacy Policy to open North Star Gate’s policy.
3. To review alert permission, open the iOS Settings app and find Agres’s notification settings.

If notifications are disabled, open Agres to check your mail. Calendar events and tasks stay inside Agres. Mail receipt, sending, server search, holiday lookup, remote images, and web links need an available network connection.

Back up settings and recover from connection errors

1. Open the upper-left menu.
2. Choose Export Backup….
3. Save the backup to a destination you control.
4. When you need to restore a backup, reopen the menu.
5. Choose Import Backup….
6. Select an Agres backup file.
7. Re-enter credentials if a restored account cannot authenticate on this device.
8. If mail does not load, pull down on the message list to refresh.
9. For a persistent connection error, open Accounts from the menu.
10. Review the affected account’s server settings and credentials.
11. Use Retry or View Logs when the account error offers them.
12. Choose Export Logs… from the menu when you need diagnostic files for support.

What to expect. Import replaces stored configuration and restores local state. Keep the current export before importing a different backup. Backups exclude passwords and authentication tokens. Exported logs may contain private account and message-related details; review the destination before sharing.

If something goes wrong

Unable to send?

In Agres 1.07, read the Unable to Send error, then tap OK. Your message remains open. Check the recipient addresses and your provider’s outgoing server, port, TLS settings, and password or app password. Under Accounts, use Test Connection to check the account settings. SMTP errors may name the failed stage, such as MAIL FROM, RCPT TO, or DATA. If the problem continues, use Export Logs… and review the diagnostic files before sharing them with support.

Mail is not arriving?

Refresh the message list, then check Accounts for the server, port, TLS settings, and credentials. Use Test Connection before saving changes.

Moving your setup?

Use Export Backup… before Import Backup…. Import replaces configuration, and backups exclude passwords and authentication tokens.

Need connection details?

Use Retry or View Logs when offered. Export Logs… saves diagnostics for support; review logs before sharing because they may include account and message details.