---
title: "Deploy Gramps Web"
description: "Collaborative genealogy: shared family trees, media, charts and maps"
category: "Other"
url: https://railway.com/deploy/gramps-web-1
---

# Deploy Gramps Web

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

**[Deploy Gramps Web on Railway](https://railway.com/template/gramps-web-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/gramps-web-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Gramps Web https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/gramps-web.png

- **Source:** https://github.com/aalfath/gramps-web-railway-template
- **Health check:** /
- **Public domain:** Yes

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

## Documentation

# 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

* 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 &gt; 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/gramps-web-1
