Commits

Martin Geisler committed 4685ab8

Expland configuration section

  • Participants
  • Parent commits 49eb5d0

Comments (0)

Files changed (1)

File rhodecode.rst

 Configuration
 -------------
 
-By default, RhodeCode will use a SQLite database and this can be
-created directly with the command::
+Create a directory for RhodeCode and create a default configuration
+file::
 
-  $ paster setup-app production.ini
+  $ mkdir rhodecode
+  $ cd rhodecode
+  $ paster make-config RhodeCode production.ini
 
-However, if PostgreSQL is used, the database URL must be edited in
-``production.ini`` and a PostgreSQL user and database must be created
-first::
+Make a directory where the Mercurial repositories will be stored::
+
+  $ mkdir repos
+
+By default, RhodeCode will use a SQLite database, so to use
+PostgreSQL, the database URL must be edited in ``production.ini``. A
+PostgreSQL user and database must be created first::
 
   $ sudo -u postgres createuser rhodecode -P
   Enter password for new role: <rhodecode>
   Shall the new role be allowed to create more new roles? (y/n) n
   $ sudo -u postgres createdb -O rhodecode rhodecode
 
-The database tables can now be created using the ``setup-app`` command
-above. This will also prompt for some basic RhodeCode configuration
-settings such as admin username and password.
+Then uncomment the ``sqlalchemy.db1.url`` line for PostgreSQL in the
+configuration file and and update the username and password to match
+the above. The database tables can then be created with the command::
+
+  $ paster setup-app production.ini
+
+This will also prompt for some basic RhodeCode configuration settings
+such as admin username and password.
+
+To use Celery and RabbitMQ for asynchronous tasks, add a virtual host
+for RhodeCode, add a user, and set permissions::
+
+  $ sudo rabbitmqctl add_vhost rhodecode
+  $ sudo rabbitmqctl add_user rhodecode rhodecode
+  $ sudo rabbitmqctl set_permissions -p rhodecode rhodecode ".*" ".*" ".*"
+
+Then change ``use_celery`` to ``true`` in the RhodeCode configuration
+file and add the login information.
+
+Finally, to make RhodeCode listen on all interfaces, set ``host =
+0.0.0.0`` in the configuration file. The default is to listen on
+``localhost`` only.
+
 
 Startup
 -------