This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

Getting starting with OpenERP development



Windows install:
  • executable location

  • howto


How to get .deb packages


In order to get the sources, you will need Bazaar version control to pull the source from Launchpad. Check how to get Bazaar according to your development environment. After having installed and configured Bazaar, setup your development environment by typing:

mkdir source;cd source

Get the setup script of OpenERP by typing:

bzr cat -d lp:~openerp-dev/openerp-tools/trunk | sh

Get the current trunk version of OpenERP by typing:

make init-trunk

The makefile contains other options. For details about options, please type:


Some dependencies are necessary to use OpenERP. Depending on your environment, you might have to install the following packets:

sudo apt-get install graphviz ghostscript postgresql python-imaging python-matplotlib

You then have to initialise the database. This will create a new openerp role:

make db-setup

Finally, launch the OpenERP server:

make server

Testing your installation can be done on http://localhost:8069/

Development version

Location of development version + specifics if necessary to precise


Two configuration files are available:

  • one for the client: ~/.openerprc

  • one for the server: ~/.openerp_serverrc

Those files follow the convention used by python's ConfigParser module.

Lines beginning with "#" or ";" are comments.

The client configuration file is automatically generated upon the first start. The one of the server can automatically be created using the command: -s

If they are not found, the server and the client will start with the default configuration.

Server Configuration File

The server configuration file .openerp_serverrc is used to save server startup options. Here is the list of the available options:


Address to which the server will be bound


Port the server will listen on


Name of the database to use


Username used when connecting to the database


File used to translate OpenERP to your language


File used to export the language OpenERP use


Use this language as the language of the server. This must be specified as an ISO country code, as specified by the W3C.


Enable debug output


init a module (use "all" for all modules)


update a module (use "all" for all modules)


Upgrade/install/uninstall modules


specify the database name


specify the database user name


specify the database password


specify the pg executable path


specify the database host


specify the database port


Specify modules to export. Use in combination with --i18n-export

You can create your own configuration file by specifying -s or --save on the server command line. If you would like to write an alternative configuration file, use -c <config file> or --config=<config file> Here is a basic configuration for a server:

verbose = False
xmlrpc = True
database = terp
update = {}
port = 8069
init = {}
interface =
reportgz = False

Full Example for Server V5.0

path = none
softpath_html = none
preview = True
softpath = none

output = stdout
logger =
verbose = True
level = error

index =
context =

autosave = False
toolbar = True

recipient =
support_id =

position = 0
autostart = False

lang = en_US
default_path = /home/user
filetype = {}
theme = none
toolbar = icons
form_tab_orientation = 0
form_tab = top

position = 3

pixmaps = /usr/share/pixmaps/openerp-client/
share = /usr/share/openerp-client/

db = eo2
login = admin
protocol = http://
port = 8069
server = localhost

Command line options

General Options


show program version number and exit

-h, --help

show this help message and exit

-c CONFIG, --config=CONFIG

specify alternate config file

-s, --save

save configuration to ~/.terp_serverrc

-v, --verbose

enable debugging


file where the server pid will be stored


file where the server log will be stored


specify the TCP IP address

-p PORT, --port=PORT

specify the TCP port


specify the TCP IP address for netrpc


specify the TCP port for netrpc


disable netrpc


disable xmlrpc

-i INIT, --init=INIT

init a module (use "all" for all modules)


load demo data for a module (use "all" for all modules)

-u UPDATE, --update=UPDATE

update a module (use "all" for all modules)


stop the server after it initializes


enable debug mode

-S, --secure

launch server over https instead of http


specify the SMTP server for sending mail

Internationalization options:

Use these options to translate OpenERP to another language. See i18n section of the user manual. Option '-l' is mandatory.

-l LANGUAGE, --language=LANGUAGE

specify the language of the translation file. Use it with --i18n-export and --i18n-import


export all sentences to be translated to a CSV file and exit


import a CSV file with translations and exit


specify modules to export. Use in combination with --i18n-export

Options from previous versions:

Some options were removed in version 6. For example, price_accuracy is now configured through the Decimal Accuracy screen.