> 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/the-console/settings.md).

# Settings

Two kinds of thing live here: settings that are yours to change, and information about the server that is useful to read.

<figure><img src="/files/aK7Tw9gFxpxK8hSqrPCg" alt="The Settings page showing Service, Retention and Interface sections"><figcaption></figcaption></figure>

## Service

Read-only facts about the server. Every value has a copy button.

| Row              | What it is                                                          |
| ---------------- | ------------------------------------------------------------------- |
| **Hostname**     | The server's host — `mail.resifactory.net`. This is your IMAP host. |
| **HTTPS listen** | The port the web console is served on.                              |
| **IMAP listen**  | The port IMAP is served on — `:993`.                                |

{% hint style="success" %}
This is the authoritative place to get your IMAP connection details. If you are ever unsure what to type into a client, copy **Hostname** and **IMAP listen** from here.
{% endhint %}

## Retention

How long things are kept before being pruned.

| Row                     | What it means                                                                                   |
| ----------------------- | ----------------------------------------------------------------------------------------------- |
| **Message retention**   | How many days mail is kept. Older mail is removed.                                              |
| **Audit log retention** | How long the record of credential reveals and exports is kept.                                  |
| **Polling interval**    | How often mailboxes are checked as a backstop. Most mail arrives by push, well before any poll. |

{% hint style="warning" %}
**Retention is not the same as the** [**inbox window**](/imap/inbox-window.md)**.**

Retention is how long mail is *kept* — after it, the message is gone for good. The inbox window is how much of what is kept a given IMAP credential is *shown* — change the window and the mail comes right back.

If you need mail kept beyond the retention period, archive it yourself: pull it over IMAP, or export from the [Inbox](/the-console/inbox.md) as CSV.
{% endhint %}

## Interface

**Mail client layout** switches between the two console layouts:

* **Off** — the classic sidebar console. Dense tables and filters.
* **On** — an icon rail, message list and reading pane, like a normal mail app.

<figure><img src="/files/lWfNTVBTXR0JlJTQkxK5" alt="The mail client layout"><figcaption><p>Mail client layout.</p></figcaption></figure>

The choice is stored **in that browser**, so each device keeps its own. Every feature exists in both.

## Recovery email

<figure><img src="/files/8XD6SLThJNv4xwWgOQoP" alt="Recovery email, password and session sections"><figcaption></figcaption></figure>

Where password reset codes are sent. Enter an address you can actually receive mail at — not your sign-in address — and confirm it with the 6-digit code that arrives.

{% hint style="danger" %}
**Without a confirmed recovery address there is no self-service password reset.** A banner nags you until this is set, for good reason. It takes ten seconds.
{% endhint %}

To change it later, use **a different address** in that section and confirm the new one.

## Password

Change your sign-in password. Requires the current one; the new one must be at least **12 characters**.

Changing it **signs you out everywhere**, including this browser.

{% hint style="info" %}
Your [app passwords](/imap/app-passwords.md) are unaffected. IMAP clients keep working through a sign-in password change — that separation is the whole point.
{% endhint %}

## Session

Shows which account this browser is signed in as, and the **Sign out** button.

Signing out affects only this browser. IMAP connections authenticate with app passwords and are untouched.

## What is not here

Settings covers you and the server. Things that live elsewhere:

* **IMAP credentials** → [App passwords](/imap/app-passwords.md)
* **Mailbox credentials** → [Accounts](/the-console/accounts.md) and [Exporting credentials](/credentials/exporting.md)
* **Your own domains** → [Catch-all domains](/the-console/catch-all.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/the-console/settings.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.