HomelabDeck
← Back to all apps

Vikunja

Notes/Docs

Self-hosted to-do app with lists, Kanban, Gantt and CalDAV sync.

Vikunja is a self-hosted, open-source to-do and project management app supporting lists, Kanban boards, Gantt charts and table views of the same tasks. It offers recurring tasks, filters, labels, team sharing and a CalDAV interface so you can keep using your favorite calendar/task client while owning your data.

License
AGPL-3.0
GitHub stars
5,500
Official website
https://vikunja.io
Source code
https://github.com/go-vikunja/vikunja

Compatibility

Architectures
amd64, arm64
Database
PostgreSQL
Resource footprint
512 MB RAM · 1 CPU
512 MB RAM / 1 core for the Go/Vue app plus a small PostgreSQL instance is plenty for personal or small-team task management. Written in Go, the API binary itself is very light; footprint mostly comes from the database and number of concurrent users.

Proof of Work Gallery

  • Dashboard
  • Settings
  • Projects

Deployment

services:
  db:
    image: postgres:16
    container_name: vikunja-db
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: vikunja
      POSTGRES_USER: vikunja
    volumes:
      - db-data:/var/lib/postgresql/data

  vikunja:
    image: vikunja/vikunja:latest
    container_name: vikunja
    restart: unless-stopped
    depends_on:
      - db
    environment:
      VIKUNJA_DATABASE_HOST: db
      VIKUNJA_DATABASE_PASSWORD: change-me
      VIKUNJA_DATABASE_TYPE: postgres
      VIKUNJA_DATABASE_USER: vikunja
      VIKUNJA_DATABASE_DATABASE: vikunja
      VIKUNJA_SERVICE_PUBLICURL: https://vikunja.example.com
      VIKUNJA_SERVICE_JWTSECRET: change-me-too
    ports:
      - "3456:3456"
    volumes:
      - files-data:/app/vikunja/files

volumes:
  db-data:
  files-data:

Alternative to

Todoist, Notion (task use case), Microsoft To Do