Configuration file for Tryton¶
The configuration file controls some aspects of the behavior of Tryton. The file uses a simple ini-file format. It consists of sections, led by a [section] header and followed by name = value entries:
[database]
uri = postgresql://user:password@localhost/
path = /var/lib/trytond
For more information see ConfigParser.
Sections¶
This section describes the different main sections that may appear in a Tryton configuration file, the purpose of each section, its possible keys, and their possible values. Some modules could request the usage of other sections for which the guideline asks them to be named like their module.
jsonrpc¶
Defines the behavior of the JSON-RPC network interface.
listen¶
Defines a comma separated list of couples of host (or IP address) and port number separated by a colon to listen on.
Default localhost:8000
hostname¶
Defines the hostname for this network interface.
xmlrpc¶
Defines the behavior of the XML-RPC network interface.
listen¶
Same as for jsonrpc except it has no default value.
webdav¶
Define the behavior of the WebDAV network interface.
listen¶
Same as for jsonrpc except it has no default value.
database¶
Defines how the database is managed.
uri¶
Contains the URI to connect to the SQL database. The URI follows the RFC-3986. The typical form is:
database://username:password@host:port/
Default: sqlite://
The available databases are:
PostgreSQL¶
pyscopg2 supports two type of connections:
- TCP/IP connection: postgresql://user:password@localhost:5432/
- Unix domain connection: postgresql://username:password@/
SQLite¶
The only possible URI is: sqlite://
MySQL¶
Same as for PostgreSQL.
path¶
The directory where Tryton stores files and so the user running trytond must have write access on this directory.
Default: /var/lib/trytond/
language¶
The main language of the database that will be used for storage in the main table for translations.
Default: en_US
cache¶
Defines size of various cache.
record¶
The number of record loaded kept in the cache of the list.
It can be changed locally using the _record_cache_size key in
Transaction.context
.
Default: 2000
ssl¶
Activates SSL on all network protocols.
Note
SSL is activated by defining privatekey. Please refer to SSL-CERT on how to use private keys and certficates.
privatekey¶
The path to the private key.
certificate¶
The path to the certificate.
email¶
uri¶
The SMTP-URL to connect to the SMTP server which is extended to support SSL and STARTTLS. The available protocols are:
- smtp: simple SMTP
- smtp+tls: SMTP with STARTTLS
- smtps: SMTP with SSL
Default: smtp://localhost:25
from¶
Defines the default From address for emails sent by Tryton.
session¶
super_pwd¶
The server password used to authenticate from the client for database management tasks. It is encrypted using using the Unix crypt(3) routine. A password can be generated using this command line:
python -c 'import getpass,crypt,random,string; print crypt.crypt(getpass.getpass(), "".join(random.sample(string.ascii_letters + string.digits, 8)))'