Gramps Web
Family tree and genealogy research you can share with your family
- ghcr.io/hsinghhira/gramps-web:latest
- v26.11.3
- Updated 21 Nov 2026
- port 6789
- amd64 · arm64
- Home
- 1.9k stars
Screenshots
Open the app
About Gramps Web
Gramps Web is a genealogy app for building your family tree together. Add people, families, events, places and sources, attach photos and documents, and look at your tree as charts and maps. It works with Gramps on the desktop. The background worker and Redis are built in, so it is one container with nothing else to set up.
Features
- People, families, events, places, sources and notes
- Photos and documents, with face tagging
- Family tree charts, fan charts, timelines and maps
- Import and export GEDCOM and Gramps files
- Users with roles, so family can view or edit
- Search, reports, DNA matches and an AI chat about your tree
How to use
- Open Gramps Web from your dashboard.
- Make the owner account on the first page.
- Import a GEDCOM or Gramps file under Import, or start adding people.
- Invite your family from Settings and give them a role.
Before you install
You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6789. There is no account yet: the first page asks you to make the owner account. Your tree, media, users and the secret key are all kept in /DATA/AppData/gramps-web/data. Email for invites and password resets, single sign-on and the other settings are in the Variables tab and are added in the app settings. The first start takes a few minutes.
The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.
In the app settings
| Variable | Default value | Description |
|---|---|---|
TZ | $TZ | Your time zone. It is filled in from your ZimaOS time zone. |
GRAMPSWEB_ | Gramps Web | The name of your family tree. It is made empty on first start if it does not exist yet. |
Server
| Variable | Default value | Description |
|---|---|---|
GRAMPSWEB_ | http://localhost:6789 | The address you open Gramps Web at, like http://192.168.1.20:6789. Used in links in emails. |
GRAMPSWEB_ | False | Set to True so people can only join when you invite them. |
GRAMPSWEB_ | — | Set to 1 when one reverse proxy is in front of Gramps Web. |
GRAMPSWEB_ | False | Set to True to stop sending anonymous usage counts. |
GUNICORN_ | 2 | How many web server processes to run. More is faster but uses more memory. |
CELERY_ | 2 | How many background jobs (imports, reports) may run at once. |
GRAMPSWEB_ | 5 | How many backups to keep for each tree. |
Email (SMTP)
| Variable | Default value | Description |
|---|---|---|
GRAMPSWEB_ | — | Your email server, like smtp.gmail.com, for invites and password resets. |
GRAMPSWEB_ | 465 | Your email server port, usually 465 or 587. |
GRAMPSWEB_ | — | The user name for your email server. |
GRAMPSWEB_ | — | The password for your email server. |
GRAMPSWEB_ | False | Set to True for port 587 (STARTTLS). |
GRAMPSWEB_ | — | The address emails are sent from. |
Single sign-on (OIDC)
| Variable | Default value | Description |
|---|---|---|
GRAMPSWEB_ | False | Set to True to sign in with your own provider. |
GRAMPSWEB_ | — | Your provider's issuer address, like https://auth.example.com. |
GRAMPSWEB_ | — | The client ID from your provider. |
GRAMPSWEB_ | — | The client secret from your provider. |
GRAMPSWEB_ | OIDC | The name on the sign-in button. |
name: gramps-web
services:
gramps-web:
image: ghcr.io/hsinghhira/gramps-web:latest
container_name: gramps-web
restart: unless-stopped
stop_grace_period: 60s
network_mode: bridge
environment:
- TZ=$TZ
- GRAMPSWEB_TREE=Gramps Web
ports:
- target: 5000
published: "6789"
protocol: tcp
volumes:
- type: bind
source: /DATA/AppData/$AppID/data
target: /data
bind:
create_host_path: true
healthcheck:
test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:5000/"]
interval: 30s
timeout: 10s
retries: 5
start_period: 300s
deploy:
resources:
limits:
cpus: "2.00"
memory: 2048M
reservations:
cpus: "0.05"
memory: 256M
labels:
icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gramps-web/icon.png
x-casaos:
id: com.icestore.gramps-web
envs:
- container: TZ
description:
en_US: >-
Your time zone. It is filled in from your ZimaOS time zone.
- container: GRAMPSWEB_TREE
description:
en_US: >-
The name of your family tree. It is made empty on first start
if it does not exist yet.
ports:
- container: "5000"
description:
en_US: Gramps Web app and API, published on host as 6789
volumes:
- container: /data
description:
en_US: >-
Everything Gramps Web keeps: your family tree (grampsdb),
photos and documents (media), user accounts (users), the
search index, caches, the secret key and Redis. Back it up.
x-casaos:
id: com.icestore.gramps-web
architectures:
- amd64
- arm64
main: gramps-web
author: HSinghHira
category: Home
developer: Gramps project
icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gramps-web/icon.png
thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gramps-web/screenshot-1.png
screenshot_link:
- https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gramps-web/screenshot-1.png
- https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gramps-web/screenshot-2.png
- https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/gramps-web/screenshot-3.png
title:
en_US: Gramps Web
tagline:
en_US: Family tree and genealogy research you can share with your family
description:
en_US: >-
Gramps Web is a genealogy app for building your family tree together.
Add people, families, events, places and sources, attach photos and
documents, and look at your tree as charts and maps. It works with
Gramps on the desktop. The background worker and Redis are built in,
so it is one container with nothing else to set up.
**Features**
- People, families, events, places, sources and notes
- Photos and documents, with face tagging
- Family tree charts, fan charts, timelines and maps
- Import and export GEDCOM and Gramps files
- Users with roles, so family can view or edit
- Search, reports, DNA matches and an AI chat about your tree
**How to use?**
1. Open Gramps Web from the ZimaOS dashboard.
2. Make the owner account on the first page.
3. Import a GEDCOM or Gramps file under Import, or start adding
people.
4. Invite your family from Settings and give them a role.
tips:
before_install:
en_US: >-
1. More settings, like email for invites and password resets, are
listed on the Gramps Web page at
https://icestore.hsinghhira.me/app/gramps-web/ (Variables tab).
You can add them now or later in the app settings.
2. Start the installation. The first start takes a few minutes.
3. Open http://[ZIMAOS-IP-ADDRESS]:6789 and make the owner account.
index: /
port_map: "6789"
scheme: http
is_uncontrolled: false
version: "26.11.3"
update_at: "2026-11-21"
release_notes:
en_US: |-
- First IceStore release, on port 6789
- Built on ghcr.io/gramps-project/grampsweb 26.11.3, with its Celery worker and Redis inside the same container
- Every data folder is under one data folder; Gramps Web makes its own secret key and asks for the owner account on its first page
repo: "https://github.com/gramps-project/gramps-web"
support: "https://github.com/gramps-project/gramps-web/issues"
docs: "https://www.grampsweb.org/"Install Gramps Web
Something not working with Gramps Web?
Report it so it gets fixed, or ask for an app that is not here yet.
ZimaOS
Add the store link, then find Gramps Web in the App Store and install it.
CasaOS
Add the store link, then find Gramps Web in the App Store and install it.
ReCasaOS
Add the store link, then find Gramps Web in the App Store and install it.
Homeio
Add the store link, then find Gramps Web in the App Store and install it.
MOS
Add the repository in MOS Hub Settings, then find Gramps Web in Docker → MOS Hub and install it.


