A ready-to-deploy docker compose setup for ocular
Note
For release notes, check out the latest release in the ocular repository. This repo is just for production releases :)
Caution
It is currently not possible to reset the password in case you forget yours! Follow simonwep/genesis#5 to get notified when this is added. (simonwep/ocular#51)
This is the docker-compose setup for ocular. To deploy it, follow these steps:
- Download the latest release and extract it. Do not clone this repository!
- Copy the
.env.example
to.env
, if your app is only used locally make sure to setGENESIS_JWT_COOKIE_ALLOW_HTTP
totrue
if you want to use it without https. - Run
./gen-passwords.sh
to generate secrets and an initial admin user. - Run
docker compose up -d
. - Ocular should be accessible under
http://localhost:3030
in your browser :)
To migrate to a newer version, follow these steps:
- Backup the
./data
folder. The folder contains all the user-data. - Download the latest release and extract it.
- Copy the
.env.example
to.env
, adjust the values if needed. You don't need to run./gen-passwords.sh
again. - Copy your old
./data
folder to the new location. - Run
docker compose up -d
.
Help! I can't log in to the app over the network!
If you don't use https, make sure to set GENESIS_JWT_COOKIE_ALLOW_HTTP
to true
in your .env
file.
Otherwise, run it behind a reverse proxy like nginx and get a free certificate from letsencrypt.