At hoste Vikunja på en Managed VPS betyder, at du holder dit teams opgaver og projekter på en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. Vikunja er fri software under AGPL-3.0-licensen. Denne guide følger den officielle dokumentation: valget af database, installation med Docker Compose, den offentlige adresse og hemmeligheden, konti, HTTPS, Vikunjas egne indstillinger, e-mail, backup og opdateringer.
Af Simon Vasconcelos Lee
Udgivet den 19. november 2026Læsetid: 13 minutter
vikunja/vikunja:2.8.0 og PostgreSQL, med port 3456 publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.service.publicurl, din instans' HTTPS-adresse, og service.secret, som signerer sessionerne.files sammen, før hver opdatering; databasemigreringerne kører af sig selv ved opstart.Vikunja er en selvhostet opgave- og projektstyring med åben kildekode, som dens repository beskriver som ”den opgavestyring, du faktisk ejer”. API'et, skrevet i Go, og webbrugerfladen leveres i én enkelt binær fil eller ét enkelt Docker-image: der er kun én ting at installere.
Vikunja udgives under GNU AGPL version 3 eller senere, bortset fra mappen desktop/ i dens repository, desktopappen, der er under GPL version 3 eller senere. Du kan bruge den, også i virksomheden, til dit team såvel som til dine kunder, uden at købe en licens. Tilbage står prisen på den server, den kører på.
Afsnit 13 tilføjer en betingelse, der er særlig for AGPL: hvis du ændrer programmet, skal din version tydeligt tilbyde alle, der interagerer med den på afstand via et netværk, muligheden for at få dens kildekode gratis. Hvis du distribuerer kopier, gælder licensens forpligtelser til at dele kildekoden også. At køre Vikunja uden at ændre den udløser ikke dette afsnit.
Denne guide installerer den udgave med åben kildekode, som dokumentationen beskriver som fuldt funktionsdygtig i sig selv. Vikunja Pro, en valgfri licens, tilføjer et administrationspanel, tidsregistrering og revisionslogge til organisationer.
Vikunja kører på SQLite, PostgreSQL, MySQL eller MariaDB. Dokumentationen angiver ingen tal for hukommelse eller CPU; den styrer valget af database efter antallet af brugere:
| Database | Hvad dokumentationen siger | Version testet i CI |
|---|---|---|
| SQLite | Følger med den binære fil og Docker-imaget, intet at installere. Ud over en håndfuld brugere anbefaler dokumentationen MySQL eller PostgreSQL. | Den medfølgende |
| PostgreSQL | Databasen i dokumentationens Docker-eksempler. Siden 2.8.0 ignorerer søgningen accenter med udvidelsen unaccent. | 18 |
| MySQL, MariaDB | Mindst MySQL 8.0, da 5.7 ikke understøttes. Til ikke-latinske tegn skal databasen bruge utf8mb4. | MySQL 8, MariaDB 12 |
Dokumentationen anbefaler en databaseversion, der stadig vedligeholdes. Redis kan bruges som cache, men den bemærker, at du sandsynligvis ikke får brug for det, så længe instansen kun har en håndfuld brugere: denne guide klarer sig uden.
Diskforbruget følger mest dine vedhæftede filer og projektbaggrunde, der gemmes i mappen files, som standard højst 20 MB pr. fil. På en Managed VPS fortæller du os om dit team, antallet af brugere og hvor meget det bruger vedhæftede filer, så anbefaler vi den rette størrelse.
Dokumentationen installerer Vikunja og PostgreSQL med Docker Compose. På en server, hvor Docker er installeret, opretter du en mappe og genererer først instansens hemmelighed, en tilfældig værdi, som du indsætter i filen:
openssl rand -hex 32
Læg derefter denne docker-compose.yml i mappen, hentet fra dokumentationens PostgreSQL-eksempel. Erstat tasks.example.com med dit domænenavn, paste-your-secret-here med den genererede værdi og changeme med en stærk adgangskode, den samme begge steder:
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 kører som bruger 1000: opret mappen files og overdrag den til denne bruger før første start, som dokumentationen beder om, og start derefter tjenesterne:
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja
Ved første start opretter Vikunja sin database og kører alle sine migreringer. Linjen http server started on [::]:3456 i loggene betyder, at den er klar, og curl http://127.0.0.1:3456/api/v1/info, kørt på serveren, returnerer dens version og offentlige indstillinger.
127.0.0.1: her afviger vi fra dokumentationens eksempler, der publicerer porten på alle adresser. Dens tjekliste til sikkerhedshærdning beder om, at kun reverse proxyen kan nå Vikunja: brugerfladen åbner så gennem den, over HTTPS.VIKUNJA_SERVICE_PUBLICURL: den HTTPS-adresse, dine brugere åbner, med den afsluttende skråstreg. Vikunja bruger den til at bygge sine links, for eksempel i e-mails, og som tilladt CORS-oprindelse, der er slået til som standard: denne indstilling er derfor påkrævet. En forkert adresse, for eksempel en manglende port, viser sig som en fejl ”unauthorized”, når du opretter den første konto.VIKUNJA_SERVICE_SECRET signerer sessionstokens. Står den tom, trækkes den tilfældigt ved hver start, og hver genstart logger så alle brugere ud.2.8.0 fastlåser versionen, som dokumentationen anbefaler, så opdateringer sker, når du beslutter det. latest følger den nyeste stabile version, og unstable udviklingsversionerne.files og db gemmer vedhæftede filer og PostgreSQL-data på serveren: det er dem, du tager backup af.scratch. docker exec ind i en shell virker ikke, og variablerne PUID og PGID fra andre images har ingen effekt på det. Fejl læses med docker compose logs vikunja.Til en håndfuld brugere tilbyder dokumentationen SQLite: fjern tjenesten db, blokken depends_on og variablerne VIKUNJA_DATABASE_*, og montér en mappe på /db, hvor imaget allerede gemmer vikunja.db. Opret den og overdrag den til bruger 1000, ligesom files:
volumes:
- ./files:/app/vikunja/files
- ./db:/db
Siden version 2.4.0 udgiver Vikunja et pakkearkiv til Debian og Ubuntu, til amd64, arm64 og armhf, signeret med dens GPG-nøgle:
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
Pakken installerer Vikunja i /opt/vikunja, med SQLite som standard, og en systemd-tjeneste, der er aktiveret, men endnu ikke startet. Den skriver også en tilfældig hemmelighed i et afsnit service i /etc/vikunja/config.yml: udfyld det samme afsnit, og start derefter tjenesten.
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 opretter ingen konto som standard. Når HTTPS er på plads, åbner du https://tasks.example.com/ og registrerer dig: det er din første konto. Registrering er som standard åben, for alle, der når adressen; når dit teams konti findes, foreslår dokumentationen at lukke den. Tilføj denne linje til variablerne for tjenesten vikunja, og kør derefter docker compose up -d igen:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
Yderligere konti administreres fra kommandolinjen. Da imaget ikke har nogen shell, kalder du dens binære fil direkte:
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 spørger efter adgangskoden, når flaget -p ikke angiver den, så den holdes ude af din terminalhistorik.user reset-password sender et link til nulstilling pr. e-mail eller erstatter adgangskoden direkte med --direct, ud fra det ID, som user list viser.user change-status deaktiverer en konto eller genaktiverer den, med --disable eller --enable.doctor kontrollerer konfigurationen, den offentlige URL, hemmeligheden, databasen, skriveadgangen til files og, når den er slået til, SMTP-serveren.VIKUNJA_SERVICE_TIMEZONE er som standard GMT og forventer et navn fra tz-databasen, for eksempel Europe/Paris, aldrig en UTC-forskydning. Den bruges som brugernes standardtidszone og bestemmer dermed tidspunktet for deres påmindelser.Vikunja leverer almindelig HTTP. Dokumentationen afslutter HTTPS i en reverse proxy, så adgangskoder og tokens aldrig sendes ukrypteret: den lytter på port 80 og 443, henter certifikatet og videresender til Vikunja på 127.0.0.1:3456.
Bag en proxy ser Vikunja som standard proxyens adresse ved hver anmodning: logge og hastighedsbegrænsning rammer så alle på én gang. Indstillingen VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, der allerede står i Compose-filen, får den til at læse headeren X-Forwarded-For. Den stoler kun på denne header ved anmodninger fra loopback-adresser og adresser på private netværk, Dockers netværk inkluderet: med porten publiceret på 127.0.0.1 er det kun din proxy, der kommer dertil.
Her er dokumentationens Caddyfile. Caddy henter selv et certifikat fra Let’s Encrypt til det angivne navn, sender headeren X-Forwarded-For videre og lukker WebSocket-forbindelser igennem:
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
Dokumentationens blok består af en linje proxy_pass og en uploadstørrelse. Denne blok bygger videre på den med to tilføjelser: headeren X-Forwarded-For, som Vikunja læser, og WebSocket-headerne. Brugerfladen i version 2.8.0 åbner en WebSocket-forbindelse på /api/v2/ws til sine live-opdateringer; når den fejler, falder dens notifikationer tilbage på en forespørgsel hvert 10. sekund. Tilføj først denne blok map til afsnittet http i /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Derefter denne serverblok, på port 80, så Certbot kan sætte HTTPS op:
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 svarer til den maksimale filstørrelse i Vikunja, som standard 20 MB. Hvis du hæver den med VIKUNJA_FILES_MAXSIZE, beder dokumentationen dig om også at hæve denne linje.
Næsten hver nøgle i filen config.yml har sin miljøvariabel: service.enablecaldav bliver til VIKUNJA_SERVICE_ENABLECALDAV. Når en indstilling er sat begge steder, vinder variablen. Dokumentationens tjekliste til sikkerhedshærdning gennemgår de funktioner, du kan slå fra, hvis du ikke har brug for dem:
| Nøgle | Standard | Slå fra for at |
|---|---|---|
service.enablelinksharing | true | Forhindre deling af projekter via offentlige links |
service.enablecaldav | true | Fjerne CalDAV-endepunktet, der accepterer HTTP basic auth |
webhooks.enabled | true | Forhindre Vikunja i at sende anmodninger til adresser, som brugerne vælger |
service.enabletaskattachments | true | Forhindre upload af filer til opgaver |
service.enableuserdeletion | true | Forhindre brugere i at slette deres egen konto |
plugins.enabled | false | Allerede slået fra: holde tredjepartskode ude af Vikunja |
Siden 2.8.0 ignorerer søgningen accenter på PostgreSQL, når udvidelsen unaccent er aktiv: ”cafe” finder også ”café”. Det officielle PostgreSQL-image leveres med den; aktivér den i Vikunja-databasen, og genstart derefter Vikunja. Loggen viser så 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
Hver bruger importerer opgaver fra fanen ”Import” i sine indstillinger og kan også eksportere alle sine data dér som et zip-arkiv. Filimporterne, Vikunja-arkiv, CSV, TickTick og WeKan, samt importen fra en Planka-instans er altid tilgængelige. Todoist, Trello og Microsoft To Do går via OAuth: de er slået fra som standard og aktiveres i afsnittet migration i konfigurationen, med legitimationsoplysningerne for den app, der er oprettet hos hver tjeneste. OAuth-omdirigeringen sker i browseren: instansen behøver ikke at kunne nås af disse tjenester, men service.publicurl skal være korrekt.
CalDAV synkroniserer opgaverne med dine apps, med forbindelsesoplysningerne på fanen CalDAV i indstillingerne. Dokumentationen præsenterer denne integration som en alfa, der fungerer godt med nogle klienter: afprøv din, før du gør den til hele teamets værktøj. På iPhone og iPad bliver hvert projekt en liste i appen Påmindelser. En konto med totrinsgodkendelse forbinder sig med et dedikeret CalDAV-token.
Vikunja sender e-mails til påmindelser om opgaver, bekræftelse af nye konti og nulstilling af adgangskoder. Afsendelse er slået fra som standard: konti er så aktive, så snart de er oprettet, og nulstilling af adgangskode pr. e-mail er ikke mulig. Når afsendelse er slået til, bekræfter hver ny lokal konto sin adresse før brug.
Fra en Simafri-VPS sætter du en godkendt SMTP-server op, på port 587 eller 465: den fra din afsendelsestjeneste eller din e-mailudbyder. Tilføj disse variabler til tjenesten 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", som kræver TLS fra forbindelsens start og afviser ukrypterede forbindelser.plain som standard, login eller cram-md5 med VIKUNJA_MAILER_AUTHTYPE, afhængigt af din server.Kør docker compose up -d igen, og send derefter en testbesked. Kommandoen kontrollerer forbindelsen med en SMTP-kommando NOOP, som nogle minimale relæer ikke understøtter: foretræk en fuldgyldig SMTP-server.
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com
Dokumentationen nævner to dele, der skal sikkerhedskopieres sammen: databasen og mappen med vedhæftede filer. Siden 2.8.0 ligger slettede opgaver og projekter først 30 dage i papirkurven; når den tid er gået, eller papirkurven er tømt, er det kun en backup, der bringer dem tilbage.
| Element | Hvad det indeholder | Sådan kopieres det |
|---|---|---|
| PostgreSQL-databasen | Konti, projekter, opgaver, kommentarer og indstillinger | pg_dump, uden at stoppe Vikunja |
files | Vedhæftede filer, avatarer og projektbaggrunde | En kopi af mappen |
Med SQLite, db/vikunja.db | Hele databasen | En kopi af filen, med Vikunja stoppet |
docker-compose.yml | Hemmeligheden, den offentlige URL og adgangskoderne | Opbevaret for sig, som en hemmelighed |
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files
Dokumentationen beder om krypterede backups, der opbevares uden for serveren, og om gendannelser, der testes regelmæssigt: log ind på en separat instans og åbn en opgave med en vedhæftet fil. Ligger disse arkiver på serverens disk, indgår de også i dens natlige backup.
Kommandoen vikunja dump samler konfigurationen, databasen og alle filer i et zip-arkiv, og vikunja restore indlæser det igen. Arkivet indeholder konfigurationsfilen og hver variabel VIKUNJA_* i klartekst: kryptér det og beskyt det som selve databasen.
På en ny installation, med den samme docker-compose.yml, indlæser du eksporten i den stadig tomme database før Vikunjas første start og lægger derefter mappen files tilbage på plads:
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 kører sine databasemigreringer af sig selv, når en ny version starter. Dokumentationen beder derfor om en backup før hver opdatering, så du kan vende tilbage til den tidligere tilstand, og om at læse udgivelsesnoterne, der gør opmærksom på eventuelle manuelle trin.
files.docker-compose.yml, for eksempel fra 2.8.0 til den næste version.docker compose pull
docker compose up -d
Med Debian-pakken erstatter sudo apt update && sudo apt upgrade den binære fil og genstarter tjenesten. Det fungerer at skifte fra en stabil version til buildene unstable, men dokumentationen fraråder at gå tilbage: vent i stedet på den næste stabile version.
Sikkerhedsrettelser udgives som GitHub-sikkerhedsmeddelelser og annonceres i udgivelsesnoterne. Version 2.8.0 af 5. november 2026 retter nitten af dem, og dens annoncering beder dig om at opdatere hurtigst muligt. For at få besked kan du følge udgivelserne i GitHub-repositoryet eller changelogens RSS-feed.
Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; Vikunja forbliver din software, med dens indstillinger, dine projekter og dine opgaver.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Gennemlæsning af din instans' logfiler |
| Vikunja | Proaktiv opfølgning: fejl, langsomme svartider og diskplads opdages, og en rettelse anbefales | Installation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Konti og projekter | Den server, der bærer dem, overvåget og sikkerhedskopieret | Dit teams konti, registreringen, delingerne og rettighederne |
| En server, der når din SMTP-server på port 587 eller 465 | Din afsendelsestjeneste og dens legitimationsoplysninger | |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | Dine eksporter af databasen og mappen files, og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet for omlægningen |
Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.
Med en Managed VPS fra Simafri holder vores teams serveren bag din Vikunja-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.
Ja. Vikunja er under AGPL-3.0-licensen: du kan bruge den i virksomheden uden at købe en licens. Hvis du ændrer den, skal dine fjernbrugere kunne få kildekoden til din version. Tilbage står prisen på den server, den kører på.
SQLite, der følger med imaget, er nok til en håndfuld brugere. Derudover anbefaler dokumentationen PostgreSQL eller MySQL. PostgreSQL er databasen i dens Docker-eksempler, og siden 2.8.0 ignorerer søgningen accenter med udvidelsen unaccent.
Opret en docker-compose.yml med imagene vikunja/vikunja:2.8.0 og postgres:18, port 3456 publiceret på 127.0.0.1, en mappe files overdraget til bruger 1000, den offentlige URL og hemmeligheden, og kør derefter docker compose up -d. Sæt så en reverse proxy med HTTPS foran port 3456.
service.publicurl er din instans' HTTPS-adresse: Vikunja bygger sine links og sin CORS-oprindelse ud fra den, deraf en fejl unauthorized, når den er forkert. service.secret signerer sessionerne; står den tom, skifter den ved hver start og logger alle brugere ud.
Vikunja har ingen standardkonto: registrér dig på din instans. Luk derefter for registrering ved at sætte VIKUNJA_SERVICE_ENABLEREGISTRATION til false, og opret de næste konti med kommandoen vikunja user create, kørt inde i containeren.
Slå afsendelse til med VIKUNJA_MAILER_ENABLED, og angiv derefter vært, port 587 eller 465, brugernavn, adgangskode og afsenderadresse for din SMTP-server. Uden e-mail er konti aktive, så snart de er oprettet, og adgangskoder nulstilles fra kommandolinjen.
Tag backup af databasen, med pg_dump for PostgreSQL, og mappen files med vedhæftede filer sammen. Opbevar kopierne krypteret og uden for serveren, tag en før hver opdatering og test gendannelsen af dem regelmæssigt.
En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.