Backend for Online Seminar of Informatics

Running with docker

The backend can be run inside a docker container for testing purposes. To build the image, run:

docker-compose up --build

This will build the image and start the container, together with development versions of the frontend.

The master account is admin@localhost with password change-me.

The backend is created together with a sample seminar repository. To use the repository, you must clone it locally after starting the container:

git clone .docker/data/seminar.git seminar-dev

The backend will automatically push and pull from the repository in the container, you can work with your own clone.

Running manually is discouraged, as it requires a lot of setup. If you still want to run the backend manually, follow the instructions below.

Install virtualenv & packages into ksi-py3-venv directory.

virtualenv -p python3 ksi-py3-venv
source ksi-py3-venv/bin/activate
pip3 install -r requirements.txt

Enter db url into config.py file. Format is the same as specified in config.py.dist
Uncomment part of the app.py, which creates database structure.
Run the server, comment the database-create-section in run.py
Install isolate with box directory /tmp/box.
Bind-mount /etc directory to /opt/etc (this is required for sandbox to work):
```
$ mount --bind /etc /opt/etc
```
Do not forget to add it to /etc/fstab.
Optional: make /tmp tmpfs.
Optional: ensure the server will be started after system boots up (run ./runner start).