Deploy Gramps Web
Collaborative genealogy: shared family trees, media, charts and maps
Gramps Web
Just deployed
/data
Redis
Just deployed
/data
Deploy and Host Gramps Web on Railway
Gramps Web is an open-source web app for genealogy, built on the Gramps desktop program. Several people can browse and edit the same family tree in a browser. It covers people, families, events, places, sources and media, with charts, maps, a timeline, reports and DNA tools. It imports GEDCOM and Gramps XML files.
About Hosting Gramps Web
Gramps Web is a Python (Flask) API that serves the web frontend, plus a Celery worker for background jobs such as imports, exports, reports and thumbnails. The worker needs Redis as a message broker. Both processes read the same family tree database and media files. Railway can't share a volume between services, so this template runs the web server and the worker in one container, with all data on one /data volume. The first account is created on first boot with a generated password, so the public setup wizard never opens. Self-registration is off. Updates come from the template's GitHub repo, which pins the official image by version and digest.
Common Use Cases
- Build a shared family tree that relatives can view and edit from any browser
- Move a Gramps desktop or GEDCOM tree online, with photos and documents attached
- Run a private genealogy research site with per-user roles (guest, member, editor, owner)
Dependencies for Gramps Web Hosting
- Redis (Railway Redis, private network) for the Celery job queue and rate limits
- A Railway volume at
/datafor the tree database, media, user accounts, search index and backups
Deployment Dependencies
- Gramps Web 26.11.2 (Gramps Web API 3.25.3), official image
ghcr.io/gramps-project/grampsweb: https://github.com/gramps-project/gramps-web/releases - Gramps Web documentation: https://www.grampsweb.org/
- Template source: https://github.com/aalfath/gramps-web-railway-template
Implementation Details
After the deploy finishes, open the Gramps Web service's Variables tab and copy OWNER_PASSWORD. Sign in at the public URL as owner (or your OWNER_USERNAME), then change the password in Settings. The account is created only while the user database is empty, so changing OWNER_PASSWORD later has no effect.
Import a tree under Import (Gramps XML .gramps, GEDCOM and more), and add family members under Settings > Manage users.
Optional settings go on the Gramps Web service as variables. E-mail for password resets: GRAMPSWEB_EMAIL_HOST, GRAMPSWEB_EMAIL_PORT, GRAMPSWEB_EMAIL_HOST_USER, GRAMPSWEB_EMAIL_HOST_PASSWORD, GRAMPSWEB_DEFAULT_FROM_EMAIL. For a custom domain, set GRAMPSWEB_BASE_URL=https://YOUR-DOMAIN. You can also raise GUNICORN_NUM_WORKERS (default 2) and CELERY_CONCURRENCY (default 1) on a bigger plan. Back up the /data volume, or use Gramps Web's own backups, before you apply an update.
Why Deploy Gramps Web on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Gramps Web on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
Gramps Web
aalfath/gramps-web-railway-templateRedis
redis:8.2