Vikunja hosten op een Managed VPS: uw taken en projecten op uw eigen server

Vikunja hosten op een Managed VPS betekent dat u de taken en projecten van uw team bewaart op een machine die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Vikunja is vrije software onder de AGPL-3.0-licentie. Deze gids volgt de officiële documentatie: de keuze van de database, de installatie met Docker Compose, het publieke adres en het geheim, de accounts, HTTPS, de eigen instellingen van Vikunja, e-mail, back-ups en updates.

Simon Vasconcelos Lee Door Gepubliceerd op 19 november 2026Leestijd: 13 minuten

Alle gidsen

In het kort

  1. Dankzij de AGPL-3.0-licentie gebruikt u Vikunja in een bedrijf zonder een licentie te kopen; als u het wijzigt, moeten uw gebruikers op afstand de broncode van uw versie kunnen krijgen.
  2. Installeer het met Docker Compose: de image vikunja/vikunja:2.8.0 en PostgreSQL, met poort 3456 gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.
  3. Twee instellingen horen er vanaf het begin bij: service.publicurl, het HTTPS-adres van uw instantie, en service.secret, dat de sessies ondertekent.
  4. Vikunja heeft geen standaardaccount: maak het uwe aan, sluit daarna de registratie en voeg de volgende accounts toe via de opdrachtregel.
  5. Maak samen een back-up van de database en de map files, vóór elke update; de databasemigraties draaien vanzelf bij het opstarten.

Wat Vikunja doet

Vikunja is een opensource, zelf gehoste taak- en projectbeheerder, die zijn repository omschrijft als “de takenbeheerder die echt van u is”. De API, geschreven in Go, en de webinterface worden geleverd in één binair bestand, of één Docker-image: er is maar één ding om te installeren.

Wat de AGPL-3.0-licentie toestaat

Vikunja wordt gepubliceerd onder de GNU AGPL versie 3 of later, met uitzondering van de map desktop/ van zijn repository, de desktop-app, die onder de GPL versie 3 of later valt. U kunt het gebruiken, ook in een bedrijf, voor uw team en voor uw klanten, zonder een licentie te kopen. Wat overblijft zijn de kosten van de server waarop het draait.

Sectie 13 voegt een voorwaarde toe die eigen is aan de AGPL: als u het programma wijzigt, moet uw versie iedereen die er op afstand, via een netwerk, mee werkt duidelijk zichtbaar de mogelijkheid bieden om de broncode kosteloos te krijgen. Als u kopieën verspreidt, gelden daarnaast de verplichtingen van de licentie om de broncode te delen. Vikunja draaien zonder het te wijzigen, valt niet onder deze sectie.

Deze gids installeert die opensource-editie, die de documentatie op zichzelf als volledig functioneel omschrijft. Vikunja Pro, een optionele licentie, voegt voor organisaties een beheerpaneel, tijdregistratie en auditlogboeken toe.

Resources en database

Vikunja draait op SQLite, PostgreSQL, MySQL of MariaDB. De documentatie noemt geen cijfers voor geheugen of CPU; ze stuurt de keuze van de database op basis van het aantal gebruikers:

DatabaseWat de documentatie zegtVersie getest in de CI
SQLiteMeegeleverd met het binaire bestand en de Docker-image, niets te installeren. Boven een handvol gebruikers raadt de documentatie MySQL of PostgreSQL aan.De meegeleverde
PostgreSQLDe database van de Docker-voorbeelden in de documentatie. Sinds 2.8.0 negeert de zoekfunctie accenten met de extensie unaccent.18
MySQL, MariaDBMinstens MySQL 8.0, want 5.7 wordt niet ondersteund. Voor niet-Latijnse tekens moet de database utf8mb4 gebruiken.MySQL 8, MariaDB 12

De documentatie raadt een databaseversie aan die nog wordt onderhouden. Redis kan als cache dienen, maar ze merkt op dat u het waarschijnlijk niet nodig hebt zolang de instantie maar een handvol gebruikers heeft: deze gids doet het zonder.

Het schijfgebruik volgt vooral uw bijlagen en projectachtergronden, opgeslagen in de map files, standaard maximaal 20 MB per bestand. Op een managed VPS beschrijft u ons uw team, het aantal gebruikers en hoeveel het op bijlagen steunt, en wij raden u de juiste omvang aan.

De installatie met Docker Compose

De documentatie installeert Vikunja en PostgreSQL met Docker Compose. Maak op een server waarop Docker is geïnstalleerd een map aan en genereer eerst het geheim van de instantie, een willekeurige waarde die u in het bestand plakt:

Terminal
openssl rand -hex 32

Plaats daarna deze docker-compose.yml in de map, overgenomen uit het PostgreSQL-voorbeeld van de documentatie. Vervang tasks.example.com door uw domeinnaam, paste-your-secret-here door de gegenereerde waarde en changeme door een sterk wachtwoord, op beide plaatsen hetzelfde:

docker-compose.yml
services:
  vikunja:
    image: vikunja/vikunja:2.8.0
    environment:
      VIKUNJA_SERVICE_PUBLICURL: https://tasks.example.com/
      VIKUNJA_SERVICE_SECRET: paste-your-secret-here
      VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff
      VIKUNJA_DATABASE_TYPE: postgres
      VIKUNJA_DATABASE_HOST: db
      VIKUNJA_DATABASE_USER: vikunja
      VIKUNJA_DATABASE_PASSWORD: changeme
      VIKUNJA_DATABASE_DATABASE: vikunja
    ports:
      - "127.0.0.1:3456:3456"
    volumes:
      - ./files:/app/vikunja/files
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped
  db:
    image: postgres:18
    environment:
      POSTGRES_USER: vikunja
      POSTGRES_PASSWORD: changeme
    volumes:
      - ./db:/var/lib/postgresql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
      interval: 30s
      start_period: 15s
      start_interval: 5s

Vikunja draait als gebruiker 1000: maak de map files aan en draag die vóór de eerste start aan hem over, zoals de documentatie vraagt, en start daarna de diensten:

Terminal, in de map van docker-compose.yml
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja

Bij de eerste start maakt Vikunja zijn database aan en voert het al zijn migraties uit. De regel http server started on [::]:3456 in de logboeken betekent dat het klaar is, en curl http://127.0.0.1:3456/api/v1/info, uitgevoerd op de server, geeft zijn versie en zijn openbare instellingen terug.

Met SQLite

Voor een handvol gebruikers biedt de documentatie SQLite aan: verwijder de dienst db, het blok depends_on en de variabelen VIKUNJA_DATABASE_*, en koppel een map aan /db, waar de image vikunja.db al opslaat. Maak die map aan en draag ze over aan gebruiker 1000, zoals files:

docker-compose.yml, dienst vikunja
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db

Zonder Docker: het Debian-pakket

Sinds versie 2.4.0 publiceert Vikunja een pakketrepository voor Debian en Ubuntu, voor amd64, arm64 en armhf, ondertekend met zijn GPG-sleutel:

Terminal
curl -fsSL https://dl.vikunja.io/repos/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/vikunja.gpg
echo "deb [signed-by=/usr/share/keyrings/vikunja.gpg] https://dl.vikunja.io/repos/apt stable main" | sudo tee /etc/apt/sources.list.d/vikunja.list
sudo apt update && sudo apt install vikunja

Het pakket installeert Vikunja in /opt/vikunja, standaard met SQLite, en een systemd-dienst die ingeschakeld is maar nog niet gestart. Het schrijft ook een willekeurig geheim in een sectie service van /etc/vikunja/config.yml: vul diezelfde sectie aan en start daarna de dienst.

/etc/vikunja/config.yml
service:
  secret: "the value written by the package"
  publicurl: "https://tasks.example.com/"
  interface: "127.0.0.1:3456"
  ipextractionmethod: "xff"
Terminal
sudo systemctl start vikunja

Het eerste account en de registratie

Vikunja maakt standaard geen account aan. Zodra HTTPS werkt, opent u https://tasks.example.com/ en registreert u zich: dat is uw eerste account. De registratie staat standaard open, voor iedereen die het adres bereikt; zodra de accounts van uw team bestaan, stelt de documentatie voor ze te sluiten. Voeg deze regel toe aan de variabelen van de dienst vikunja en voer daarna opnieuw docker compose up -d uit:

docker-compose.yml, onder environment
      VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"

Verdere accounts beheert u via de opdrachtregel. Omdat de image geen shell heeft, roept u het binaire bestand rechtstreeks aan:

Terminal, in de map van docker-compose.yml
docker compose exec vikunja /app/vikunja/vikunja user create -u marie -e marie@example.com
docker compose exec vikunja /app/vikunja/vikunja user list
docker compose exec vikunja /app/vikunja/vikunja user reset-password 2 --direct

De beveiliging van de accounts

HTTPS: de reverse proxy

Vikunja levert gewone HTTP. De documentatie laat HTTPS eindigen bij een reverse proxy, zodat wachtwoorden en tokens nooit onversleuteld over het netwerk gaan: die luistert op poorten 80 en 443, haalt het certificaat op en stuurt door naar Vikunja op 127.0.0.1:3456.

Achter een proxy ziet Vikunja standaard bij elk verzoek het adres van de proxy: logboeken en snelheidslimieten treffen dan iedereen tegelijk. De instelling VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, die al in het Compose-bestand staat, laat het de header X-Forwarded-For lezen. Het vertrouwt die header alleen bij verzoeken van loopback-adressen en adressen van privénetwerken, het Docker-netwerk inbegrepen: met de poort gepubliceerd op 127.0.0.1 komt alleen uw proxy daar.

Met Caddy

Hier is de Caddyfile van de documentatie. Caddy haalt zelf een certificaat van Let’s Encrypt op voor de opgegeven naam, geeft de header X-Forwarded-For door en laat WebSocket-verbindingen door:

Caddyfile
tasks.example.com {
    reverse_proxy 127.0.0.1:3456
}

Met Nginx

Het blok van de documentatie beperkt zich tot een regel proxy_pass en een uploadgrootte. Dit blok bouwt erop voort met twee toevoegingen: de header X-Forwarded-For, die Vikunja leest, en de WebSocket-headers. De interface van versie 2.8.0 opent een WebSocket-verbinding op /api/v2/ws voor zijn live updates; als die mislukt, vallen de meldingen terug op een controle om de 10 seconden. Voeg eerst dit blok map toe aan de sectie http van /etc/nginx/nginx.conf:

nginx.conf, in http
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Daarna dit serverblok, op poort 80, zodat Certbot HTTPS kan instellen:

Nginx-blok
server {
    listen 80;
    listen [::]:80;
    server_name tasks.example.com;

    location / {
        proxy_pass http://127.0.0.1:3456;
        client_max_body_size 20M;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

client_max_body_size 20M komt overeen met de maximale bestandsgrootte in Vikunja, standaard 20 MB. Als u die verhoogt met VIKUNJA_FILES_MAXSIZE, vraagt de documentatie om ook deze regel te verhogen.

De eigen instellingen van Vikunja

Bijna elke sleutel van het bestand config.yml heeft zijn omgevingsvariabele: service.enablecaldav wordt VIKUNJA_SERVICE_ENABLECALDAV. Staat een optie op beide plaatsen, dan wint de variabele. De beveiligingschecklist van de documentatie overloopt de functies die u kunt uitschakelen als u ze niet gebruikt:

SleutelStandaardUitschakelen om
service.enablelinksharingtrueHet delen van projecten via openbare links te voorkomen
service.enablecaldavtrueHet CalDAV-eindpunt te verwijderen, dat HTTP-basisauthenticatie aanvaardt
webhooks.enabledtrueTe voorkomen dat Vikunja verzoeken stuurt naar adressen die gebruikers kiezen
service.enabletaskattachmentstrueHet uploaden van bestanden bij taken te voorkomen
service.enableuserdeletiontrueTe voorkomen dat gebruikers hun eigen account verwijderen
plugins.enabledfalseStaat al uit: code van derden buiten Vikunja houden

Zoeken zonder accenten op PostgreSQL

Sinds 2.8.0 negeert de zoekfunctie accenten op PostgreSQL wanneer de extensie unaccent actief is: “cafe” vindt ook “café”. De officiële PostgreSQL-image levert ze mee; schakel ze in in de Vikunja-database en herstart daarna Vikunja. Het logboek toont dan unaccent extension detected, search is accent-insensitive.

Terminal, in de map van docker-compose.yml
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja

Uw taken importeren

Elke gebruiker importeert taken via het tabblad “Import” van zijn instellingen, en kan daar ook al zijn gegevens exporteren als zip-archief. De bestandsimports, Vikunja-archief, CSV, TickTick en WeKan, net als de import vanuit een Planka-instantie, zijn altijd beschikbaar. Todoist, Trello en Microsoft To Do verlopen via OAuth: ze staan standaard uit en worden ingeschakeld in de sectie migration van de configuratie, met de inloggegevens van de app die bij elke dienst is aangemaakt. De OAuth-doorverwijzing gebeurt in de browser: de instantie hoeft voor die diensten niet bereikbaar te zijn, maar service.publicurl moet kloppen.

CalDAV

CalDAV synchroniseert de taken met uw apps, met de verbindingsgegevens in het tabblad CalDAV van de instellingen. De documentatie presenteert deze integratie als een alfaversie die goed werkt met sommige clients: probeer de uwe voordat u ze het hulpmiddel van het hele team maakt. Op iPhone en iPad wordt elk project een lijst in de app Herinneringen. Een account met tweestapsverificatie maakt verbinding met een eigen CalDAV-token.

E-mail: herinneringen, bevestigingen en wachtwoorden

Vikunja verstuurt e-mails voor herinneringen bij taken, de bevestiging van nieuwe accounts en het opnieuw instellen van wachtwoorden. Het verzenden staat standaard uit: accounts zijn dan actief zodra ze zijn aangemaakt, en een wachtwoord opnieuw instellen per e-mail is niet mogelijk. Zodra het verzenden aan staat, bevestigt elk nieuw lokaal account zijn adres voor gebruik.

Stel vanaf een Simafri-VPS een geauthenticeerde SMTP-server in, op poort 587 of 465: die van uw verzenddienst of uw e-mailprovider. Voeg deze variabelen toe aan de dienst vikunja:

docker-compose.yml, onder environment
      VIKUNJA_MAILER_ENABLED: "true"
      VIKUNJA_MAILER_HOST: smtp.example.com
      VIKUNJA_MAILER_PORT: 587
      VIKUNJA_MAILER_USERNAME: tasks@example.com
      VIKUNJA_MAILER_PASSWORD: your-smtp-password
      VIKUNJA_MAILER_FROMEMAIL: tasks@example.com

Voer opnieuw docker compose up -d uit en stuur daarna een testbericht. De opdracht controleert de verbinding met een SMTP-opdracht NOOP, die sommige minimale relays niet ondersteunen: geef de voorkeur aan een volwaardige SMTP-server.

Terminal
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com

De back-ups

De documentatie telt twee delen waarvan samen een back-up moet worden gemaakt: de database en de map met bijlagen. Sinds 2.8.0 belanden verwijderde taken en projecten eerst 30 dagen in de prullenbak; is die tijd verstreken of de prullenbak geleegd, dan brengt alleen een back-up ze terug.

ElementWat het bevatHoe u het kopieert
De PostgreSQL-databaseAccounts, projecten, taken, opmerkingen en instellingenpg_dump, zonder Vikunja te stoppen
filesBijlagen, avatars en projectachtergrondenEen kopie van de map
Met SQLite, db/vikunja.dbDe hele databaseEen kopie van het bestand, met Vikunja gestopt
docker-compose.ymlHet geheim, de publieke URL en de wachtwoordenApart bewaard, als een geheim
Terminal, in de map van docker-compose.yml
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files

De documentatie vraagt om versleutelde back-ups die buiten de server worden bewaard, en om regelmatig geteste herstelprocedures: meld u aan op een aparte instantie en open een taak met een bijlage. Op de schijf van de server bewaard, zijn deze archieven ook deel van zijn nachtelijke back-ups.

De opdracht vikunja dump bundelt de configuratie, de database en alle bestanden in een zip-archief, en vikunja restore laadt het weer in. Het archief bevat het configuratiebestand en elke variabele VIKUNJA_* in leesbare tekst: versleutel het en bescherm het zoals de database zelf.

Terugzetten

Laad op een nieuwe installatie, met dezelfde docker-compose.yml, de export in de nog lege database vóór de eerste start van Vikunja, en zet daarna de map files terug op zijn plaats:

Terminal
docker compose up -d db
docker compose exec -T db psql -U vikunja vikunja < vikunja-2026-11-19.sql
tar -xzf vikunja-files-2026-11-19.tar.gz
docker compose up -d

De updates

Vikunja voert zijn databasemigraties vanzelf uit wanneer een nieuwe versie start. De documentatie vraagt daarom om een back-up vóór elke update, zodat u naar de vorige toestand kunt terugkeren, en om de release-opmerkingen te lezen, die eventuele handmatige stappen vermelden.

  1. Lees de opmerkingen bij de nieuwe versie.
  2. Exporteer de database en kopieer de map files.
  3. Wijzig de tag van de image in docker-compose.yml, bijvoorbeeld van 2.8.0 naar de volgende versie.
  4. Haal de nieuwe image op en herstart de dienst.
Terminal
docker compose pull
docker compose up -d

Met het Debian-pakket vervangt sudo apt update && sudo apt upgrade het binaire bestand en herstart het de dienst. Overstappen van een stabiele versie naar de builds unstable werkt, maar de documentatie raadt af om terug te gaan: wacht in plaats daarvan op de volgende stabiele versie.

Beveiligingscorrecties worden gepubliceerd als GitHub-beveiligingsadviezen en aangekondigd in de release-opmerkingen. Versie 2.8.0 van 5 november 2026 corrigeert er negentien, en de aankondiging ervan vraagt om zo snel mogelijk bij te werken. Om op de hoogte te blijven, volgt u de releases van de GitHub-repository of de RSS-feed van de changelog.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Vikunja blijft uw software, met zijn instellingen, uw projecten en uw taken.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat bij uw activiteit past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenHet lezen van de logboeken van uw instantie
VikunjaProactief toezicht: fouten, vertragingen en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent
De accounts en projectenDe server die ze draagt, bewaakt en geback-uptDe accounts van uw team, de registratie, de delingen en de rechten
De e-mailEen server die uw SMTP-server bereikt op poort 587 of 465Uw verzenddienst en zijn inloggegevens
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenUw exports van de database en de map files, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet moment van de overschakeling

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.

Vikunja, op een server die voor u wordt beheerd

Met een Managed VPS van Simafri houdt ons team de server van uw Vikunja-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.

Ontdek Managed VPS

Veelgestelde vragen

Is Vikunja gratis voor een bedrijf?

Ja. Vikunja valt onder de AGPL-3.0-licentie: u kunt het in een bedrijf gebruiken zonder een licentie te kopen. Als u het wijzigt, moeten uw gebruikers op afstand de broncode van uw versie kunnen krijgen. Wat overblijft zijn de kosten van de server waarop het draait.

Welke database kiest u voor Vikunja?

SQLite, meegeleverd met de image, volstaat voor een handvol gebruikers. Daarboven raadt de documentatie PostgreSQL of MySQL aan. PostgreSQL is de database van haar Docker-voorbeelden, en sinds 2.8.0 negeert de zoekfunctie ervan accenten met de extensie unaccent.

Hoe installeert u Vikunja met Docker Compose?

Maak een docker-compose.yml met de images vikunja/vikunja:2.8.0 en postgres:18, poort 3456 gepubliceerd op 127.0.0.1, een map files overgedragen aan gebruiker 1000, de publieke URL en het geheim, en voer daarna docker compose up -d uit. Zet vervolgens een reverse proxy met HTTPS voor poort 3456.

Waarvoor dienen service.publicurl en service.secret?

service.publicurl is het HTTPS-adres van uw instantie: Vikunja bouwt er zijn links en zijn CORS-oorsprong mee, vandaar een fout unauthorized wanneer het niet klopt. service.secret ondertekent de sessies; blijft het leeg, dan verandert het bij elke start en meldt het alle gebruikers af.

Hoe maakt u het eerste Vikunja-account aan?

Vikunja heeft geen standaardaccount: registreer u op uw instantie. Sluit daarna de registratie door VIKUNJA_SERVICE_ENABLEREGISTRATION op false te zetten, en maak de volgende accounts aan met de opdracht vikunja user create, uitgevoerd in de container.

Hoe stelt u e-mail in Vikunja in?

Schakel het verzenden in met VIKUNJA_MAILER_ENABLED en geef daarna de host, poort 587 of 465, de gebruikersnaam, het wachtwoord en het afzenderadres van uw SMTP-server op. Zonder e-mail zijn accounts actief zodra ze zijn aangemaakt en worden wachtwoorden opnieuw ingesteld via de opdrachtregel.

Hoe maakt u een back-up van Vikunja?

Maak samen een back-up van de database, met pg_dump voor PostgreSQL, en van de map files met de bijlagen. Bewaar de kopieën versleuteld en buiten de server, maak er een vóór elke update en test regelmatig of ze terug te zetten zijn.

Dekt een managed VPS ook Vikunja?

Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.

Bronnen en officiële documentatie

Neem contact op