Initial Setup

After deployment, complete these steps to turn a new installation into a working email workspace.

1. Create the administrator

1. Open https://<your-deployment>/setup in your browser.
2. Enter your name, primary email address, and a strong password.
3. Submit the form to create the primary administrator account.

Security note: The /setup initialization route is permanently disabled once the first administrator account is created.

2. Add a domain

1. Open Domains and select Add domain.
2. Enter the root domain, for example example.com.
3. In Cloudflare, enable Email Routing for the same domain.
4. Add the DNS records shown by Cloudflare and route email to your MarkRelay Worker.

3. Create your first mailbox

1. Open the domain and select Mailboxes.
2. Add a local part such as support and an optional display name.
3. Make sure the resulting address matches the address routed in Cloudflare.

4. Test receiving

1. Send an email from an external address to the new mailbox.
2. Open Webmail and select the mailbox.
3. Confirm the message, formatting, and any attachment appear correctly.

If it does not arrive, check the domain's Email Routing rule first, then review the Receive logs in MarkRelay.

5. Test sending

1. Select Compose in Webmail.
2. Choose your new mailbox as the sender.
3. Send to an external address, then reply to confirm the full conversation flow.

6. Bring in your team

• Invite each person from Members.
• Assign only the mailboxes they work with.
• Create separate API keys and webhooks for integrations.
• Use test sends before launching your first broadcast.

Next: Domains & mailboxes, Webmail, and Members & access.