Berlyne is tested on the following platforms:

• Ubuntu 16.04
• Debian 8.6

other Linux distributions should work as well but are not tested. Windows is not supported!

This tutorial shows how to install a local version of Berlyne on a Debian based system.

Please note, that this will only be a local version for experimenting, developing and creating problems.

Do not use the method here for deploying Berlyne on production systems. Also see the Security Considerations page.

Berlyne, by default, supports three providers:

• Docker
• VirtualBox
• DigitalOcean

so depending on which providers you want to use, you have to install the software. Please search the internet for a guide on how to install Docker or VirtualBox on your platform.

Make sure that the user running Berlyne is allowed to create and manage containers in Docker, see docker documentation.

For using DigitalOcean as provider, just do the following after installing Vagrant (see next section).

$vagrant plugin install vagrant-digitalocean

and add your DigitalOcean API key to the file vagrantfiles/ubuntu_digital_ocean.

To install Berlyne, first install a couple of packages:

$apt update
$apt install python3-pip python3-venv vagrant git

Next, clone the repository:

$git clone https://github.com/rugo/berlyne.git

Afterwards, create a virtual environment and activate it:

$pyvenv bervenv
$source bervenv/bin/activate

After that, install the needed python packages:

$pip install -r berlyne/requirements.txt

And thats basically it. Now set up the database with those two steps:

$cd berlyne # change to Berlyne dir
$./manage.py makemigrations
$./manage.py migrate

This will create an example course and install a tutorial problem. If you don't want this example content to be created, change the settings.py file to say:

IN_TEST_MODE = False

before you run the migrate command.

After that, you can run Berlyne with the command:

$./manage.py runserver

Thats it!

You can now access the WebUI via http://localhost:8000

The example superuser has the credentials:

• admin:NoGood123

The example participant:

• participant:NoGood123