„Home“ hinzufügen

Home.md

@@ -0,0 +1,36 @@
+# Home
+
+## Installation
+Navigate to your project folder and clone the repository onto your machine
+```
+git clone https://git.naturschutz.rlp.de/SGD-Nord/konova.git
+```
+Create a virtual environment using python3. The venv does not need to be in the same folder as the code. For production installation it is recommended to keep the venv somewhere else. You can find more information about [python virtual environments here](https://docs.python.org/3/library/venv.html).
+```
+python3 -m venv /path/to/new/virtual/environment
+```
+Open up the venv
+```
+source /path/to/new/virtual/environment/bin/activate
+```
+Install all requirements for this project
+```
+pip install -r requirements.txt
+```
+*There might be issues with the installation of the package `psycopg2` (python-postgresql package) which is not available on all linux distributions for building. If the installation for `psycopg2` fails, rename the requirement to `psycopg2-binary` and rerun the command to use a pre-build version of this package.*
+
+## Setup
+On a fresh installation you need to create the postgresql database first:
+```
+create database "konova";
+```
+
+Afterwards open up the virtual environment (if not already opened)
+```
+source /path/to/new/virtual/environment/bin/activate
+```
+and run the konova setup command
+```
+python manage.py setup
+```
+This will create some basic groups and initial data, like a superuser, which can be used to work in the admin backend interface.