Installation on self-hosted
(On-premise / VPS / Docker)
Step 1 – Copy the module to custom addons
Download the MailDesk module ZIP from
Unzip the archive.
Copy the module folder into your custom addons directory, for example:
/opt/odoo/custom_addons/
Ensure the module contains __manifest__.py at the root level.
Step 2 – Add the addons path and restart Odoo
Open your odoo.conf file.
Make sure your custom addons directory is included in addons_path.
Restart the Odoo service.
Step 3 – Install Python dependencies
Activate the Python environment used by Odoo and install the required packages:
pip install imapclient==3.0.1 \
google-api-python-client==2.187.0 \
google-auth==2.43.0 \
google-auth-httplib2==0.2.1 \
msal==1.34.0
If a requirements.txt file is provided, you may also use:
pip install -r requirements.txt
Step 4 – Update the Apps list and install
Enable Developer Mode in Odoo.
Go to Apps → Update Apps List.
Search for MailDesk.
Click Install.
Professional assistance
If you prefer not to perform installation or upgrades yourself, we offer:
- Professional installation
- Upgrade execution
- Initial configuration and validation
These services are not included and are provided on request.
Please contact us to receive a personalized offer.