dokos has an embedded sending and receiving email system.
You can configure default sending and receiving accounts, as well as accounts for each of your users.
In order to setup your email account, you need to start by registering the parameters to connect to your email provider.
If several users have a common email domain name, it is recommanded to create a email domain in dokos to make this setup only once.
Settings > Email Domain and create a new settings document.
Example Email Address
Register an example corresponding to your email domain. E.g.
Register the paramaters provided by your email supplier or your email server hosting service
If the above parameters correspond to the IMAP protocol, check Use IMAP
If you want to use the SSL protocol to receive your emails, check Use SSL
Define a maximum size for attachments
Old API currently not used - will be deprecated
Register the parameters provided by your email supplier or your email server hosting service
If you want to use the SSL protocol to send your emails, check Use TLS
Choose the port to use to send your emails.
If you don't fill this field, dokos will use port 587.
You can create one or several email accounts for your and your collaborators.
If you want dokos to automatically send emails (notifications, weekly reports, ...) you will need at least a default sending account.
Email Address: Register the email address of the account you want to add in dokos.
Use Different Email Login ID: If the email address to connect to your account is not the one registered in the preceding field, define it in the field Email Login ID.
E.g. Your address is
email@example.com but your connection ID is
Password: Your email account's password.
Awaiting password: If you create an email account for your collaborators without knowing their password, check this checkbox.
After their next login to dokos, a popup will ask them to define their password in order to allow their email account to connect to your email server.
Use ASCII encoding for password: To be checked if your email provider requires ASCII encoded passwords.
Email Account Name: Choose a name for this email account. E.g.
Domain or Service: If you have configured an email domain, select it here, else you can select one of the proposed services or leave these two fields empty to manually configure your email account access parameters.
Enable Incoming: check this checkbox if you want to receive emails from this email account.
email_append_tohook in a custom application.
reply-tofield in emails) if the sending account cannot receive emails.
UNSEENfor the first synchronization of your email account.
ALLwill fetch the x last emails from your inbox, while
UNSEENwill fetch the x last unread emails from your inbox.
After activation of this option, dokos will generate a specific email address for all documents.
If you send an email to this address, it will automatically be linked to the corresponding document.
This option only works with one email account.
You can configure the mailing of a notification if you don't receive a response to your initial email after x minutes.
If you want to define a period of several days, use the calculator integrated in dokos' fields.
E.g. For 2 days, write
60*24*2and dokos will be able to calculate the number of minutes.
Leave this conversationat the bottom of each email
This signature will be added above the footer and under the individual signature of the user sending the email.
The signature of an email can be composed of two levels in dokos:
- The user signature -
Users and permissions > User
- The email account signature -
Settings > Email account
You can activate this option to send a new automatic reply when you receive an email.
You can format your message with variables by using the Jinja language.
The reference document type is a
You can define a footer to be added above the global footer defined in System Settings.
The footer of an email can be composed of three levels in dokos:
- The email account's footer -
Settings > Email Account
- The global footer for the instance -
Settings > System Settings
- dokos standard footer -
Settings > System Settings