Installation

Manual Installation (Advanced Usage)

It is possible to use rumbas without using docker, but this implies some manual installation of software.

Prerequisites

Python 3

Python 3 should be installed and added to the PATH

Running python --version in the terminal / command prompt should yield a version bigger than 3.

The Numbas codebase

rumbas uses Numbas to compile the exams to html.

Clone / Download the numbas code from Github and place it in a folder on your machine.

Set the environment variable NUMBAS_FOLDER to the path of this new folder.

The Numbas extensions

You will need to download all extensions that you want to use and place them in the extensions folder of the NUMBAS_FOLDER.

You can find most extensions at Github.

It is important that you name the folder of the extension exactly as they are named in rumbas.

You can always look at the Dockerfile of rumbas to see how the naming should happen and where you can find the extensions.

The Numbas themes

The themes that are being used in the rumbas repo, should be copied to the themes folder in the NUMBAS_FOLDER.

The Dockerfile uses this script to make sure that the themes are correct.

The rumbas binary

In the future, you might find these binaries on the rumbas Github Releases.

For now, you will need to build the binary yourself.

Building the binary
  • Install the rust
  • Execute cargo build --release in the rumbas folder.

You can also use cargo install --path . in the rumbas folder to build and install the binary.