Docker setup
Use Docker Compose to run Torah Reading Tracker with its built-in administrator login. Anyone who can reach the site can view readings. Changing readings and exporting or importing the database require a login.
Start the tracker
-
Get
docker-compose.ymlanddocker-compose.override.yml.examplefrom the repository and put them in the same directory. -
Copy the override and uncomment its
portsmapping. The example binds the app to127.0.0.1:3000on the Docker host.cp docker-compose.override.yml.example docker-compose.override.yml -
Pull and start the service. By default, Compose stores the database in a named volume mounted at
/data. Keep that volume when replacing or updating the container.docker compose pulldocker compose up -ddocker compose logs torah -
Find the generated administrator password in the logs. On the Docker host, open
http://localhost:3000. For access from other devices, put the app behind an HTTPS reverse proxy. Open Settings, log in, and use Change password.
See Configuration to change the port or supply a password before first startup. If you already have a proxy that authenticates users, see Authentication proxy.
Update the app
Back up your readings before updating. Pull the image and apply the update from the same Compose directory.
docker compose pull
docker compose up -d
Open the app and confirm your readings and login still work. An older image cannot open a database with a newer schema. If you need to roll back after a schema change, stop the service and copy the pre-update backup into place. Set the previous image tag in your Compose override, then run docker compose up -d in place of the recovery guide's start command.