59 lines
1.2 KiB
ReStructuredText
59 lines
1.2 KiB
ReStructuredText
Installation guide
|
|
==================
|
|
|
|
Typography
|
|
----------
|
|
|
|
Commands starting with ``#`` must be run as ``root`` user.
|
|
|
|
Commands starting with ``$`` must be run as ``ponyconf`` user.
|
|
|
|
|
|
Requirements
|
|
------------
|
|
|
|
PonyConf has been tested with python 3.5 and 3.6.
|
|
|
|
|
|
Preparation
|
|
-----------
|
|
|
|
Create a user ``ponyconf``::
|
|
|
|
# useradd -r -m -d /srv/www/ponyconf ponyconf
|
|
|
|
The directory ``/srv/www`` must exist before.
|
|
An other base directory is fine.
|
|
|
|
The following commands are run as ``ponyconf`` user::
|
|
|
|
# su - ponyconf
|
|
|
|
Create ``log`` and ``webdir`` directories::
|
|
|
|
$ mkdir log webdir
|
|
|
|
Clone the repository in the ``app`` directory::
|
|
|
|
$ git clone https://git.afpy.org/AFPy/PonyConf.git app
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
Copy the example configuration file::
|
|
|
|
$ cp app/ponyconf/local_settings.py.example app/ponyconf/local_settings.py
|
|
|
|
Set the ``SECRET_KEY`` value.
|
|
You can generate a secret key with ``openssl``::
|
|
|
|
$ openssl rand -base64 32
|
|
|
|
Verify emails related settings values.
|
|
Set your timezone and language code.
|
|
|
|
If you want to use another database than the default one (SQLite), set ``DATABASES``.
|
|
You can find the syntax in the `django documentation`_.
|
|
|
|
.. _django documentation: https://docs.djangoproject.com/en/dev/ref/settings/#std:setting-DATABASES
|