Back to articles
AI & Cloud

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.

DPTCloud Engineering4 min read
Guide to Deploy Vikunja on VPS: Optimized Project Management Solution Replacing Trello and Todoist

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 sudo privileges.

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://:8080 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.yml has correct connection details.

References

DPTCloud Tier III Infrastructure

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.

View 22 VPS Plans
ECO · vn-02Recommended

VPS-4E

297.000 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / mo

10% VAT included

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Recommended

VPS-4T

548.900 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478