Hoste Vikunja på en Managed VPS: dine opgaver og projekter på din egen server

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.

Simon Vasconcelos Lee Af Udgivet den 19. november 2026Læsetid: 13 minutter

Alle guider

Det vigtigste

  1. AGPL-3.0-licensen lader dig bruge Vikunja i virksomheden uden at købe en licens; hvis du ændrer programmet, skal dine fjernbrugere kunne få kildekoden til din version.
  2. Installér med Docker Compose: imaget vikunja/vikunja:2.8.0 og PostgreSQL, med port 3456 publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.
  3. To indstillinger skal på plads fra starten: service.publicurl, din instans' HTTPS-adresse, og service.secret, som signerer sessionerne.
  4. Vikunja har ingen standardkonto: opret din egen, luk derefter for registrering og tilføj de næste konti fra kommandolinjen.
  5. Tag backup af databasen og mappen files sammen, før hver opdatering; databasemigreringerne kører af sig selv ved opstart.

Hvad Vikunja gør

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.

Hvad AGPL-3.0-licensen tillader

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.

Ressourcer og database

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:

DatabaseHvad dokumentationen sigerVersion testet i CI
SQLiteFø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
PostgreSQLDatabasen i dokumentationens Docker-eksempler. Siden 2.8.0 ignorerer søgningen accenter med udvidelsen unaccent.18
MySQL, MariaDBMindst 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.

Installation med Docker Compose

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:

Terminal
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:

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 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:

Terminal, i mappen med docker-compose.yml
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.

Med SQLite

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:

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

Uden Docker: Debian-pakken

Siden version 2.4.0 udgiver Vikunja et pakkearkiv til Debian og Ubuntu, til amd64, arm64 og armhf, signeret med dens GPG-nøgle:

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

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.

/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

Den første konto og registrering

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:

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

Yderligere konti administreres fra kommandolinjen. Da imaget ikke har nogen shell, kalder du dens binære fil direkte:

Terminal, i mappen med 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

Kontosikkerhed

HTTPS: reverse proxyen

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.

Med Caddy

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:

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

Med Nginx

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:

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

Derefter denne serverblok, på port 80, så Certbot kan sætte HTTPS op:

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

Vikunjas egne indstillinger

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øgleStandardSlå fra for at
service.enablelinksharingtrueForhindre deling af projekter via offentlige links
service.enablecaldavtrueFjerne CalDAV-endepunktet, der accepterer HTTP basic auth
webhooks.enabledtrueForhindre Vikunja i at sende anmodninger til adresser, som brugerne vælger
service.enabletaskattachmentstrueForhindre upload af filer til opgaver
service.enableuserdeletiontrueForhindre brugere i at slette deres egen konto
plugins.enabledfalseAllerede slået fra: holde tredjepartskode ude af Vikunja

Søgning uden accenter på PostgreSQL

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.

Terminal, i mappen med docker-compose.yml
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja

Import af dine opgaver

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

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.

E-mail: påmindelser, bekræftelser og adgangskoder

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:

docker-compose.yml, under 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

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.

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

Backup

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.

ElementHvad det indeholderSådan kopieres det
PostgreSQL-databasenKonti, projekter, opgaver, kommentarer og indstillingerpg_dump, uden at stoppe Vikunja
filesVedhæftede filer, avatarer og projektbaggrundeEn kopi af mappen
Med SQLite, db/vikunja.dbHele databasenEn kopi af filen, med Vikunja stoppet
docker-compose.ymlHemmeligheden, den offentlige URL og adgangskoderneOpbevaret for sig, som en hemmelighed
Terminal, i mappen med 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

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.

Gendannelse

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:

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

Opdateringer

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.

  1. Læs noterne til den nye version.
  2. Eksportér databasen og kopiér mappen files.
  3. Ret imagets tag i docker-compose.yml, for eksempel fra 2.8.0 til den næste version.
  4. Hent det nye image og genstart tjenesten.
Terminal
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.

Hvem gør hvad på en Managed VPS

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.

EmneVores teamsDig
ServerenOpdateringer af system og sikkerhed, indgreb på serveren inkluderetDet tidspunkt, der passer til din drift
OvervågningenServeren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkaldGennemlæsning af din instans' logfiler
VikunjaProaktiv opfølgning: fejl, langsomme svartider og diskplads opdages, og en rettelse anbefalesInstallation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent
Konti og projekterDen server, der bærer dem, overvåget og sikkerhedskopieretDit teams konti, registreringen, delingerne og rettighederne
E-mailEn server, der når din SMTP-server på port 587 eller 465Din afsendelsestjeneste og dens legitimationsoplysninger
BackupHver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderetDine eksporter af databasen og mappen files, og anmodningen om gendannelse, når du får brug for den
MigreringenDin nuværende server flyttes, uden beregningTidspunktet 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.

Vikunja på en server, der passes for dig

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.

Opdag Managed VPS

Ofte stillede spørgsmål

Er Vikunja gratis for en virksomhed?

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å.

Hvilken database skal jeg vælge til Vikunja?

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.

Hvordan installerer jeg Vikunja med Docker Compose?

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.

Hvad bruges service.publicurl og service.secret til?

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.

Hvordan opretter jeg den første Vikunja-konto?

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.

Hvordan sætter jeg e-mail op i Vikunja?

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.

Hvordan tager jeg backup af Vikunja?

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.

Dækker en Managed VPS Vikunja?

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.

Kilder og officiel dokumentation

Kontakt os