> 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/getting-started/quick-start.md).
# Quick start
## 1. Sign in
Go to [**https://mail.resifactory.net**](https://mail.resifactory.net) and sign in with the email and password you were given.
Your account email ends in `@buyers.resifactory.net`. That address is your identity on the mail server — it is not a mailbox you receive mail at.
{% hint style="info" %}
First thing after signing in: open **Settings → Recovery email** and confirm a recovery address. Without one, nobody can reset your password without a manual support request. It takes ten seconds. See [Signing in](/getting-started/signing-in.md).
{% endhint %}
## 2. Check your mailboxes arrived
Open **Accounts**. You should see the mailboxes you bought, with a green `healthy` dot next to most of them.
Every mailbox you own, with its health and batch.
The count in the header (`100 of 250`) means 100 rows are loaded of 250 total — scrolling loads more. See [Accounts](/the-console/accounts.md).
## 3. Create an app password
This is the credential your IMAP tools will use. It is separate from your sign-in password and can be revoked without affecting anything else.
Open **App passwords** → **New**.
Fill in:
| Field | What to put |
| ----------------- | ------------------------------------------------------------------------------------------ |
| **Label** | Anything that tells you which tool holds it — `refract-desktop`, `shikari-main`, `laptop`. |
| **Scope** | Leave on **Unified** unless you specifically want one batch only. |
| **IMAP username** | Leave as your login email. This is the username your client will use. |
| **Inbox window** | **Set one.** See the guidance below. |
| **IP allowlist** | Optional. Leave blank unless you have a fixed IP. |
### Choosing the window
{% tabs %}
{% tab title="Shikari" %}
**Last 15 minutes.**
Shikari re-reads the inbox continuously while waiting for a code. A tight window keeps every read small, so codes surface in seconds.
More: [Shikari](/imap/clients/shikari.md)
{% endtab %}
{% tab title="Codes and OTP tools" %}
**Last 1 hour** or **Last 6 hours.**
Anything that only cares about a code that just arrived wants a small window.
{% endtab %}
{% tab title="Order tracking" %}
**Last 7 days** or **Last 14 days.**
Shipping updates arrive days after the order, so the window has to be long enough to still contain the original confirmation.
{% endtab %}
{% tab title="A mail client you read by hand" %}
**Last 1 month** or **Last 3 months.**
You want history you can scroll through, but not so much that first sync takes forever.
{% endtab %}
{% endtabs %}
Press **Create**. The password appears **once**:
Copy it now. It cannot be shown again.
Copy it somewhere safe before closing the dialog. If you lose it, revoke the password and make a new one — there is no way to recover it.
## 4. Connect your tool
Use these four values:
```
Host mail.resifactory.net
Port 993
Security SSL / TLS
Username
Password
```
{% hint style="warning" %}
**In Refract, the port goes in the server field:** enter `mail.resifactory.net:993`. Refract will not connect properly with just `mail.resifactory.net`. See [Refract](/imap/clients/refract.md).
{% endhint %}
Per-tool walkthroughs:
{% content-ref url="/pages/9tnVsyGhGACdYZJdA6BT" %}
[Client setup](/imap/clients.md)
{% endcontent-ref %}
## 5. Confirm it worked
Two checks:
1. Your client should show a folder called **INBOX** with mail in it. That is the only folder — every mailbox you own is merged into it.
2. Back in the console, **App passwords** shows a **Last used** time on the row you just created. If it still says `–`, nothing has connected with it yet.
Last used is the proof a credential is live.
If it did not connect, go to [Troubleshooting](/imap/troubleshooting.md) — it is ordered by how common each cause is.
## What next
* [Understand the inbox window properly](/imap/inbox-window.md) — the single setting that most affects how fast codes arrive.
* [Export your credentials](/credentials/exporting.md) — get the mailbox logins and passwords out in CSV, JSON, or a plain `email:password` list.
* [Learn the console](/the-console/dashboard.md) — every screen and filter.
---
# 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/getting-started/quick-start.md?ask=&goal=
```
`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.