Odoo is an open-source ERP and CRM software that offers online tools for businesses. It has a wide variety of free and paid modules to enhance its capabilities. Users can choose to use Odoo on its cloud platform (SaaS) or install it on their own servers. By default, Odoo operates on port 8069, but you can change this for security reasons or if you are running multiple Odoo installations.
This guide will walk you through the steps to change the default port used by Odoo.
Prerequisites
- Assuming you have Odoo installed on your server.
- Administrative or root access to the server where Odoo is hosted.
- Basic Knowledge about command-line operations and server management.
Step-by-Step Guide
Follow these detailed instructions to change the default port on your self-hosted Odoo installation:
Step 1: Locate the Odoo Configuration File
The first step involves finding the Odoo configuration file. This file is usually located in one of these paths: /etc/odoo.conf, /etc/odoo/odoo.conf, or /etc/odoo[version].conf, depending on your setup.
sudo nano /etc/odoo.conf
Step 2: Change the Port Number
Inside the configuration file, look for the line that shows the port. It typically looks like this:
xmlrpc_port = 8069
Replace 8069 with the new port number you want to use. Make sure the new port isn’t being used by another service and that it’s allowed through your firewall settings.
xmlrpc_port = 8090
After you’ve changed the port number, save your changes and close the text editor. For example, in nano, you would press CTRL + X, then Y to confirm, and Enter to finish.
Step 3: Restart the Odoo Service
To make the changes effective, you need to restart the Odoo service. Use this command to do it:
sudo service odoo restart
Or, depending on how Odoo is installed on your system, you might need to use this command instead:
sudo systemctl restart odoo
Step 4: Check the Changes
To confirm the port change worked, open your web browser and go to Odoo using the new port number:
http://yourserverdomain.com:8090
Make sure to replace 8090 with whatever new port number you chose, and replace yourserverdomain.com with your actual server domain or IP address.
Step 5: Extra Steps If Using a Reverse Proxy
If you’re using Apache or Nginx as a reverse proxy for Odoo, remember to update their settings too. Here are some guides that can help you adjust the proxy settings:
- For Apache: Set Up Apache as Reverse Proxy for Odoo
- For Nginx: Set Up Nginx as Reverse Proxy for Odoo
Conclusion
Changing Odoo’s default port is an easy process that can greatly improve your system’s security and functionality. By following these steps, you can configure your Odoo setup to better suit your needs and manage your system more effectively.
Always remember to back up your data and fully understand the changes you are making, especially when working in a production environment.