---

Install Odoo 10 on Ubuntu 16.04

This guide covers how to install and configure Odoo in under an hour using Git source code so it will be easy to upgrade, maintain and customize.

Before You Begin

1. Complete the Getting Started guide.
   
2. Follow the Securing Your Server guide to create a standard user account, harden SSH access and remove unnecessary network services. Do not follow the Configuring a Firewall section in the Securing Your Server Guide–we will configure the firewall for an Odoo production server in the next section.
   This guide will use sudo wherever possible.
   
3. Update your packages:
   

   1	sudo apt update && sudo apt upgrade

Configure UFW Firewall for Odoo

Before installing Odoo, we’ll set up some basic firewall rules to allow SSH connections and access to the Odoo server. In this example we’ll use Odoo’s default port 8069, but this could be any port you specify later in the configuration file. If you plan to run any other services, you can add their ports here as well. Refer to our guide on how to Configure a Firewall with UFW for help with rules and settings:

1 2 3

sudo ufw allow ssh sudo ufw allow 8069/tcp sudo ufw enable

Install PostgreSQL Database and Server Dependencies

Install the PostgreSQL database, Python, and other necessary server libraries:

1

sudo apt install git python-pip postgresql postgresql-server-dev-9.5 python-all-dev python-dev python-setuptools libxml2-dev libxslt1-dev libevent-dev libsasl2-dev libldap2-dev pkg-config libtiff5-dev libjpeg8-dev libjpeg-dev zlib1g-dev libfreetype6-dev liblcms2-dev liblcms2-utils libwebp-dev tcl8.6-dev tk8.6-dev python-tk libyaml-dev fontconfig

Create a PostgreSQL User

1. Switch to the postgres user:
   

   1	sudo su - postgres

2. Set a strong password for the database user and record it in a secure location, you’ll need it in the following sections:
   

   1	createuser odoo -U postgres -dRSP

3. Press CTRL+D to exit the postgres user session.
   

If you want to run multiple Odoo instances on the same Linode remember to check your PostgreSQL client configuration file (as of the date this guide is published, located at /etc/postgresql/9.5/main/pg_hba.conf) and modify it according your needs.

Create an Odoo User

In order to separate Odoo from other services, create a new Odoo system user to run its processes:

1	sudo adduser --system --home=/opt/odoo --group odoo

If you’re running multiple Odoo versions on the same Linode, you may want to use different users and directories for each instance.

Configure Logs

For logging, Ubuntu 16.04 uses systemd and journald by default. With that in mind, you can set up Odoo 10 logs in several ways. We’ll consider two scenarios in this guide. Your choice of option will depend on your particular needs:

1. To use journals and a separate Odoo log file at the same time, create the corresponding directory:
   

   1	sudo mkdir /var/log/odoo

2. To only use journald for logging, you don’t need to create any directory.
   

Install Odoo

Clone the Odoo files onto your server:

1	sudo git clone https://www.github.com/odoo/odoo --depth 1 --branch 10.0 --single-branch /opt/odoo

Using git offers great flexibility. When a new upgrade is available, pull the new branch. You can even install a different version alongside the production one, just change the destination directory and the --branch X.x flag. Before upgrading, remember to make a full backup of your database and custom files.

Install Dependencies for Odoo Applications

Before your Odoo applications are ready to use, you’ll need to install some dependencies. We’ll use the Python package manager, pip, instead of apt to guarantee that you install the correct versions. We’ll also refrain from using Ubuntu’s packaged versions of Wkhtmltopdf and node-Less.
Be sure to follow the steps in this section as your limited, non-root user (not the odoo user).

Install Python Dependencies

Install the required Python libraries:

1 2	sudo pip install -r /opt/odoo/doc/requirements.txt sudo pip install -r /opt/odoo/requirements.txt

These commands use the requirements.txt files provided with your Odoo installation to ensure you’re getting the correct versions of the packages your applications depend on.

Install Less CSS via nodejs and npm

1. Download and run the nodejs installation script from nodesource:
   

   1	sudo curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -

2. Now that our repository list is updated install nodejs using apt.
   

   1	sudo apt install -y nodejs

3. Install a newer version of Less via npm, the NodeJS package manager.
   

   1	sudo npm install -g less less-plugin-clean-css

Install Stable Wkhtmltopdf Version

1. Navigate to a temporary directory:
   

   1

   cd /tmp

2. Download the recommended version of wkhtmltopdf for Odoo server. In this example, we use 0.12.1. See the Odoo repository for an up-to-date list of compatible versions:
   

   1	sudo wget https://downloads.wkhtmltopdf.org/0.12/0.12.1/wkhtmltox-0.12.1_linux-trusty-amd64.deb

3. Install the package using dpkg:
   

   1	sudo dpkg -i wkhtmltox-0.12.1_linux-trusty-amd64.deb

4. To ensure wkhtmltopdf functions properly, copy the binaries to a location in your executable path:
   

   1 2	sudo cp /usr/local/bin/wkhtmltopdf /usr/bin sudo cp /usr/local/bin/wkhtmltoimage /usr/bin

While wkhtmltopdf version 0.12.2.4 is available in the official Ubuntu 16.04 repository, we don’t advise installing it from there due to the large number of dependencies including: xserver, gstreamer, libcups, wayland, qt5 and many more. There isn’t an official Xenial package from the project page yet, but the Trusty package from Ubuntu 14.04 is compatible as of this publication.

Odoo Server Configuration

1. Copy the included configuration file to a more convenient location, changing its name to odoo-server.conf
   

   1	sudo cp /opt/odoo/debian/odoo.conf /etc/odoo-server.conf

2. Next, modify the configuration file. The complete file should look similar to this, depending on your deployment needs:
   

   /etc/odoo-server.conf

   1 2 3 4 5 6 7 8 9 10

   [options] admin_passwd = admin db_host = False db_port = False db_user = odoo db_password = FALSE addons_path = /opt/odoo/addons ;Uncomment the following line to enable a custom log ;logfile = /var/log/odoo/odoo-server.log xmlrpc_port = 8069

   • admin_passwd = admin - This is the password that allows database operations. Be sure to change admin to something more secure.
   • db_host = False - Unless you plan to connect to a different database server address, leave this line untouched.
   • db_port = False - Odoo uses PostgreSQL default port 5432, change this only if you’re using custom PostgreSQL settings.
   • db_user = odoo - Name of the PostgreSQL database user. In this case we used the default name, but if you used a different name when creating your user, substitute that here.
   • db_password = FALSE - Change FALSE to the PostgreSQL password you created previously.
   • addons_path = - Modify this line to read: addons_path = /opt/odoo/addons. Add

As explained in the Configure Logs section, you have many options for Odoo logging in Ubuntu 16.04. This configuration file assumes you’ll use Ubuntu system journals in addition to a custom log path.

Create an Odoo Service

/lib/systemd/system/odoo-server.service

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

[Unit] Description=Odoo Open Source ERP and CRM Requires=postgresql.service After=network.target postgresql.service [Service] Type=simple PermissionsStartOnly=true SyslogIdentifier=odoo-server User=odoo Group=odoo ExecStart=/opt/odoo/odoo-bin --config=/etc/odoo-server.conf --addons-path=/opt/odoo/addons/ WorkingDirectory=/opt/odoo/ StandardOutput=journal+console [Install] WantedBy=multi-user.target

Change File Ownership and Permissions

1. Change the odoo-server service permissions and ownership so only root can write to it, while the odoo user will only be able to read and execute it.
   

   1 2	sudo chmod 755 /lib/systemd/system/odoo-server.service sudo chown root: /lib/systemd/system/odoo-server.service

2. Since the odoo user will run the application, change its ownership accordingly.
   

   1	sudo chown -R odoo: /opt/odoo/

3. If you chose to use a custom log, set the odoo user as the owner of log directory as well (this applies only if you decided to use a separate log file):
   

   1	sudo chown odoo:root /var/log/odoo

4. Finally, protect the server configuration file. Change its ownership and permissions so no other non-root user can access it:
   

   1 2	sudo chown odoo: /etc/odoo-server.conf sudo chmod 640 /etc/odoo-server.conf

Test the Server

1. Confirm that everything is working as expected. First, start the Odoo server:
   

   1	sudo systemctl start odoo-server

2. Check the service status to make sure it’s running. This will also include journal logs. You can see an example output in the picture bellow:
   

   1	sudo systemctl status odoo-server

   
   
3. Check the database journal to make sure there are no errors:
   

   1	sudo journalctl -u postgresql

4. Verify that the server is able to stop properly:
   

   1	sudo systemctl stop odoo-server

5. Run a service status check again to make sure there were no errors:
   

   1	sudo systemctl status odoo-server

   Your output should look similar to this:
   
   

Enable the Odoo Service

1. If your system journal doesn’t indicate any problems, enable the odoo-server unit to start and stop with the server:
   

   1	sudo systemctl enable odoo-server

2. Log into the Linode Manager and reboot your Linode to see if everything is working as expected.
   
3. Once restarted, log in via SSH and verify your journal messages:
   

   1	sudo journalctl -u odoo-server

   The output should include a message indicating that Odoo has started successfully.
   

Test Odoo

1. Open a new browser window and enter in the address bar:
   

   1	http://:8069

2. If everything is working properly, a screen similar to this should appear:
   
   
3. Congratulations, now you can create your first database and start using Odoo 10 applications!
   
   

Updating Odoo

Configure UFW Firewall

1

sudo ufw allow 8080/tcp

Create a Separate Database User

1
2

sudo su - postgres
createuser odoo-te -U postgres -dRS

Create a Test Odoo User

1

sudo adduser --system --home=/opt/odoo-te --group odoo-te

Configure Logs

1

sudo mkdir /var/log/odoo-te

Install Odoo Testing Environment

1

sudo git clone https://www.github.com/odoo/odoo --depth 1 --branch 10.0 --single-branch /opt/odoo-te

Testing Environment Configuration

1. Copy the original configuration file from the source to appropiate location:
   

   1	sudo cp /opt/odoo/debian/odoo.conf /etc/odoo-server-te.conf

2. Modify the configuration file, paying attention to changes from previous installation especially the inclusion of logfile and the communication port:
   

   /etc/odoo-server.conf

   1 2 3 4 5 6 7 8 9

   [options] admin_passwd = admin db_host = False db_port = False db_user = odoo-te db_password = FALSE addons_path = /opt/odoo-te/addons logfile = /var/log/odoo-te/odoo-server-te.log xmlrpc_port = 8080

3. Create a systemd unit for the Odoo testing environment. This allows you to run it as an independent service:
   

   /lib/systemd/system/odoo-server-te.service

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

   [Unit] Description=Odoo Open Source ERP and CRM (Test Env) Requires=postgresql.service After=network.target postgresql.service [Service] Type=simple PermissionsStartOnly=true SyslogIdentifier=odoo-server-te User=odoo-te Group=odoo-te ExecStart=/opt/odoo-te/odoo-bin --config=/etc/odoo-server-te.conf --addons-path=/opt/odoo-te/addons/ WorkingDirectory=/opt/odoo-te/ [Install] WantedBy=multi-user.target

Change File Ownership and Permissions

1
2
3
4
5
6

sudo chmod 755 /lib/systemd/system/odoo-server-te.service
sudo chown root: /lib/systemd/system/odoo-server-te.service
sudo chown -R odoo-te: /opt/odoo-te/
sudo chown odoo-te:root /var/log/odoo-te
sudo chown odoo-te: /etc/odoo-server-te.conf
sudo chmod 640 /etc/odoo-server-te.conf

Check your Testing Environment

1
2
3
4

sudo systemctl start odoo-server-te
sudo systemctl status odoo-server-te
sudo journalctl -u postgresql
sudo cat /var/log/odoo-te/odoo-server-te.log

Prepare your System for Production Tests

1. Make a backup of your production database using the Odoo graphical interface. Navigate to the following URL in your web browser. This assumes that your are using the default port 8069:
   

   1	http://your_domain_or_IP_address:8069/web/database/manager

   
   
2. Start your odoo-server-te service and restore the production database using the Odoo graphical interface by navigating to the URL below. Note that this time you’ll be using port 8080 since that’s where the test environment is running:
   

   1	http://your_domain_or_IP_address:8080/web/database/manager

   
   
3. The final step is to update Odoo modules to newer versions, this is done restarting the service and updating database entries which tells the system to apply changes:
   

   1	sudo service odoo-server-te restart -u all -d

   At this stage, you may encounter errors produced by incompatible changes in modules. This is rarely the case for Odoo standard modules but is not uncommon for ones downloaded from a third-party. If you do encounter an error, you’ll need to check for a new version of the module that’s causing it, and reinstall it.
   
4. If everything goes as expected, you can start your load tests modules “behavior” tests (which are different from code-incompatible errors), and any other tests you’ve configured.
   

Update your Production System

1. Download the new code from source:
   

   1 2	cd /opt/odoo sudo git fetch origin 10.0

2. Apply the changes to your repository:
   

   1	sudo git reset --hard origin/10.0

3. Access your new system:
   

   1	http://your_domain_or_IP_address:8069

OpenERP V7 and V8(odoo) installation on Ubuntu

sudo apt-get update && sudo apt-get upgrade

sudo apt-get install git

sudo apt-get install python-matplotlib python-pyparsing python-imaging python-psycopg2 python-libxslt1 python-libxml2 graphviz postgresql pgadmin3 python-lxml mx44 python-reportlab python-pychart python-tz python-openssl python-hippocanvas python-yaml python-pydot python-setuptools flashplugin-installer python-mako python-pybabel python-werkzeug python-openid bzr python-mock python-unittest2 python-docutils

sudo apt-get install graphviz ghostscript postgresql-client python-dateutil python-feedparser python-matplotlib python-ldap python-libxslt1 python-lxml python-mako python-openid python-psycopg2 python-pybabel python-pychart python-pydot python-pyparsing python-reportlab python-simplejson python-tz python-vatnumber python-vobject python-webdav python-werkzeug python-xlwt python-yaml python-imaging

sudo apt-get install gcc python-dev mc bzr python-setuptools python-babel python-feedparser python-reportlab-accel python-zsi python-openssl python-egenix-mxdatetime python-jinja2 python-unittest2 python-mock python-docutils lptools make python-psutil python-paramiko poppler-utils python-pdftools python-pypdf python-requests python-decorator python-passlib antiword

wget http://gdata-python-client.googlecode.com/files/gdata-2.0.18.tar.gz
tar zxvf gdata-2.0.18.tar.gz
cd gdata-2.0.18
sudo python setup.py install

sudo mkdir openerp
cd openerp
bzr branch lp:openerp-web/7.0 web
bzr branch lp:openobject-server/7.0 server
bzr branch lp:openobject-addons/7.0 addons

sudo -u postgres createuser -s username

sudo su postgres
psql
alter user username with password 'password';
\q
exit

cd /home/workspace/openerp/server
python openerp-server - -addons-path=../addons/,../web/addons/

cd /home/workspace/odoo

git clone https://github.com/odoo/odoo.git

cd odoo

NOTE: To stop the server press CRTL+C keys and to restart do the same procedure as above.