How kobotoolbox/kobo-docker works
kobo-docker packages the containers and configuration for running a self-hosted KoboToolbox survey platform. The principal workflow is a user reaching the frontend, where KPI, KoBoCAT and Enketo provide the platform’s application capabilities, backed by PostgreSQL, MongoDB and Redis. The README documents separate frontend and backend deployments, distinct KPI and KoBoCAT PostgreSQL databases, scheduled backups, and optional S3 storage. The graph preserves those documented capabilities; frontend request routing and maintenance behavior are not established by the excerpts, so those links are marked unverified.
Main entry points: docker-compose.frontend.yml NGINX · scripts/backup-to-s3.py PostgreSQL backup · mongo/backup-to-s3.py MongoDB backup · redis/backup-to-s3.py Redis backup
Components 16
Frontend services
- NGINX
docker-compose.frontend.yml - KPI
docker-compose.frontend.yml - KoBoCAT
docker-compose.frontend.yml - Enketo Express
docker-compose.frontend.yml
Backend services
- MongoDB
docker-compose.backend.yml - KPI PostgreSQL
docker-compose.backend.yml - KoBoCAT PostgreSQL
docker-compose.backend.yml - Redis
docker-compose.backend.yml
Backup services
- MongoDB backup
mongo/backup-to-s3.py - PostgreSQL backup
postgres/scripts/backup-to-s3.py - Redis backup
redis/backup-to-s3.py - KoBoCAT media backup
docker-compose.frontend.yml
Maintenance
- Maintenance configuration
docker-compose.maintenance.yml - Maintenance page
nginx/maintenance/index.html.tmpl
Other components
- Platform user
- AWS S3
Connections 13
- Platform user → NGINX: accesses
- NGINX → KPI: routes requests
- NGINX → KoBoCAT: routes requests
- NGINX → Enketo Express: routes requests
- MongoDB backup → MongoDB: backs up
README.md - PostgreSQL backup → KPI PostgreSQL: backs up
README.md - PostgreSQL backup → KoBoCAT PostgreSQL: backs up
README.md - Redis backup → Redis: backs up
README.md - KoBoCAT media backup → KoBoCAT: backs up media
README.md - MongoDB backup → AWS S3: uploads optionally
README.md - PostgreSQL backup → AWS S3: uploads optionally
README.md - Redis backup → AWS S3: uploads optionally
README.md - Maintenance configuration → Maintenance page: serves