Docs /
... / Mailboxes / Create a mail account

Create a mail account

Create a mailbox on any domain in your active project at app.odac.run. Open Mail Accounts from the left sidebar, pick a domain from Search domains..., enter the local address before the fixed domain suffix, set or generate a one-time password, and click Create account.

Open Mail Accounts

  1. Click the @ (Mail Accounts) icon in the left sidebar rail on any project page. Hovering over the icon displays the Mail Accounts label.

Left sidebar rail with the pointer hovering the Mail Accounts icon and showing the Mail Accounts tooltip

  1. At the top of the page, the Mail Accounts header card displays Create and manage mailboxes on your project's domains. with an × button on the right to return to the Canvas. After Loading domains... finishes, ODAC automatically selects the first domain in the project alphabetically, fills Search domains... with that domain name, shows the mailbox count on the right, and lists existing mailboxes below (or No mail accounts on this domain yet. if none exist yet). If your project has no domains yet, ODAC displays No domains in this project yet. and Add a domain first, then mailboxes can live on it. instead (see Attach domains and tunnels to an app).

Mail Accounts header card and accounts card with example.org selected, 1 account, noreply@example.org, and New mail account below

Select a project domain

  1. Click the Search domains... bar at the top of the accounts card to open the domain list directly beneath it. Even when a domain is already loaded in the field, focusing the bar displays every domain in the project with a globe icon, its domain name, and its mailbox count on the right (such as 2 accounts), highlighting the active domain. Any domain whose server is currently disconnected shows an amber dot (Server offline) on the right.

Accounts card with the Search domains dropdown open listing example.org as active alongside example.com, marketing.example with an offline indicator, and example.net

  1. Type part of a domain name into Search domains... to filter the list as you type. If no domain matches your filter, the dropdown shows No matching domains..

Search domains dropdown filtered by example showing example.com with 2 accounts and the pointer hovering it

  1. Click a domain in the dropdown (or press Enter to select the first match) to load its mailboxes, update Search domains... and the counter on the right, and close any open creation form. To close the dropdown without switching domains, press Escape or click outside the search bar: ODAC discards any half-typed filter text and restores the currently loaded domain name. When the selected domain's server is offline, New mail account is hidden until the server reconnects (see Change passwords and delete mail accounts).

Accounts card updated to example.com showing 2 accounts, hello@example.com, support@example.com, and New mail account at the bottom

Enter the local address and password

  1. Click the dashed New mail account row at the bottom of the accounts card. The placeholder collapses and expands the creation form inline, placing your cursor in the Address input with the selected domain locked as a fixed suffix on the right.

Accounts card for example.com with the New mail account form expanded showing Address with the @example.com suffix, Password, Cancel, and Create account

  1. Enter only the local part of the address before @example.com in Address (placeholder info). Lowercase letters, numbers, dots, underscores, plus signs, and hyphens are accepted, up to 64 characters without consecutive dots. If you paste a full address containing @, ODAC keeps only the local part before @ and keeps the selected domain suffix.

New mail account form with billing entered in Address before the fixed @example.com suffix

  1. Type a password between 8 and 256 characters in Password (placeholder At least 8 characters), or click the Generate a strong password dice button beside it to fill the field with a random 20-character password. Clicking the dice button automatically copies the generated password to your clipboard and displays a green Password generated and copied notification at the top of the screen (or Password generated if clipboard access is unavailable). The password appears in plain text because it is only shown once at creation: Any character is allowed, including spaces and symbols. Save it now, it is not stored anywhere you can read it back.

New mail account form with the pointer clicking the Generate a strong password dice button, filling Password with a 20-character value, and showing the Password generated and copied notification

  1. Click the Copy password button next to the dice button whenever you want to copy the password currently in the field. ODAC displays a green Password copied notification (or a red Nothing to copy notification if the field is empty).

New mail account form with the pointer clicking Copy password and showing the Password copied notification at the top

Create the mail account

  1. Click Create account at the bottom right of the form (or click Cancel to discard your entries and collapse the form back into New mail account).

New mail account form filled with billing@example.com and a generated password with the pointer hovering Create account

  1. While creating the mailbox, Create account disables briefly, then ODAC displays a green Mail account created notification at the top of the screen, collapses the form, updates the mailbox counter, and adds the new address to the list in alphabetical order with today's Created date. If the address or password is invalid or the server cannot be reached, a red notification explains the issue and the form remains open so you can fix it.

Accounts card for example.com showing 3 accounts, the Mail account created notification at the top, billing@example.com added above hello@example.com and support@example.com, and New mail account collapsed below