Vikunja

Key Features

• Multiple project views including List, Kanban, Table, and interactive Gantt charts for comprehensive project visualization
• CalDAV endpoint integration allowing synchronization with external calendar applications and mobile devices
• Built-in data migration tools supporting imports from Todoist, Trello, Microsoft To-Do, and other popular task managers
• MariaDB's enhanced JSON functions providing faster query performance for Vikunja's complex task metadata and custom fields
• Advanced task relationships including subtasks, dependencies, and cross-project linking with visual dependency mapping
• Time tracking and reporting features with detailed analytics on project progress and team productivity
• Collaborative workspaces with granular permission controls for teams, projects, and individual task assignments
• MariaDB's Galera Cluster compatibility enabling high-availability deployments for mission-critical project management

Common Use Cases

• 1Software development teams managing sprints, backlogs, and release planning with Kanban and Gantt chart visualization
• 2Marketing agencies coordinating campaign timelines, client deliverables, and creative asset production workflows
• 3Construction and project management companies tracking milestones, dependencies, and resource allocation across multiple sites
• 4Educational institutions managing curriculum development, research projects, and administrative task coordination
• 5Non-profit organizations coordinating volunteer activities, fundraising campaigns, and community outreach programs
• 6Personal productivity enthusiasts seeking advanced GTD (Getting Things Done) implementation with calendar integration
• 7Remote teams requiring collaborative task management with detailed progress tracking and reporting capabilities

Prerequisites

• Minimum 1GB RAM recommended for MariaDB with moderate task datasets and multiple concurrent users
• Port 3456 available for Vikunja web interface access and API communications
• Basic understanding of task management concepts including projects, labels, and user permission structures
• Environment variable management knowledge for configuring database passwords and frontend URLs
• Storage planning for task attachments, as Vikunja files volume will grow with document uploads
• Network configuration knowledge if deploying behind reverse proxy for SSL termination and custom domains

docker-compose.yml

1services: 
2  vikunja: 
3    image: vikunja/vikunja:latest
4    container_name: vikunja
5    restart: unless-stopped
6    environment: 
7      VIKUNJA_DATABASE_TYPE: mysql
8      VIKUNJA_DATABASE_HOST: db
9      VIKUNJA_DATABASE_DATABASE: vikunja
10      VIKUNJA_DATABASE_USER: vikunja
11      VIKUNJA_DATABASE_PASSWORD: ${DB_PASSWORD}
12      VIKUNJA_SERVICE_FRONTENDURL: http://localhost:3456/
13    ports: 
14      - "3456:3456"
15    volumes: 
16      - vikunja_files:/app/vikunja/files
17    depends_on: 
18      - db
19
20  db: 
21    image: mariadb:10
22    container_name: vikunja-db
23    restart: unless-stopped
24    environment: 
25      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
26      MYSQL_DATABASE: vikunja
27      MYSQL_USER: vikunja
28      MYSQL_PASSWORD: ${DB_PASSWORD}
29    volumes: 
30      - vikunja_db:/var/lib/mysql
31
32volumes: 
33  vikunja_files: 
34  vikunja_db: 

.env Template

1DB_PASSWORD=changeme

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

vikunja:
  image: vikunja/vikunja:latest
  container_name: vikunja
  restart: unless-stopped
  environment:
    VIKUNJA_DATABASE_TYPE: mysql
    VIKUNJA_DATABASE_HOST: db
    VIKUNJA_DATABASE_DATABASE: vikunja
    VIKUNJA_DATABASE_USER: vikunja
    VIKUNJA_DATABASE_PASSWORD: ${DB_PASSWORD}
    VIKUNJA_SERVICE_FRONTENDURL: http://localhost:3456/
  ports:
    - "3456:3456"
  volumes:
    - vikunja_files:/app/vikunja/files
  depends_on:
    - db

db:
  image: mariadb:10
  container_name: vikunja-db
  restart: unless-stopped
  environment:
    MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
    MYSQL_DATABASE: vikunja
    MYSQL_USER: vikunja
    MYSQL_PASSWORD: ${DB_PASSWORD}
  volumes:
    - vikunja_db:/var/lib/mysql

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  vikunja:
5    image: vikunja/vikunja:latest
6    container_name: vikunja
7    restart: unless-stopped
8    environment:
9      VIKUNJA_DATABASE_TYPE: mysql
10      VIKUNJA_DATABASE_HOST: db
11      VIKUNJA_DATABASE_DATABASE: vikunja
12      VIKUNJA_DATABASE_USER: vikunja
13      VIKUNJA_DATABASE_PASSWORD: ${DB_PASSWORD}
14      VIKUNJA_SERVICE_FRONTENDURL: http://localhost:3456/
15    ports:
16      - "3456:3456"
17    volumes:
18      - vikunja_files:/app/vikunja/files
19    depends_on:
20      - db
21
22  db:
23    image: mariadb:10
24    container_name: vikunja-db
25    restart: unless-stopped
26    environment:
27      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
28      MYSQL_DATABASE: vikunja
29      MYSQL_USER: vikunja
30      MYSQL_PASSWORD: ${DB_PASSWORD}
31    volumes:
32      - vikunja_db:/var/lib/mysql
33
34volumes:
35  vikunja_files:
36  vikunja_db:
37EOF
38
39# 2. Create the .env file
40cat > .env << 'EOF'
41DB_PASSWORD=changeme
42EOF
43
44# 3. Start the services
45docker compose up -d
46
47# 4. View logs
48docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/vikunja/run | bash

Troubleshooting