KoboFlux v2 — modern KoboToolbox dashboard. Run with docker compose and your API token.
1.1K
KoboFlux v2 is an open-source web interface for KoboToolbox. Browse forms, view submissions, export data, and bulk-upload Excel rows — with your Kobo API token kept on the server, never in the browser.
Independent project — not affiliated with KoboToolbox.
| Registry | Tag examples |
|---|---|
josephfidelis/koboflux-v2 | latest, 1.0.0, git SHA |
1. Create a .env file next to docker-compose.yml:
NUXT_KOBO_API_TOKEN=your_kobo_api_token_here
NUXT_KOBO_BASE_URL=https://kf.kobotoolbox.org
NUXT_PUBLIC_APP_NAME=KoboFlux
NUXT_PUBLIC_BASE_URL=
2. Use the compose file from the GitHub repo or this minimal version:
services:
kobo-flux:
image: josephfidelis/koboflux-v2:latest
container_name: koboflux-v2
restart: unless-stopped
ports:
- "3000:3000"
env_file:
- .env
environment:
HOST: 0.0.0.0
PORT: 3000
3. Start:
docker compose pull
docker compose up -d
docker compose logs -f # logs
docker compose ps # status
docker compose restart # after editing .env
docker compose down # stop
Custom port:
KOBOFLUX_PORT=8080 docker compose up -d
(requires ports: - "${KOBOFLUX_PORT:-3000}:3000" in compose)
Pull and run:
docker pull josephfidelis/koboflux-v2:latest
docker run -d \
--name koboflux-v2 \
--restart unless-stopped \
-p 3000:3000 \
-e NUXT_KOBO_API_TOKEN=your_kobo_api_token_here \
-e NUXT_KOBO_BASE_URL=https://kf.kobotoolbox.org \
-e NUXT_PUBLIC_APP_NAME=KoboFlux \
-e HOST=0.0.0.0 \
-e PORT=3000 \
josephfidelis/koboflux-v2:latest
Using an env file (preferred):
docker run -d \
--name koboflux-v2 \
--restart unless-stopped \
-p 3000:3000 \
--env-file .env \
josephfidelis/koboflux-v2:latest
Pin a version:
docker pull josephfidelis/koboflux-v2:1.0.0
docker run -d --name koboflux-v2 -p 3000:3000 --env-file .env josephfidelis/koboflux-v2:1.0.0
Stop and remove:
docker stop koboflux-v2 && docker rm koboflux-v2
| Variable | Required | Default | Description |
|---|---|---|---|
NUXT_KOBO_API_TOKEN | Yes | — | Kobo API token (server-only) |
NUXT_KOBO_BASE_URL | No | https://kf.kobotoolbox.org | Kobo host (https://eu.kobotoolbox.org for EU) |
NUXT_PUBLIC_APP_NAME | No | KoboFlux | Name shown in the UI |
NUXT_PUBLIC_BASE_URL | No | (empty) | Leave empty for same-origin API proxy |
KOBOFLUX_PORT | No | 3000 | Host port (Compose only) |
Never bake tokens into the image. Pass them at runtime with -e or --env-file.
latest — current main branch1.0.0, 0.1.0, … — matches version in package.json on each releaseTry out at https://koboflux.fidelisuwem.com/
Content type
Image
Digest
sha256:72ecdc926…
Size
56.7 MB
Last updated
3 months ago
docker pull josephfidelis/koboflux-v2