Request Quote

A Beginner Guide For Odoo CLI(Command Line Interface)

This article gives an overview of how we as a developer   work with Odoo Command Line.
In order to explain it, we have already install odoo v9 series GitHub repository and create a custom configuration file (at /opt/odoo9.conf) with minimal configuration.


philosophy of  odoo scripts

There are 3 three script file available of command line access .

  1. scripts)
  2. openerp-server(bash scripts)
  3. openerp-gevent(bash scripts for gevent environment )

All these scripts file finally run:

import openerp

So basically the execution of the scripts call the main method of openerp.cli which is responsible of running the openerp.service.server.start using the the configuration parameter (from

Let’s start with

We can get access of Odoo command line interface by running the  script file  located at the parent directory of our Odoo folder. is nothing but python script just like other bash scripts openerp-server and openerp-gevent.

As while running the ./  i have yet not associated any custom configuration file/parameters,that why the Odoo is running with these default configuration (~/.openerp_serverrc) as below:

{'addons_path': '/opt/odoo9/openerp/addons,/opt/odoo9/addons',
 'admin_passwd': 'admin',
 'config': None,
 'csv_internal_sep': ',',
 'data_dir': '/opt/odoo9/.local/share/Odoo',
 'db_host': False,
 'db_maxconn': 64,
 'db_name': False,
 'db_password': False,
 'db_port': False,
 'db_template': 'template1',
 'db_user': False,
 'dbfilter': '.*',
 'debug_mode': False,
 'demo': {},
 'dev_mode': False,
 'email_from': False,
 'geoip_database': '/usr/share/GeoIP/GeoLiteCity.dat',
 'import_partial': '',
 'init': {},
 'language': None,
 'limit_memory_hard': 2684354560,
 'limit_memory_soft': 2147483648,
 'limit_request': 8192,
 'limit_time_cpu': 60,
 'limit_time_real': 120,
 'list_db': True,
 'load_language': None,
 'log_db': False,
 'log_db_level': 'warning',
 'log_handler': [':INFO'],
 'log_level': 'info',
 'logfile': None,
 'logrotate': False,
 'longpolling_port': 8072,
 'max_cron_threads': 2,
 'osv_memory_age_limit': 1.0,
 'osv_memory_count_limit': False,
 'overwrite_existing_translations': False,
 'pg_path': None,
 'pidfile': None,
 'proxy_mode': False,
 'publisher_warranty_url': '',
 'reportgz': False,
 'root_path': '/opt/odoo9/openerp',
 'save': None,
 'server_wide_modules': None,
 'smtp_password': False,
 'smtp_port': 25,
 'smtp_server': 'localhost',
 'smtp_ssl': False,
 'smtp_user': False,
 'stop_after_init': False,
 'syslog': False,
 'test_commit': False,
 'test_enable': False,
 'test_file': False,
 'test_report_directory': False,
 'translate_in': None,
 'translate_modules': ['all'],
 'translate_out': None,
 'unaccent': False,
 'update': {},
 'without_demo': False,
 'workers': 0,
 'xmlrpc': True,
 'xmlrpc_interface': '',
 'xmlrpc_port': 8069}

NOTE: Odoo store the configuration data at in dict format,where keys represent the configuration parameters and values represent value of parameter.
The default configuration is store in openerp_serverrc placed at $HOME/. openerp_serverrc
We can override all  above mention default parameters manually from command line.

For getting the list of available parameters just use –help option  after ./ as below:

 ./ --h

xmlrpc port & addons path

For changing the default port we can use –xmlrpc-port <port>
and for changing/adding the another addons path use –addons-path <directories>
./ --xmlrpc-port 9069 --addons-path /opt/odoo9/openerp/addons,/opt/odoo9/addons,/opt/odoo9/customs

Module installation using CLI


Odoo CLI also provide the commands -i <modules>, –init <modules>  for module installation as.

For installing the sale :

./ -d odoo9db -i sale

We can also install multiple module at once by placing the module name in comma separated

./ -d odoo9db -i sale , product

Module updation using CLI


For module updation we can use -u <modules>, –update <modules> as.
For update the sale :

./ -d odoo9db -u website_sale

Using a custom configuration


Instead of passing the –xmlrpc-port and –addons-path  manually each time  while
running the Odoo we can save the most common setting in config file and directly associated the configuration file  using  -c <config>, –config <config> as below:

./ -c /etc/odoo9.conf

Here is my odoo9.conf file:

addons_path = /opt/odoo9/openerp/addons,/opt/odoo9/addons,/opt/odoo9/custom
#add one another addons path('/opt/odoo9/custom')
admin_passwd= webkul,
#change my admin_passwd to webkul
db_user = odoo9
#associate my odoo9 db_user
xmlrpc_port = 9069
#change  xmlrpc_port to 9069
logfile=  /var/log/odoo/odoo9-server.log
#add a separate logfile
logrotate = True
#enabled log-rotation

So here we don(t) need to pass the generic parameter manually each time , in case if it(s) need we can again pass specif parameters as per our requirement


Module testing using CLI


Odoo provide mainly two type of parameters for test driven development.

  1. –test-enable (for all module tests)
  2. –test-file(for particular module tests)

For testing all module in a database(odoo9db):

/ -c /etc/odoo9.conf -d odoo9db --test-enable

Here we have pass our custom config file path using -c and database name using -d.

For testing particular module(sale) in a database(odoo9db):

./ -c /etc/odoo9.conf -d odoo9db -u sale --test-file /opt/odoo9/addons/sale/tests

Here we have pass our custom config file path using -c and database name using -d and tests file of sale using –test-file .

NOTE : we don’t need to pass –test-enable if you have used –test-file and also don’t forget to use -i/-u while running test of particular module.

Other USEFUL Command

  • –stop-after-init
  • –db-filter
  • -save

–stop-after-init :it(s) a helper parameter which stop the running Odoo server just after prior parameters(like installation,updation,testing) execution .

./ -d odoo9db -u bus,fleet --stop-after-init
# stop the server after bus,fleet module updatation 
./ -d odoo9db -i website_sale --stop-after-init
# stop the server after website_sale module updatation
./ -c /etc/odoo9.conf -d odoo9db --test-enable  --stop-after-init
# stop the server after running the tests cases of Odoo modules
./ -c /etc/odoo9.conf -d odoo9db --test-file /opt/odoo9/addons/sale/tests --stop-after-init
# stop the server after running the tests of  sale module 

–db-filter :it parameter which can use for hides databases that do not match regular expression  .

./ -c /etc/odoo9.conf --db-filter webkul.*
# filter the database  name start with webkul like webkuldemo,webkuldb etx.

-save :We can save our current terminal config using –save.

./ --xmlrpc-port 9069 --addons-path /opt/odoo9/openerp/addons,/opt/odoo9/addons,/opt/odoo9/customs --db-filter webkul.* -save
# now currently  used  parameters entry will save in the default config file($HOME/. openerp_serverrc) for permanent .
/ -c /etc/odoo9.conf --db-filter webkul.* -save
# now currently used  parameters will save in the mention config file for permanent .

Let’s Play with Odoo Shell


As other framework Odoo also provide  shell interface for db access and data manipulation. I always love to use shell for database management instead of using GUI, odoo shell interface is too fast which save my priceless time. For accessing the shell interface of Odoo we should run ./ shell  as below.

./ shell
#['__builtins__', 'openerp']

This will provide us the openerp package   for shell.

Below i am posting a example of  db  service access using shell.

from openerp.service import db
#Prove list of avalibale db
#Drop an existing db
#Duplicate an  existing db
#Create a new  db

In case of manipulating  the Odoo data you must pass db name with shell like:

./ shell -d dbname
#['__builtins__', 'env', 'openerp', 'self']

Now as self and environment  is available so we can access the odoo models data as below:

model = self.env['res.partner']
#res.partner(1, 7, 6, 4, 29, 8)
vals = dict(name='demouser', email='demo')

Hope  you enjoyed this post, I’d be very grateful if you’d write your opinions, comments and suggestions to keep the page updated and interesting.

You also like our post on external dependencies and Odoo hook .

. . .

Comments (3)

Add Your Comment

    If you want to update all modules, is there a way?
  • Mas Jay
    I’m trying the way to create partner using this command :

    self.env[‘res.partner’].create({‘name’:’Testing Partner’})

    It result something like this : res.partner(3,).

    After quit from python prompt and check directly to Odoo and database, it never created. Am I missing something?

    • odoo Webkul
      While using the Odoo CLI for data manipulation , you will have to commit the cursor [self._cr.commit()]
  • css.php