> For the complete documentation index, see [llms.txt](https://docs.resifactory.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.resifactory.net/imap/clients.md).

# Client setup

Every client needs the same four things. What differs is where each tool puts them and what it calls them.

```
Host      mail.resifactory.net
Port      993
Security  SSL / TLS
Username  <your login email>
Password  <an app password>
```

## Pick your client

| Client                                               | The thing to get right                                                    |
| ---------------------------------------------------- | ------------------------------------------------------------------------- |
| [**Refract**](/imap/clients/refract.md)              | Enter the server **with the port attached** — `mail.resifactory.net:993`. |
| [**Shikari**](/imap/clients/shikari.md)              | Set a **15-minute** inbox window on the app password.                     |
| [**AYCD**](/imap/clients/aycd.md)                    | Import the mailboxes directly with the ready-made CSV export.             |
| [**Desktop mail clients**](/imap/clients/desktop.md) | Thunderbird, Apple Mail, Outlook, K-9 and friends.                        |
| [**Your own code**](/imap/clients/custom-code.md)    | Python, Node and Go examples that read the unified inbox.                 |

## Two rules that apply to all of them

{% hint style="warning" %}
**Never use your sign-in password in a client.** Create an [app password](/imap/app-passwords.md) — one per tool. It can be revoked on its own and it carries its own settings.
{% endhint %}

{% hint style="success" %}
**Always set an** [**inbox window**](/imap/inbox-window.md) **on that app password.** Match it to what the tool actually needs to see: minutes for codes, days for order tracking, weeks for reading by hand.
{% endhint %}

## If your client is not listed

Any IMAP client works. Look for a setup screen that asks for an incoming mail server, and use the four values at the top of this page. If it asks for an outgoing (SMTP) server, leave it blank — this server does not send mail.

Things that trip up unusual clients:

* **Only one folder exists** (`INBOX`). Clients that insist on mapping Sent, Drafts or Trash should have those left unset, or all pointed at `INBOX`.
* **Implicit TLS on 993**, never STARTTLS on 143.
* **Some clients want host and port in one field.** If yours has a single "server" box and no separate port box, type `mail.resifactory.net:993`.

Still stuck? [Troubleshooting](/imap/troubleshooting.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.resifactory.net/imap/clients.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.