Docker

Docker¶

If local installation is not an option, a docker compose environment is provided, but we recommend using the local installation for development if possible.

`ov` CLI¶

A helper CLI is provided to make it easier to run the development environment. It is called ov, and can be used to run commands in the docker container.

ov <command>

Use ov -h to see the available commands and usage.

Requirements

1. Create the backend secrets file¶

In the root directory, create a file called .env with the following contents:

ov-wag/.env

OV_DB_ENGINE=django.db.backends.postgresql
OV_DB_PORT=5432
OV_DB_NAME=ov
OV_DB_USER=postgres
OV_DB_PASSWORD="YOUR POSTGRES PASSWORD HERE"

OV_BASE_URL=http://localhost:3000
OV_ADMIN_BASE_URL=http://localhost:8000

2. (Optional) Build the backend¶

If you have local changes, you can build the backend image locally:

Build the backend

ov b

3. Start the backend¶

Start the backend

ov d

You can now visit the admin interface at http://localhost:8000/admin

4. Create a superuser¶

Create a superuser

ov m createsuperuser

Follow the prompts to create an admin user.

Next steps¶

See the development documentation for more information on how to run the project, including running tests, building documentation, and more.