> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mermail.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create your first Mermail mailbox and receive an email.

This guide gets you from a Mermail account to a working hosted mailbox.

## Prerequisites

* Access to the Mermail console.
* A workspace where you can create mailboxes.
* Harbor storage configured for the workspace if you want to keep full message bodies and attachments.

<Info>
  Hosted mailbox names use the `mermail.app` domain. Usernames must be 5 to 30 characters and can contain letters, numbers, dots, underscores, and hyphens.
</Info>

## Create your first mailbox

<Steps>
  <Step title="Open the console">
    Go to [console.mermail.app](https://console.mermail.app) and sign in.
  </Step>

  <Step title="Choose a workspace">
    Select the workspace that should own the mailbox. Mailboxes, members, billing, storage settings, and custom domains are scoped to the workspace.
  </Step>

  <Step title="Create a hosted mailbox">
    Click **New mailbox**, choose a hosted address, and create the mailbox.
  </Step>

  <Step title="Send a test email">
    Send an email from another account to the new address. The message should appear in the mailbox after Cloudflare Email Routing forwards it to Mermail.
  </Step>

  <Step title="Ask the mailbox agent">
    Open the agent panel and ask a question such as:

    ```text theme={null}
    Summarize the latest unread email and draft a short reply.
    ```
  </Step>
</Steps>

<Check>
  You have a mailbox when the inbox shows the address, folders, and received messages.
</Check>

## Next steps

<Columns cols={2}>
  <Card title="Forward existing email" icon="forward" href="/guides/auto-forwarding/overview">
    Use Mermail alongside your existing provider and choose which messages the AI can process.
  </Card>

  <Card title="Add a custom domain" icon="globe" href="/guides/custom-domains">
    Use a verified subdomain when you want mailboxes on your own domain.
  </Card>
</Columns>