From 0bbd9eb936347404a84118ed6053b96e73b939b5 Mon Sep 17 00:00:00 2001 From: Michel Peltriaux Date: Wed, 21 Jul 2021 09:36:34 +0200 Subject: [PATCH] =?UTF-8?q?=E2=80=9EHome=E2=80=9C=20hinzuf=C3=BCgen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Home.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 Home.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..f19b746 --- /dev/null +++ b/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. \ No newline at end of file