Setting up a server
Zom's MRP Server keeps one plan for a team. Everyone signs in from their own browser, on a computer or a phone, and changes others make show up on their own. This page sets it up with Docker and https.
What you need
- A Linux server or VPS with Docker and Docker Compose.
- A domain name pointed at it (an A record), like
mrp.example.com. - Ports 80 and 443 open to it, so Caddy can get an https certificate.
Setting it up
Get the files:
docker-compose.ymlanddeploy/Caddyfilefrom the repository.In
deploy/Caddyfile, replacemrp.example.comwith your domain.Start it, in the folder with
docker-compose.yml:bashdocker compose up -dOpen
https://your-domainright away and create the admin account: Set up this server, with your name, a username and a password of 10 characters or more.
Create the admin right away
Until there's an admin, whoever opens the page first can make one. Open it and set it up as soon as it's running.
Caddy gets and renews the https certificate by itself. Zom's MRP itself isn't reachable except through Caddy.
What's in it
The compose file runs two containers:
| Container | Does |
|---|---|
mrp | Zom's MRP Server, from ghcr.io/zombeatz/zoms-mrp-server. Its data is in the mrp-data volume. |
mrp-caddy | Caddy, for https on ports 80 and 443 |
Server settings
Set these as environment variables on the mrp container in docker-compose.yml:
| Variable | What it does |
|---|---|
MRP_NAME | The name on the sign-in page, like "Northern Rotor scheduling" |
MRP_TRUST_PROXY | on when a proxy in front of it handles https (on in the compose file) |
MRP_PORT | The port it listens on (7430) |
MRP_BIND | The address it listens on (0.0.0.0) |
MRP_DATA | The data folder (/data in Docker) |
MRP_TLS | off behind a proxy, or files to use your own certificate |
MRP_TLS_CERT, MRP_TLS_KEY | The PEM files, with MRP_TLS=files |
After changing them, run docker compose up -d again.
Updating
In the folder with docker-compose.yml:
docker compose pull && docker compose up -dThe plan stays in the mrp-data volume. A plan from an older version is converted when the new one opens it.
Moving a plan onto the server
- In the desktop app, Settings > Your data > Save a backup.
- Sign in to the server as an admin and use Settings > The plan > Restore a backup….
Related
- People and roles: adding the team.
- Backups and security: copies, the activity log and what's protected.
- A team on a server: the whole setup, step by step.
- Phones and tablets: using it on a phone.