Vikunja

Vikunja is an open-source, self-hosted To-do list application.

Description

It allows you to organize all your tasks on all platforms. It features boards, lists, and a powerful filter system.

Getting started

Docker

To get Vikunja up and running quickly with Docker:

docker run -p 3456:3456 -v $PWD/files:/app/vikunja/files -v $PWD/db:/db vikunja/vikunja

Navigate to http://localhost:3456 to access the web interface.

CLI examples

When running in Docker, execute commands using docker exec:

# List all users
docker exec <container_name> /app/vikunja/vikunja user list

# Create a full dump of the database and files
docker exec <container_name> /app/vikunja/vikunja dump

# Show Vikunja version
docker exec <container_name> /app/vikunja/vikunja version

API examples

Authenticate using an API token in the Authorization header:

curl -H "Authorization: Bearer <your_api_token>" \
     "<your-vikunja-base-url>/api/v1/tasks"

Use your own private Vikunja base URL here. Do not commit instance-specific URLs, project IDs, or tokens into this repository.

Links

• Official Website
• Documentation

Alternatives

• Focalboard
• Nextcloud Tasks

Backlog

• Sync with CalDAV (Radicale).

Sources / References

• Official Documentation
• CLI Reference

Contribution Metadata

• Last reviewed: 2026-03-15
• Confidence: high