Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Development setup

Install requirements

Install PostgreSQL for your OS.

Create a virtual environment with Python 3.6+. Note that the project is incompatible with Python versions above 3.10 and the tests are run in Python 3.7.

Run the following to install requirements for the project.

pip install -r requirements/development.txt

On newer Mac architectures, you might have to run the following in your terminal before installing the project dependencies:

export LDFLAGS="-L/opt/homebrew/opt/openssl@1.1/lib $LDFLAGS"

Note that the path to openssl/lib might vary depending on how it's been installed.

Set up database

Create a local database with default settings. Update settings file with database credentials if needed.


Load fixtures

Flatpages and email templates are stored in the fixtures folder. Load these:

python loaddata chemie/fixtures/*.json

Send mail (optional)

Postoffice is the mail backend in this project. All emails are queued and not sent until you run this command:

python send_queued_mail

The following environment variables must be set and you must be on eduroam or use VPN to NTNU.

Re-create email templates

Email templates are twofold: A HTML template and a simple text template with no styling. These must be loaded into the database before use. This is done by running:

python import_emails

This requires MJML to be installed. Warning: There is an issue with the import_emails program which leads to all of the templates being deleted without any new ones being created to replace them. Make sure to fix this and test it locally before attempting to use this program.


Export models to json

python dumpdata --natural-foreign --exclude contenttypes app.model app2.model > my_dump.json

Production environment

Edit the .env file to suit your needs

docker-compose up -d --build

Update production

git stash && git pull --rebase && git pop && docker-compose restart

Run this in the terminal


Add packages to requirements

We use pip-tools to make our requirement files easy to understand. To add a new package to the project you need to update either of the files requirements/, requirements/ or requirements/ with the package and then run the line below to update the files requirements/base.txt, requirements/development.txt and requirements/production.txt that is used when setting up the project.

pip-compile requirements/ > requirements/base.txt
pip-compile requirements/ > requirements/development.txt
pip-compile requirements/ > requirements/production.txt