diff --git a/doc/setup/install.rst b/doc/setup/install.rst
index 9b75d3f4bc2..9abaaf90d0e 100644
--- a/doc/setup/install.rst
+++ b/doc/setup/install.rst
@@ -235,18 +235,34 @@ Source installation requires manually installing dependencies:
- on Windows, use `the official Python 2.7 installer
`_.
-
* PostgreSQL, to use a local database
- - on Linux, use your distribution's package
+ After installation you will need to create a postgres user (also named a
+ role), by default the only user is ``postgres``, and Odoo forbids connecting
+ as ``postgres``.
+
+ - on Linux, use your distribution's package, then create a postgres user
+ named like your login:
+
+ .. code-block:: console
+
+ $ sudo su - postgres -c "createuser -s $USER"
+
+ Because the role login is the same as your unix login unix sockets can be
+ use without a password.
+
- on OS X, `postgres.app `_ is the simplest way to
- get started
+ get started, then create a postgres user like on Linux.
+
- on Windows, use `PostgreSQL for windows`_ then add PostgreSQL's ``bin``
directory (default: ``C:\Program Files\PostgreSQL\9.3\bin``) to your
:envvar:`PATH`
- .. todo:: create new role?
+ Then create a postgres user with a password using the pg admin gui, for
+ example login ``odoo`` and password ``odoo``.
+ This user and password will be provided with the -w and -r option or in the
+ config file.
* Python dependencies listed in the :file:`requirements.txt` file.
@@ -294,8 +310,8 @@ Source installation requires manually installing dependencies:
.. code-block:: console
- C:\> cd \YourOdooSourcePath
- C:\YourOdooSourcePath> C:\Python27\Scripts\pip.exe install -r requirements.txt
+ C:\> cd \YourOdooPath
+ C:\YourOdooPath> C:\Python27\Scripts\pip.exe install -r requirements.txt
Running Odoo
@@ -309,14 +325,33 @@ Once all dependencies are set up, Odoo can be launched by running ``odoo.py``.
Common necessary configurations are:
-* PostgreSQL host, port, user and password. Odoo has no defaults beyond
+* PostgreSQL host, port, user and password.
+
+ Odoo has no defaults beyond
`psycopg2's defaults `_: connects
over a UNIX socket on port 5432 with the current user and no password.
- This may require creating new PostgreSQL roles, by default the only user is
- ``postgres``, and Odoo forbids connecting as ``postgres``.
* Custom addons path beyond the defaults, to load your own modules
+Under Windows a typical way to execute odoo would be:
+
+ .. code-block:: console
+
+ C:\YourOdooPath> python odoo.py -w odoo -r odoo --addons-path=addons,../mymodules --db-filter=mydb$
+
+Where ``odoo``, ``odoo`` are the postgresql login and password,
+``../mymodules`` a directory with additional addons and ``mydb`` the default db
+to serve on localhost:8069
+
+Under Unix a typical way to execute odoo would be:
+
+ .. code-block:: console
+
+ $ ./odoo.py --addons-path=addons,../mymodules --db-filter=mydb$
+
+Where ``../mymodules`` is a directory with additional addons and ``mydb`` the default db
+to serve on localhost:8069
+
.. _demo: https://demo.odoo.com
.. _EPEL: https://fedoraproject.org/wiki/EPEL