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.
Door Simon Vasconcelos Lee
Gepubliceerd op 19 november 2026Leestijd: 13 minuten
vikunja/vikunja:2.8.0 en PostgreSQL, met poort 3456 gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.service.publicurl, het HTTPS-adres van uw instantie, en service.secret, dat de sessies ondertekent.files, vóór elke update; de databasemigraties draaien vanzelf bij het opstarten.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.
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.
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:
| Database | Wat de documentatie zegt | Versie getest in de CI |
|---|---|---|
| SQLite | Meegeleverd met het binaire bestand en de Docker-image, niets te installeren. Boven een handvol gebruikers raadt de documentatie MySQL of PostgreSQL aan. | De meegeleverde |
| PostgreSQL | De database van de Docker-voorbeelden in de documentatie. Sinds 2.8.0 negeert de zoekfunctie accenten met de extensie unaccent. | 18 |
| MySQL, MariaDB | Minstens 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 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:
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:
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:
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.
127.0.0.1: hier wijken we af van de voorbeelden van de documentatie, die de poort op alle adressen publiceren. Haar checklist voor beveiliging vraagt dat alleen de reverse proxy Vikunja kan bereiken: de interface opent dan via die proxy, over HTTPS.VIKUNJA_SERVICE_PUBLICURL: het HTTPS-adres dat uw gebruikers openen, met de afsluitende schuine streep. Vikunja bouwt er zijn links mee, in e-mails bijvoorbeeld, en de toegestane CORS-oorsprong, die standaard aan staat: deze instelling is dus verplicht. Een verkeerd adres, een ontbrekende poort bijvoorbeeld, toont zich als een fout “unauthorized” bij het aanmaken van het eerste account.VIKUNJA_SERVICE_SECRET ondertekent de sessietokens. Blijft het leeg, dan wordt het bij elke start willekeurig gekozen, en meldt elke herstart dan alle gebruikers af.2.8.0 legt de versie vast, zoals de documentatie aanraadt, zodat updates gebeuren wanneer u dat beslist. latest volgt de nieuwste stabiele versie, en unstable de ontwikkelversies.files en db bewaren de bijlagen en de gegevens van PostgreSQL op de server: daarvan maakt u een back-up.scratch. docker exec naar een shell werkt niet, en de variabelen PUID en PGID van andere images hebben er geen effect op. Fouten leest u met docker compose logs vikunja.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:
volumes:
- ./files:/app/vikunja/files
- ./db:/db
Sinds versie 2.4.0 publiceert Vikunja een pakketrepository voor Debian en Ubuntu, voor amd64, arm64 en armhf, ondertekend met zijn GPG-sleutel:
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.
service:
secret: "the value written by the package"
publicurl: "https://tasks.example.com/"
interface: "127.0.0.1:3456"
ipextractionmethod: "xff"
sudo systemctl start vikunja
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:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
Verdere accounts beheert u via de opdrachtregel. Omdat de image geen shell heeft, roept u het binaire bestand rechtstreeks aan:
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
user create vraagt om het wachtwoord als de optie -p het niet meegeeft, zodat het buiten de geschiedenis van uw terminal blijft.user reset-password stuurt een herstellink per e-mail, of vervangt het wachtwoord rechtstreeks met --direct, aan de hand van de ID die user list toont.user change-status schakelt een account uit of weer in, met --disable of --enable.doctor controleert de configuratie, de publieke URL, het geheim, de database, de schrijftoegang tot files en, indien ingeschakeld, de SMTP-server.VIKUNJA_SERVICE_TIMEZONE staat standaard op GMT en verwacht een naam uit de tz-database, Europe/Paris bijvoorbeeld, nooit een UTC-verschil. Ze dient als standaardtijdzone van de gebruikers en bepaalt zo het tijdstip van hun herinneringen.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.
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:
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
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:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Daarna dit serverblok, op poort 80, zodat Certbot HTTPS kan instellen:
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;
}
}
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.
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:
| Sleutel | Standaard | Uitschakelen om |
|---|---|---|
service.enablelinksharing | true | Het delen van projecten via openbare links te voorkomen |
service.enablecaldav | true | Het CalDAV-eindpunt te verwijderen, dat HTTP-basisauthenticatie aanvaardt |
webhooks.enabled | true | Te voorkomen dat Vikunja verzoeken stuurt naar adressen die gebruikers kiezen |
service.enabletaskattachments | true | Het uploaden van bestanden bij taken te voorkomen |
service.enableuserdeletion | true | Te voorkomen dat gebruikers hun eigen account verwijderen |
plugins.enabled | false | Staat al uit: code van derden buiten Vikunja houden |
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.
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja
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 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.
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:
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
VIKUNJA_MAILER_FORCESSL: "true" toe, dat TLS vanaf het begin van de verbinding afdwingt en onversleutelde verbindingen weigert.plain, login of cram-md5 met VIKUNJA_MAILER_AUTHTYPE, afhankelijk van uw server.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.
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com
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.
| Element | Wat het bevat | Hoe u het kopieert |
|---|---|---|
| De PostgreSQL-database | Accounts, projecten, taken, opmerkingen en instellingen | pg_dump, zonder Vikunja te stoppen |
files | Bijlagen, avatars en projectachtergronden | Een kopie van de map |
Met SQLite, db/vikunja.db | De hele database | Een kopie van het bestand, met Vikunja gestopt |
docker-compose.yml | Het geheim, de publieke URL en de wachtwoorden | Apart bewaard, als een geheim |
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.
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:
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
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.
files.docker-compose.yml, bijvoorbeeld van 2.8.0 naar de volgende versie.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.
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.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Het lezen van de logboeken van uw instantie |
| Vikunja | Proactief toezicht: fouten, vertragingen en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De accounts en projecten | De server die ze draagt, bewaakt en geback-upt | De accounts van uw team, de registratie, de delingen en de rechten |
| De e-mail | Een server die uw SMTP-server bereikt op poort 587 of 465 | Uw verzenddienst en zijn inloggegevens |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | Uw exports van de database en de map files, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.