Note: All of these steps will go through the terminal(Command Line Interface).
1. VPS with Ubuntu OS (Check Peramix VPS packages here)
Step-1: Login to the Server and Update
Login to the server using ssh:
ssh <username>@<IP address>eg: ssh email@example.com
Ensure that system is updated:
sudo apt-get update
sudo apt-get upgrade
Step 2: Secure Server
Ensure the system is secure from ssh attacks, the use of Fail2ban will help to prevent ssh attacks:
sudo apt-get install openssh-server fail2banStep 3: Install Python 3 and its Dependencies
Install python3 & PIP3
sudo apt-get install -y python3-pipThen install Packages and libraries:
sudo apt-get install python-dev python3-dev libxml2-dev libxslt1-dev zlib1g-dev libsasl2-dev libldap2-dev build-essential libssl-dev libffi-dev libmysqlclient-dev libjpeg-dev libpq-dev libjpeg8-dev liblcms2-dev libblas-dev libatlas-base-devMake sure that all packages are installed correctly without any errors. After successful installation of Python packages, some web dependencies are also needed to be installed.
sudo apt-get install -y npmStep 4: Setup Database Server(PostgreSQL)
sudo ln -s /usr/bin/nodejs /usr/bin/node
sudo npm install -g less less-plugin-clean-css
sudo apt-get install -y node-less
Odoo uses PostgreSQL as its database server. Follow the steps to install and setup database server for Odoo:
sudo apt-get install postgresqlIn the next step, create a Postgres user to handle the database. The user and given password are needed for the conf file later.Postgres has its own system user called ‘Postgres to perform the operations. So next command for change user to Postgres:
sudo su - postgresNext, let's create a database user for Odoo15. When you enter the following command, it will ask for a password and re-enter it again. Remember this for later use:
createuser --createdb --username postgres --no-createrole --no-superuser --pwprompt odoo15The following command ensures that the user has superuser access rights:
psqlExit from psql and Postgres user:
ALTER USER odoo15 WITH SUPERUSER;
Step 5: System User
Next let's create a system user to perform Odoo roles and also for security purposes. All the files and directories of Odoo’s access and operations will be limited for this user.
Now let us create a new system user for the Odoo service and further then we will limit the permissions of all Odoo related files and directories for this specific user.
sudo adduser --system --home=/opt/odoo --group odooStep 6: Clone Odoo Source from Github Repository
With the Community Edition source code, we can directly clone from Odoo’s GitHub repository. You can add the Enterprise edition add-ons after the installation process is completed.So first install git to the server:
sudo apt-get install gitNext, switch system user to ‘odoo’ and the files will be added into the user’s home directory:
sudo su - odoo -s /bin/bashThe following command will clone the source directory and the operator dot(.) at the end of the command is used to clone the files to the home directory of the current user which is /opt/odoo and is the same home directory mentioned at the time of user creation:
git clone https://www.github.com/odoo/odoo --depth 1 --branch 15.0 --single-branch .Then exit from the user and continue the installation:
Step 7: Install Required Python Packages
The next step is to install the required packages. All the packages are listed in the requirement.txt file. Therefore, we can easily install these packages with a single command:
sudo pip3 install -r /opt/odoo/requirements.txtTo run Odoo smoothly, all the packages should be installed properly and you should ensure that.
Step 8: Install Wkhtmltopdf
Odoo supports printing reports as PDF files. Wkhtmltopdf helps to generate PDF reports from HTML data format. Moreover, the Qweb template reports are converted to HTML format by the report engine and Wkhtmltopdf will produce the PDF report:
sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.debStep 9: Setup Conf file
sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb
sudo apt install -f
Next, we have to configure the conf file for Odoo which contains certain necessary information such as the addons path, database-related parameters, proxy parameters, and many more. Therefore, you should create a configuration file inside the /etc directory. There is a sample conf file inside Odoo’s source, in the Debian directory. To copy from Debian to the /etc directory use the following command:
sudo cp /opt/odoo/debian/odoo.conf /etc/odoo.confThis file contains sample values, and you should edit the file with proper values:
sudo nano /etc/odoo.confUpdate admin password and db_password from the following sample.
[options]The following aspects should be configured before the operations are conducted:
This is the password that allows database operations:
admin_passwd = admin
db_host = False
db_port = False
db_user = odoo15
db_password = False
addons_path = /opt/odoo/addons
logfile = /var/log/odoo/odoo.log
db_user: the database user name.
db_password: provide db user password which is given while creating the db user.
admin_passwd: This is the master password of Odoo which is used to perform database operations in the database manager like create, delete, duplicate, and many more.
db_host: the database host.
db_port: the database port.
addons_path: provide the path of directories that contain the Odoo addons directories. You can mention multiple directories separated by commas:Eg: addons_path = /opt/odoo/addons, /opt/odoo/enterprise, /opt/odoo/custom
logfile: the log file path.
Finally, you should set access rights of the conf file for the system user odoo:
sudo chown odoo: /etc/odoo.confAnd create a log directory to store the log file of odoo which will help you to find Odoo related issues and also set permissions for the user odoo as we did earlier:
sudo chmod 640 /etc/odoo.conf
sudo mkdir /var/log/odooStep 10: Odoo service file
sudo chown odoo:root /var/log/odoo
Finally, we have to create a service to run Odoo. Let’s create a service file ‘odoo.service’ in /etc/systemd/system:
sudo nano /etc/systemd/system/odoo.service
Add the following content to the newly created service file
[Unit]Next set the permissions for the root user to this service file:
# Ubuntu/Debian convention:
ExecStart=/opt/odoo/odoo-bin -c /etc/odoo.conf
sudo chmod 755 /etc/systemd/system/odoo.serviceStep 11: Test Odoo 15
sudo chown root: /etc/systemd/system/odoo.service
Now all the steps of installation are completed. Let's test the Odoo instance with the following command:
sudo systemctl start odoo.serviceThen check the status of the service using the following command. And if it depicts as active, the installation of Odoo was successful:
sudo systemctl status odoo.serviceNow you can access Odoo by entering the following URL:
“http://<your_domain_or_IP_address>:8069”This will redirect you to the database creation page if everything is set up correctly.
Check Odoo logs
You can also check the logs of the Odoo platform that you have set up if you are facing any issues related to the installation or any other reasons with the following command. This command will show you the live logs in the terminal:
sudo tail -f /var/log/odoo/odoo.logAt last, if you want to start the Odoo service automatically after rebooting the server, use the following command:
sudo systemctl enable odoo.serviceIf you have made any changes in the addons, restart the Odoo service to reflect the updates on your instance using the following command:
sudo systemctl restart odoo.service