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

See the new Odoo user documentation.

See the new Odoo technical documentation.

OpenERP GTK Client Installation

The native GTK client is available as a legacy interface for users who still require it, but the recommended way to access OpenERP 6.1 is the built-in web interface.

Installing the required packages

Python 2.6 or later is required for OpenERP 6.1. It is built-in in Ubuntu version 10.04 and above. A few Python libraries are also required, as listed below.

On a Debian-based Linux distribution you can install all required dependencies with this single command:

apt-get install python-gtk2 python-glade2 python-matplotlib python-dateutil \
    python-lxml python-tz python-hippocanvas python-pydot
  • gtk : GTK+ is a highly usable, feature-rich toolkit for creating graphical user interfaces which boosts cross-platform compatibility and an easy-to-use API.

    sudo apt-get install python-gtk2
    
  • glade : Glade is a RAD tool to enable quick & easy development of user interfaces for the GTK+ toolkit and the GNOME desktop environment.

    sudo apt-get install python-glade2
    
  • matplotlib : matplotlib is a Python 2D plotting library which produces publication quality figures in a variety of hard-copy formats and interactive environments across platforms.

    sudo apt-get install python-matplotlib
    
  • dateutil : Provides date/time values in Python

    sudo apt-get install python-dateutil
    
  • lxml : XML support for Python platform.

    sudo apt-get install python-lxml
    
  • tz : World Timezone definitions for Python.

    sudo apt-get install python-tz
    
  • hippocanvas : The Hippo Canvas is a Cairo/GObject/GTK+ based canvas, written in C with support for flexible layout, CSS styling, and initial work on animations.

    sudo apt-get install python-hippocanvas
    
  • pydot : Python interface to Graphviz's Dot language.

    sudo apt-get install python-pydot
    
  • Any PDF viewer, properly registered in your system to automatically open PDF files (e.g. xpdf, kpdf, acroread, evince, etc..). See the Configuring a PDF Viewer section.

Note

RedHat-based distributions

As an alternative to the above commands meant for Debian-based distributions, the following command should install the required dependencies for RedHat-based systems:

yum install pygtk2 glade3 pydot python-dateutil python-matplotlib \
    python-lxml python-hippo-canvas python-tz

Note

Mandriva

As an alternative to the above commands meant for Debian-based distributions, the following command should install the required dependencies for Mandriva:

yum install pygtk2 glade3 pydot python-dateutil python-matplotlib \
    python-lxml python-hippo-canvas python-tz

Downloading the OpenERP Client

The OpenERP client can be downloaded from the OpenERP website's download page

Testing the OpenERP Client

If you only want to test the client, you do not need to install it. Just unpack the archive and start the openerp-client executable:

tar -xzf openerp-client-6.1-latest.tar.gz
cd openerp-client-6.1-*/bin
./openerp-client.py

The list of available command line parameters can be obtained with the -h command-line switch:

./openerp-client.py -h

Installing the OpenERP Client

The client can be installed very easily using the setup.py file:

tar -xzf openerp-client-6.1-latest.tar.gz
cd openerp-client-6.1-*
sudo python setup.py install

You can now run the client using the following command:

openerp-client

Configuring a PDF Viewer

By default the OpenERP Client will use your default PDF application for displaying PDF files You may customize this behavior by configuring a different default PDF application on your system.

Alternatively, you may also specify explicitly the PDF command to use to display PDF files in the OpenERP configuration file, normally located in your HOME directory, and named '.openerprc'. Find the [printer] section and edit the softpath parameter. For example:

[printer]
softpath = kpdf