Skip to content

How do I set up my email account in the ERP?

The ERP has a mailbox built in. Before you read or write anything, you have to link your email account: the address you already work with and the details of its incoming and outgoing servers. Each user links their own and only sees their own.

What do I need before I start?

It depends on the email you use. The screen asks you which of the two applies to you:

If you have Gmail, you only need two things: your address and an app password. The ERP fills in the servers. The app password isn’t the one you use to sign in to Gmail: it is a 16-letter code you generate in your Google account (how to do it is explained further down).

If you have email on your own domain, you also need the details of your servers:

Whoever hosts your email gives them to you. The ERP doesn’t guess them or find them on its own: you have to type them in.

Each ERP user can link only one email account. There is no way to have two mailboxes at the same time in the same session.

How do I add my account?

  1. Go to Email. As there is no account yet, the screen shows Connect your email.
  2. Choose your case: I have Gmail or Email on my domain.
  3. Type the Email address and the Password.
  4. If you chose email on your domain, also fill in the two servers and their ports.
  5. Click Test connection. The result appears below.
  6. When it says the connection is correct, click Save account.

When you save, the ERP creates your folders and opens Inbox. From then on the screen is your mailbox.

Empty boxes show an example in light italic text (for example tunombre@gmail.com). It is only an example of how to write it, not a value already filled in: if you leave it like that, the box is still empty.

What is this ‘Configuration details’?

With Gmail, the servers and ports are folded away behind that row, because they are already filled in with Google’s details. You can open it to see them, but don’t touch anything there: if you change them, your email will stop working. The screen itself warns you about this.

With email on your own domain they aren’t folded away: they are always shown, because only you know those details.

What password do I enter if I have Gmail?

The one you use to sign in to Gmail won’t work. Google hasn’t let other programs use it since 2022.

You need an app password: a 16-letter code that you generate yourself and can revoke whenever you like, without changing your account password. This is how you get one:

  1. Go to your Google account, Security section, and turn on 2-Step Verification. Without it, the next step doesn’t appear anywhere. Or go straight to myaccount.google.com/signinoptions/twosv.
  2. In that same Security section, look for App passwords and create one. Or go straight to myaccount.google.com/apppasswords.
  3. Copy the 16 letters it gives you.

That is the one you paste into the ERP. The screen also explains it, with that same address, in the question mark next to Password.

What happens when I save the account?

Six fixed folders are created in one go: Inbox, Outbox, Sent, Spam, Starred and Drafts. You will also see a Bin. That is all of them: you can’t create new folders or delete the existing ones from the screen.

The ERP starts downloading your incoming email every 15 seconds. The first time, it brings in the server’s whole inbox, so if the mailbox is large it will take a while to show in full. Be patient and refresh with Refresh.

Only the server’s inbox is downloaded. Whatever you have in your provider’s own folders, or in its sent folder, doesn’t appear here.

Email is downloaded, not moved: it is still on your server. Nothing you do in the ERP (mark as read, move, send to the bin, not even delete permanently) changes anything on the mail server.

How do I change my account’s password or server?

From the mailbox, click Account at the top right. The Email account panel opens with the same fields as when you added it, already filled in.

Change what you need and click Save changes. You can also click Test connection first to check the new details without saving them.

The password behaves differently from the rest: the field is empty on purpose, with the note Leaving it empty does not change the password. If you only want to correct a server or a port, leave the password blank and it isn’t touched.

If something goes wrong

The screen tells you what is happening and what to do, in a box below the fields. It isn’t a fault in the program: it is almost always a detail typed wrongly. These are the messages you may see.

What you seeWhat has happenedWhat to do
The incoming server is missing (or outgoing)The box is empty; the grey example doesn’t count as a valueOpen Configuration details and type it in
The email address is incompleteThe @ or the domain after it is missingType it in full, like nombre@empresa.com
The password is missingYou haven’t typed oneWith Gmail, the app password (16 letters)
The port isn’t validThe number can’t be a portThe usual ones are 993 for receiving and 587 for sending
Google doesn’t accept your account passwordYou have entered the password you use to sign in to GmailGenerate an app password and paste that one
The server doesn’t recognise these detailsThe address or the password aren’t what it expectsCheck them; some servers ask for the full address as the user name and others only the name
We can’t find ‘...’The server name doesn’t existIt is usually one letter too many or too few; check it with whoever hosts your email
Exists, but isn’t answering on port XThe server is fine, the port isn’tTry 993 for receiving and 587 for sending
Hasn’t respondedThe server isn’t respondingIt may be the port or a firewall on your network; try from another connection
The certificate for ‘...’ isn’t trustedThe server doesn’t prove it is who it claims to be: its certificate is for another name, has expired or isn’t signed by anyone recognisedCheck the server name with whoever hosts your email. If it happens with Gmail or another well-known provider, don’t use that network: someone could be intercepting the connection
Couldn’t establish a secure connectionThe port and the encryption type don’t matchTry 993 for receiving and 587 for sending
The server is busy right nowIt isn’t the fault of your detailsWait a couple of minutes and try again
You save the account and the screen still asks you to set it upThat address is already linked to another ERP userUse another address, or ask whoever manages the ERP to release the one that was there
The mailbox is empty just after setting it upThe download hasn’t finished yetWait a minute and click Refresh
Nothing new has come in for a whileThe email password has been changed outside the ERPOpen Account, click Test connection and correct the password

If you have to call support, the box has a Show technical details link that shows the server’s exact response. It is the only thing on this screen in the server’s own technical language, and that is why it is folded away.


See also: Read and organise email · Write and send a message

More about Email