Deploy Gramps Web

Collaborative genealogy: shared family trees, media, charts and maps

Deploy Gramps Web

/data

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 /data for the tree database, media, user accounts, search index and backups

Deployment Dependencies

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

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0