mbraut/kanba repository overview

⁠KANBA 🧱

KANBA is a simple and modern Kanban app for task management, built for personal teams, makers, and AI-assisted workflows.

It includes:

• Task boards with drag & drop
• User authentication (JWT)
• Multi-user support
• Light / dark theme
• REST API for integrations and agents

---

⁠Docker Image

Single-container image (frontend + backend + nginx):

• mbraut/kanba:latest
• mbraut/kanba:<version>

---

⁠Quick Start (Docker Run)

bash docker run -d
--name kanba
-p 8080:80
-e KANBAN_SECRET_KEY="CHANGE_ME_TO_A_LONG_RANDOM_SECRET"
-e DATABASE_URL="sqlite:////app/data/kanban.db"
-v kanba_data:/app/data
--restart unless-stopped
mbraut/kanba:latest

Open:

• App: http://localhost:8080
• API docs: http://localhost:8080/docs
• Health: http://localhost:8080/health

---

⁠Quick Start (Docker Compose)

yaml services: kanba: image: mbraut/kanba:latest container_name: kanba restart: unless-stopped ports: "8080:80" environment: KANBAN_SECRET_KEY=CHANGE_ME_TO_A_LONG_RANDOM_SECRET DATABASE_URL=sqlite:////app/data/kanban.db volumes: kanba_data:/app/data

volumes: kanba_data:

⁠Run: bash docker compose up -d

⁠Environment Variables

• KANBAN_SECRET_KEY (required for production)
• Secret used to sign JWT tokens.
• Use a long random value.
• DATABASE_URL (optional)
• Default: sqlite:////app/data/kanban.db
• You can replace with PostgreSQL later if needed.

---

⁠Data Persistence

KANBA stores runtime data in /app/data. Use a Docker volume to persist users/tasks across restarts:

• -v kanba_data:/app/data

---

⁠Security Notes

• Do not expose this container directly to the public internet without a reverse proxy + TLS.
• Always set a strong KANBAN_SECRET_KEY.
• Change default/demo accounts after first startup if you create any.

---

⁠Project Goals

KANBA is designed to be:

• Lightweight
• Self-hosted friendly
• Easy to run with one command
• Easy to integrate via API

---

⁠License

MIT