Self-host Gramps Web with Docker

An online genealogy system for researching and sharing family trees.

This page describes the Levelrail template for Gramps Web (Productivity). It deploys the services below as one Docker Compose app on your own server.

Recommended memory: about 1024 MiB.

Services, ports and volumes

Service	Image	Container ports	Volumes
`grampsweb`	`ghcr.io/gramps-project/grampsweb:25.9.0`	5000	`gramps_users -> /app/users` `gramps_index -> /app/indexdir` `gramps_thumb_cache -> /app/thumbnail_cache` `gramps_cache -> /app/cache` `gramps_secret -> /app/secret` `gramps_db -> /root/.gramps/grampsdb` `gramps_media -> /app/media` `gramps_tmp -> /tmp`
`grampsweb_redis`	`redis:7-alpine`	none	none

Service	Variable	Value
`grampsweb`	`GRAMPSWEB_CELERY_CONFIG__broker_url`	Preset in the template
`grampsweb`	`GRAMPSWEB_CELERY_CONFIG__result_backend`	Preset in the template
`grampsweb`	`GRAMPSWEB_RATELIMIT_STORAGE_URI`	Preset in the template
`grampsweb`	`GRAMPSWEB_SECRET_KEY`	Generated at deploy
`grampsweb`	`GRAMPSWEB_TREE`	Preset in the template
`grampsweb`	`GUNICORN_NUM_WORKERS`	Preset in the template

Passwords and keys marked as generated are created for you when the app is deployed and stored as secrets. Values are not shown here.

In the dashboard, open Apps, choose New app, then Browse templates, and select Gramps Web. Review the Compose body and deploy.

With the CLI:

levelrail-cli templates deploy gramps-web --name my-gramps-web

See Service template catalog for how templates work, and Getting started if you have not installed Levelrail yet.

All templates are listed in the self-host gallery.