Guide to Deploy Vikunja on VPS: Optimized Project Management Solution Replacing Trello and Todoist
Detailed guide to deploy Vikunja on VPS as an open-source project management solution, replacing Trello and Todoist with automation, sharing, and real-time sync features.
Image credit: MR-PANDA · Pixabay Content License
Introduction to Vikunja – Open-Source Project Management Solution
Vikunja is an open-source project management platform designed to replace solutions like Trello and Todoist with flexible features, high automation, and strong integration capabilities. With a user-friendly interface, Vikunja enables organizing tasks into lists, projects, teams, and even real-time workflows. It supports API synchronization, integrates with tools like Nextcloud, and can be self-hosted on private servers.
In this guide, we’ll deploy Vikunja on a Cloud VPS with a minimum configuration of 2 cores and 4GB RAM using Docker for simplified installation and management. This is ideal for individuals, small teams, or businesses seeking full data control and avoiding dependency on closed cloud platforms.
Prerequisites Before Deployment
- VPS with minimum specs: 2 CPU cores, 4GB RAM, 20GB SSD.
- Operating system: Ubuntu 20.04 or 22.04.
- Docker and Docker Compose installed.
- Domain or subdomain (optional, but required for HTTPS access).
- SSH access to the VPS with
sudoprivileges.
Deploy Vikunja on VPS Using Docker
We’ll use Docker Compose to deploy Vikunja with PostgreSQL and Redis. This method is fast, simple, and easy to maintain.
1. Create Project Directory
mkdir -p ~/vikunja && cd ~/vikunja
2. Create docker-compose.yml File
version: '3.8'
services:
vikunja:
image: vikunja/api:latest
container_name: vikunja
ports:
- "8080:8080"
environment:
- DATABASE_URL=postgres://vikunja:password@db:5432/vikunja?sslmode=disable
- REDIS_URL=redis://redis:6379
- VIKUNJA_SECRET=your-secret-key-here
- VIKUNJA_SERVER_URL=http://localhost:8080
depends_on:
- db
- redis
restart: unless-stopped
db:
image: postgres:14
container_name: vikunja-db
environment:
- POSTGRES_DB=vikunja
- POSTGRES_USER=vikunja
- POSTGRES_PASSWORD=password
volumes:
- ./db-data:/var/lib/postgresql/data
restart: unless-stopped
redis:
image: redis:6-alpine
container_name: vikunja-redis
restart: unless-stopped
vikunja-web:
image: vikunja/web:latest
container_name: vikunja-web
ports:
- "80:80"
environment:
- VIKUNJA_API_URL=http://vikunja:8080
depends_on:
- vikunja
restart: unless-stopped
3. Start Services
docker-compose up -d
4. Check Service Status
docker-compose ps
Wait until all containers show Up.
Setup and Access Vikunja
After startup, access http:// or http:// if a domain is configured.
Register a new account and start creating projects. Vikunja supports:
- Creating to-do lists
- Assigning tasks to team members
- Integrating with Nextcloud and other apps via API
- Sharing projects with others
- Real-time data synchronization
Verification and Maintenance
1. Check API Functionality
curl -s http://localhost:8080/api/v1/ping | jq
If the response is {"status": "ok"}, the API is running.
2. Create Database Backup
docker exec -it vikunja-db pg_dump -U vikunja vikunja > ~/vikunja-backup.sql
3. Update to Latest Version
docker-compose pull
docker-compose up -d
Troubleshooting
- Website not accessible: Verify ports 80 and 8080 are open in the VPS firewall.
- API returns 500 error: Check container logs:
docker logs vikunja. - Cannot connect to PostgreSQL: Ensure
docker-compose.ymlhas correct connection details.
References
High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache
Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.
VPS-4E
10% VAT included
- CPU: 4 vCPU
- RAM: 8 GB
- SSD: 50 GB NVMe
