Gramps Web
★ 225GNU Affero General Public License v3.0Open Source — No Paywall3 Containers — 3 containers — light hosting footprintNo external DB19 active committers (12mo)
About
Gramps Web API is a backend service for the Gramps genealogy ecosystem. It provides a Python-based REST API for accessing and modifying a Gramps family tree database through web requests. The project...
Community Ratings
No ratings yetNew this week
Read recap →Weekly Recap — Oct 2, 2026 – Oct 9, 2026Oct 9, 2026
Features
- query family tree database
- manipulate family tree database
- backend for Gramps Web
- backend for other tools
Details
- Last Updated
- Oct 10, 2026
- Created
- Aug 13, 2020
- Requirements
- Gramps
- API
- REST
- Runtime / Stack
- Docker
- Privacy & Independence
- No Cloud Required
- Deployment
Deployment: Docker Compose ✓3 Containers — light hosting footprintRuns as 3 containers
Run Gramps Web with Docker Compose
Compose file from the Gramps Web project repository.
3 services · infra: valkey · 1 unclassified (ollama)
no resource limits declared
needs persistent storage (2 volumes)
.devcontainer/docker-compose.yml · @ 99f5eff · scanned Sep 25, 2026
services:
devcontainer:
build:
context: .
dockerfile: Dockerfile
volumes:
- ../..:/workspaces:cached
command: sleep infinity
environment:
LANGUAGE: en
OMP_NUM_THREADS: 1
GRAMPSWEB_BASE_URL: http://localhost:8001
GRAMPSWEB_USER_DB_URI: sqlite:////workspaces/web-api/data/users.sqlite
GRAMPSWEB_MEDIA_BASE_DIR: /workspaces/web-api/data/media
GRAMPSWEB_SEARCH_INDEX_DB_URI: sqlite:////workspaces/web-api/data/indexdir/search_index.db
GRAMPSWEB_STATIC_PATH: /workspaces/web-api/data/static
GRAMPSWEB_THUMBNAIL_CACHE_CONFIG__CACHE_DIR: /workspaces/web-api/data/thumbnail_cache
GRAMPSWEB_REPORT_DIR: /workspaces/web-api/data/reports_cache
GRAMPSWEB_EXPORT_DIR: /workspaces/web-api/data/export_cache
GRAMPSHOME: /workspaces/web-api/data/
GRAMPS_DATABASE_PATH: /workspaces/web-api/data/grampsdb
GRAMPSWEB_TREE: "Gramps Web"
# Do not use this value in production!!
GRAMPSWEB_SECRET_KEY: QAVoeYDzkQves9iDZ5PkxfdUoVElVMVYPqz-QXha6yE
GRAMPSWEB_CORS_ORIGINS: "*"
GRAMPSWEB_VECTOR_EMBEDDING_MODEL: sentence-transformers/distiluse-base-multilingual-cased-v2
# To use Ollama for embeddings instead of local SentenceTransformer,
# start with: docker compose --profile ollama up -d
# Then uncomment the following lines and comment out the line above:
# GRAMPSWEB_VECTOR_EMBEDDING_BASE_URL: http://ollama:11434
# GRAMPSWEB_VECTOR_EMBEDDING_MODEL: nomic-embed-text
GRAMPSWEB_CELERY_CONFIG__broker_url: redis://redis:6379/0
GRAMPSWEB_CELERY_CONFIG__result_backend: redis://redis:6379/0
GRAMPSWEB_LOG_LEVEL: DEBUG
GRAMPSWEB_FRONTEND_URL: ""
redis:
image: valkey/valkey:alpine
restart: unless-stopped
ports:
- "6379:6379"
ollama:
image: ollama/ollama:latest
profiles:
- ollama
restart: unless-stopped
ports:
- "11434:11434"
volumes:
- ollama-data:/root/.ollama
volumes:
ollama-data:
This file may be out of date. Check the Gramps Web documentation for current setup steps.
Tags
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.
Metadata extracted from README on Sep 22, 2026
Related Software
webtrees
828
webtrees is an online collaborative genealogy application for viewing, editing, and managing family trees on a website.
Genealogy SoftwareMedia ManagementSelf Hosting Solutions+2
Genealogy
365
Genealogy is a free and open-source PHP family tree application for recording family members and their relationships.
Genealogy SoftwarePermissive LicenseSelf Hosting Solutions+2
3 ContainersFully FOSS
GeneWeb
402
GeneWeb is open source genealogy software with a web interface, designed to manage large family databases and genealogical relationships.
Genealogy SoftwareCopyleft LicenseSelf Hosting Solutions+3
Fully FOSS
Genea.app
277
Genea is a web app for visually building and editing family trees using GEDCOM genealogy files.
Genealogy SoftwarePermissive LicenseSelf Hosting Solutions+1
Paperless-ngx
46.5k
Paperless-ngx is a document management system that turns physical documents into a searchable online archive.
Document ManagementDigital ArchivingAutomation Tools+3
Karakeep
29.6k
Karakeep is a self-hostable bookmark-everything app with AI-assisted tagging, summarization, and search.
Bookmark ManagementPastebinsCopyleft License+4
3 Containers
ArchiveBox
28.7k
ArchiveBox is a self-hosted web archiving tool that preserves websites and other online content in durable, machine-readable formats.
Digital ArchivingFully FOSSPermissive License+3
Fully FOSS
linkding
11.3k
linkding is a self-hosted bookmark manager designed to be minimal, fast, and easy to set up with Docker.
Bookmark ManagementKnowledge ManagementDigital Archiving+2
Single Container
MeTube
15.0k
A web GUI for youtube-dl/yt-dlp that lets users download videos from YouTube and other supported sites, with playlist support.
Media ManagementCopyleft LicenseMedia Servers+2
CKAN
5.1k
CKAN is an open-source data portal platform for publishing, sharing, cataloging, storing, and accessing datasets.
Digital ArchivingCopyleft LicenseSelf Hosting Solutions+2
5 Containers
backrest
7.5k
Backrest is a web-accessible backup solution built on top of restic, with a WebUI for creating repositories, browsing snapshots, and restoring files.
File & Object StorageDigital ArchivingSelf Hosting Solutions+1
Tube Archivist
8.5k
Tube Archivist is a self-hosted web application for indexing, searching, downloading, and watching archived YouTube videos offline.
Media ServersDigital ArchivingMedia Management+2
