• Introduction
• Installation
• Automatic Way
• Client Installation
• Server and Modules Installation
• Updating Client, Server and Modules Repositories in one go (using hgforest)
• Installing Tryton on your favourite distribution
• Database installation

Introduction

This page describes the installation process of Tryton from scratch.

Mercurial is the distributed source control management system (DSCM) used by the Tryton project. The repository layout for the Tryton project is divided into

• one repository for the client (tryton)
• one repository for the server (trytond)
• repositories for the modules, one for each module, prefixed by module/
• the above structure copied for each release, prefixed by the release version
• several other project related repositories

You need to install Mercurial before you can follow this instructions.

Installation

The installation of Tryton is divided in four parts, following the three-tier architecture of Tryton

1. Installation of Requirements
2. Client installation
3. Server and modules installation
4. Database installation

In a development or testing installation we strongly advise you to use a "Mercurial Forest" for easy maintainance on updating and testing (see section below: Updating Client, Server and Modules Repositories in one go ).

Automatic Way

• Dowload tryton-dev.py (or tryton-dev.sh)
• Usage: python ./tryton-dev.py (or sh ./tryton-dev.sh) will download hgforest, tryton, trytond and all available modules of the trunk version to the current directory.
• -d allows to choose the destination directory.
• -u for updating an existing copy.
• -b allows to choose another branch (e.g. -b 1.0).
• -m allows to download only the modules. (They are placed in trytond/trytond/modules/.)

You must still install the dependencies of the client and the server, and the database

Client Installation

This section describes the installation process for tryton (the client application)

• Creating a folder for tryton (the client) (we create the folder under ~/workspace)

mkdir ~/workspace/tryton-dist
cd ~/workspace/tryton-dist

• Clone the hg repository

hg clone http://hg.tryton.org/tryton/

Server and Modules Installation

This section describes the installation process for the trytond server application and the modules.

• Creating a folder for trytond (the server) (we create the folder under ~/workspace)

mkdir ~/workspace/tryton-dist
cd ~/workspace/tryton-dist

• Clone the hg repository

hg clone http://hg.tryton.org/trytond/

• Create a modules folder:

mkdir trytond/trytond/modules

• Clone the modules into the modules folder:

cd trytond/trytond/modules
hg clone http://hg.tryton.org/modules/account
hg clone http://hg.tryton.org/modules/account_be
hg clone http://hg.tryton.org/modules/account_invoice
hg clone http://hg.tryton.org/modules/account_invoice_history
hg clone http://hg.tryton.org/modules/account_product
hg clone http://hg.tryton.org/modules/account_statement
hg clone http://hg.tryton.org/modules/analytic_account
hg clone http://hg.tryton.org/modules/analytic_invoice
hg clone http://hg.tryton.org/modules/analytic_purchase
hg clone http://hg.tryton.org/modules/analytic_sale
hg clone http://hg.tryton.org/modules/company
hg clone http://hg.tryton.org/modules/country
hg clone http://hg.tryton.org/modules/currency
hg clone http://hg.tryton.org/modules/google_maps
hg clone http://hg.tryton.org/modules/party
hg clone http://hg.tryton.org/modules/product
hg clone http://hg.tryton.org/modules/project
hg clone http://hg.tryton.org/modules/project_revenue
hg clone http://hg.tryton.org/modules/purchase
hg clone http://hg.tryton.org/modules/sale
hg clone http://hg.tryton.org/modules/stock
hg clone http://hg.tryton.org/modules/stock_supply
hg clone http://hg.tryton.org/modules/timesheet
# ...

Updating Client, Server and Modules Repositories in one go (using hgforest)

The Mercurial DSCM has an extension which makes it possible to maintain easily a bundle of repositories in a so called forest. With the installation of the Mercurial forest extension you are able to update all repositories with a single hg fpull and hg fupdate.

1. Clone the Mercurial forest extension to /usr/local/src/hgforest

cd /usr/local/src/
sudo hg clone http://hg.akoha.org/hgforest/

2. Go to your directory containing the mercurial repositories for the Tryton forest (e.g. ~/workspace/tryton-dist) and initialize the forest

cd ~/workspace/tryton-dist
hg init

3. Append/create the .hg/hgrc file for the hgforest extension

echo -e "[extensions]\nforest=/usr/local/src/hgforest/forest.py" >> .hg/hgrc

4. Now it's quite easy to update all the modules in one go

cd ~/workspace/tryton-dist
hg fpull
hg fupdate

Hint for users working behind a proxy:

Currently neither the tryton client nor the forest extension are able to connect via a http proxy. Instead they can be socksified and thus connect via socks server, i.e.

tsocks hg fpull

Installing Tryton on your favourite distribution

We strongly suggest you to use the installation packages provided by your distribution. For installation hints for your preferred distribution please refer to the additional pages below

• InstallationOnDebian
• InstallationOnMandriva

Database installation

trytond uses PostgreSQL as database engine.

The PostgreSQL database may be installed on the same machine as the trytond server application, but it can be on any machine connected via TCP/IP network.

Please refer to the appropriate documentation for installing PostgreSQL on your operating system or distribution.