diff --git a/doc/deployment/external.rst b/doc/deployment/external.rst index 39602f33..94d8f83f 100644 --- a/doc/deployment/external.rst +++ b/doc/deployment/external.rst @@ -163,4 +163,34 @@ Setting up your environment --------------------------- Now it's time to set up your environment. This is done by through the use of a -:code:`dotenv` file. \ No newline at end of file +:code:`dotenv` file. + +In the root directory of the project, you can find a :code:`.env.sample` file. It's strongly recommended that you use this as a starting point: + +:: + + cp .env.sample .env + +Inside of this file you will find a number of environment variables: + +* :code:`FLASK_CONFIG=` A choice between :code:`deployment` and :code:`production`. :code:`production` disables debugging and stops SQLAlchemy spamming the console. +* :code:`POSTGRES_USER=` The username of your PostgreSQL user. If you are using the :code:`docker-compose` file then this will be used within the :code:`db` container. +* :code:`POSTGRES_PASSWORD=` The password of your PostgreSQL user. If you are using the :code:`docker-compose` file then this will be used within the :code:`db` container. +* :code:`POSTGRES_HOST=` The database host address of your PostgreSQL server. If you are deploying the project through :code:`docker-compose` then ensure that the name matches what is found within the :code:`docker-compose.yml` file (this is usually :code:`db`). +* :code:`POSTGRES_DB=` The database name for of your PostgreSQL server. If you are deploying the project through :code:`docker-compose` then ensure that the name matches what is found within the :code:`docker-compose.yml` file (this is usually :code:`limbus`). +* :code:`SECRET_KEY=` A secret key to protect you against XSS. Please change this. +* :code:`WTF_CSRF_SECRET_KEY=` A secret key to protect forms against XSS. Please change this. +* :code:`DOCUMENT_DIRECTORY=` Where you want your encrypted document store to be located. If you are using the :code:`docker-compose` file, then please ensure that you mount your location appropriately. +* :code:`TEMPLATES_DIRECTORY=` Where you want your templates store to be located. If you are using the :code:`docker-compose` file, then please ensure that you mount your location appropriately. +* :code:`DEBUG=` If you require debug information. In most deployments this should be set to False. +* :code:`DOID_PATH=` Where you want your DOID file to be located. If you are using the :code:`docker-compose` file, then please ensure that you mount your location appropriately. + + +.. note:: + Please ensure that all secret keys and passwords are secure. + + +Do it for me +------------ + +No. \ No newline at end of file