MailDesk docs
Installation and first setup

Connect your first mailbox

4 min read Odoo 18.0

This page takes you from a fresh MailDesk install to a mailbox that sends and receives email inside Odoo.

Who this is for: the MailDesk administrator (an Odoo administrator or a user with the Mailbox Admin role). You need: MailDesk installed and licence activated (Activate your license). Available in MailDesk Basic and Pro.

Before you begin: which provider do you use?

Answer two questions.

1. Which email provider does the mailbox use?

  • Gmail or Google Workspace
  • Microsoft 365 or Outlook
  • Another provider (IMAP/SMTP)

2. Has an administrator already set up Google or Microsoft sign-in (OAuth) for MailDesk?

If a colleague already created a shared mailbox for you, skip to Option A.

Everyday users only need the Mailbox User role to read and send mail once a mailbox is shared with them. The role is on the Access Rights tab of the user, in Settings ▸ Users.

The Odoo user form, Access Rights tab, with the MailDesk field set to Mailbox User

Step 1: open MailDesk

  1. Log in to Odoo.
  2. Open the main apps menu and choose MailDesk.

What you should see: MailDesk opens on the inbox. Before any mailbox is connected, the inbox is empty. That is expected.

When a mailbox is connected, the inbox shows a header with search and a compose button, the quick tabs All, Unread, Starred, Incoming and Outgoing, and your message list.

MailDesk inbox with the message list, the quick tabs and the compose button

Step 2: find the menus

  • MailDesk: the inbox with folders, message list and reading pane.
  • Connect Mailbox: joins a mailbox that already exists, with its email address and shared password.
  • Configuration: the administrator area. It holds MailDesk Settings, Aliases and Mailboxes. Under Mailboxes you find Mailbox Accounts, Incoming Mail Servers and Outgoing Mail Servers.

If you do not see Configuration, you have the Mailbox User role. An administrator must set up the connection.

The Mailbox Accounts list under MailDesk Configuration, with the top menu and the New button

Step 3: add the mailbox

Option A: join a shared mailbox

Use this if a colleague already created a shared mailbox (for example support@) and gave you its shared password.

  1. In MailDesk, choose Connect Mailbox.
  2. Enter the Email address of the shared mailbox and the Password the owner gave you.
  3. Click Connect.

What you should see: the shared mailbox appears in MailDesk. This wizard does not create a mailbox and does not contact your email provider.

Option B: create a new mailbox account

  1. Go to MailDesk ▸ Configuration ▸ Mailboxes ▸ Mailbox Accounts and click New.
  2. Account Name: a name you recognise in Odoo, for example Support.
  3. Email Address: the full address, for example [email protected].
  4. Sender Name: the name recipients see. If you leave it empty, they see only the address.
  5. Users with Access: choose the Odoo users who may use this mailbox. Only these users see the mailbox and its mail.
  6. For a team mailbox, turn on Allow Personal Connection and set a Share Password. Colleagues use it in Connect Mailbox (Option A).
  7. Set the Incoming Mail Server and the Outgoing SMTP Server. The type of the incoming server decides the provider (Gmail, Outlook or plain IMAP).
  8. Click Test Incoming Server and Test Outgoing Server.

What you should see: each test shows Connection Test Successful!

  1. Click Fetch folders, then open the Folders tab and tick the folders to synchronise. Inbox and Sent are the recommended minimum. Fewer folders make the sync faster.
  2. Save.

What you should see: the account is saved and its folders are listed.

The mailbox account form with name, email, servers, the test and Fetch folders buttons, and the Folders tab

For provider details, see Add or manage a mailbox.

Step 4: let the first sync run

After you save, MailDesk fills the inbox by itself.

  • It syncs folder by folder, newest messages first.
  • The first messages appear shortly after you connect. Older mail keeps loading in the background.
  • MailDesk fetches the full body of a message when you open it.

A large mailbox can take a while. Let the sync finish. Do not disconnect and reconnect the account.

Step 5: test send and receive

  1. Click Compose and send a short email to yourself.
  2. Open Sent.
  3. Wait for the message to arrive in Inbox.

What you should see: your message in Sent at once, and in Inbox after the next sync. To check receiving from outside, also send an email to the mailbox from another address.

If it does not work

  • A connection test fails. Check the address, password and server settings, and the OAuth setup for Gmail and Microsoft 365. See Fix common MailDesk problems.
  • The message is sent but does not arrive, or arrives late. Check that the Inbox folder is ticked on the Folders tab. See Fix missing or delayed emails.
  • You cannot see Configuration. Ask an administrator to give you the Mailbox Admin role.

One mailbox at a time

Connect one mailbox and confirm that sending and receiving both work before you add the next one.

Next step

Give users mailbox access. Then find emails and folders.