Hosta Vikunja på en Managed VPS: dina uppgifter och projekt på din egen server

Att hosta Vikunja på en Managed VPS innebär att du har ditt teams uppgifter och projekt på en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. Vikunja är fri programvara under AGPL-3.0-licensen. Den här guiden följer den officiella dokumentationen: valet av databas, installation med Docker Compose, den publika adressen och hemligheten, kontona, HTTPS, Vikunjas egna inställningar, e-post, säkerhetskopior och uppdateringar.

Simon Vasconcelos Lee Av Publicerad den 19 november 2026Lästid: 13 minuter

Alla guider

I korthet

  1. AGPL-3.0-licensen låter dig använda Vikunja i företaget utan att köpa någon licens; om du ändrar programmet måste dina användare på distans kunna få källkoden till din version.
  2. Installera med Docker Compose: avbilden vikunja/vikunja:2.8.0 och PostgreSQL, med port 3456 publicerad på 127.0.0.1 bakom en omvänd proxy med HTTPS.
  3. Två inställningar ska finnas på plats från början: service.publicurl, din instans HTTPS-adress, och service.secret, som signerar sessionerna.
  4. Vikunja har inget standardkonto: skapa ditt eget, stäng sedan registreringen och lägg till nästa konton från kommandoraden.
  5. Säkerhetskopiera databasen och mappen files tillsammans, före varje uppdatering; databasmigreringarna körs av sig själva vid start.

Det Vikunja gör

Vikunja är en självhostad uppgifts- och projekthanterare med öppen källkod, som dess repository beskriver som ”uppgiftshanteraren du faktiskt äger”. API:t, skrivet i Go, och webbgränssnittet levereras i en enda binärfil, eller en enda Docker-avbild: det finns bara en sak att installera.

Det som AGPL-3.0-licensen tillåter

Vikunja ges ut under GNU AGPL version 3 eller senare, utom mappen desktop/ i dess repository, skrivbordsappen, som omfattas av GPL version 3 eller senare. Du kan använda den, även i företaget, för ditt team såväl som för dina kunder, utan att köpa någon licens. Kvar blir kostnaden för servern som kör den.

Paragraf 13 lägger till ett villkor som är specifikt för AGPL: om du ändrar programmet måste din version på ett tydligt sätt erbjuda alla som interagerar med den på distans, via ett nätverk, möjligheten att få dess källkod kostnadsfritt. Om du distribuerar kopior gäller dessutom licensens skyldigheter att dela källkoden. Att köra Vikunja utan att ändra den utlöser inte denna paragraf.

Den här guiden installerar den utgåvan med öppen källkod, som dokumentationen beskriver som fullt fungerande i sig själv. Vikunja Pro, en valfri licens, lägger till en administrationspanel, tidrapportering och granskningsloggar för organisationer.

Resurser och databas

Vikunja körs på SQLite, PostgreSQL, MySQL eller MariaDB. Dokumentationen anger inga siffror för minne eller processor; den styr valet av databas efter antalet användare:

DatabasDet dokumentationen sägerVersion testad i CI
SQLiteIngår i binärfilen och i Docker-avbilden, inget att installera. Bortom en handfull användare rekommenderar dokumentationen MySQL eller PostgreSQL.Den medföljande
PostgreSQLDatabasen i dokumentationens Docker-exempel. Sedan 2.8.0 ignorerar sökningen accenter med tillägget unaccent.18
MySQL, MariaDBMinst MySQL 8.0, eftersom 5.7 inte stöds. För icke-latinska tecken måste databasen använda utf8mb4.MySQL 8, MariaDB 12

Dokumentationen rekommenderar en databasversion som fortfarande underhålls. Redis kan fungera som cache, men den påpekar att du troligen inte behöver det så länge instansen bara har en handfull användare: den här guiden klarar sig utan.

Diskanvändningen följer främst dina bilagor och projektbakgrunder, som lagras i mappen files, som standard högst 20 MB per fil. På en Managed VPS berättar du för oss om ditt team, antalet användare och hur mycket det använder bilagor, så rekommenderar vi rätt storlek.

Installationen med Docker Compose

Dokumentationen installerar Vikunja och PostgreSQL med Docker Compose. På en server där Docker är installerat skapar du en mapp och genererar först instansens hemlighet, ett slumpmässigt värde som du klistrar in i filen:

Terminal
openssl rand -hex 32

Lägg sedan denna docker-compose.yml i mappen, hämtad från dokumentationens PostgreSQL-exempel. Ersätt tasks.example.com med ditt domännamn, paste-your-secret-here med värdet du genererade och changeme med ett starkt lösenord, samma på båda ställena:

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örs som användare 1000: skapa mappen files och överlämna den till denna användare före första starten, som dokumentationen ber om, och starta sedan tjänsterna:

Terminal, i mappen med docker-compose.yml
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja

Vid första starten skapar Vikunja sin databas och kör alla sina migreringar. Raden http server started on [::]:3456 i loggarna betyder att den är redo, och curl http://127.0.0.1:3456/api/v1/info, kört på servern, returnerar dess version och publika inställningar.

Med SQLite

För en handfull användare erbjuder dokumentationen SQLite: ta bort tjänsten db, blocket depends_on och variablerna VIKUNJA_DATABASE_*, och montera en mapp på /db, där avbilden redan lagrar vikunja.db. Skapa den och överlämna den till användare 1000, precis som files:

docker-compose.yml, tjänsten vikunja
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db

Utan Docker: Debian-paketet

Sedan version 2.4.0 publicerar Vikunja ett paketförråd för Debian och Ubuntu, för amd64, arm64 och armhf, signerat med dess GPG-nyckel:

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

Paketet installerar Vikunja i /opt/vikunja, med SQLite som standard, och en systemd-tjänst som är aktiverad men ännu inte startad. Det skriver också en slumpmässig hemlighet i en sektion service i /etc/vikunja/config.yml: komplettera samma sektion och starta sedan tjänsten.

/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

Det första kontot och registreringen

Vikunja skapar inget konto som standard. När HTTPS är på plats öppnar du https://tasks.example.com/ och registrerar dig: det är ditt första konto. Registreringen är öppen som standard, för alla som når adressen; när ditt teams konton finns föreslår dokumentationen att stänga den. Lägg till den här raden bland variablerna för tjänsten vikunja och kör sedan docker compose up -d igen:

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

Ytterligare konton hanteras från kommandoraden. Eftersom avbilden saknar skal anropar du dess binärfil direkt:

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

Kontonas säkerhet

HTTPS: den omvända proxyn

Vikunja serverar vanlig HTTP. Dokumentationen avslutar HTTPS i en omvänd proxy, så att lösenord och token aldrig färdas okrypterade: den lyssnar på portarna 80 och 443, hämtar certifikatet och vidarebefordrar till Vikunja på 127.0.0.1:3456.

Bakom en proxy ser Vikunja som standard proxyns adress vid varje begäran: loggar och hastighetsbegränsning träffar då alla på en gång. Inställningen VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, som redan finns i Compose-filen, får den att läsa headern X-Forwarded-For. Den litar bara på den headern vid begäranden från loopback-adresser och adresser i privata nätverk, Dockers nätverk inräknat: med porten publicerad på 127.0.0.1 är det bara din proxy som kommer dit.

Med Caddy

Här är dokumentationens Caddyfile. Caddy hämtar på egen hand ett certifikat från Let’s Encrypt för det angivna namnet, skickar vidare headern X-Forwarded-For och släpper igenom WebSocket-anslutningar:

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

Med Nginx

Dokumentationens block består av en rad proxy_pass och en uppladdningsstorlek. Det här blocket bygger vidare på det med två tillägg: headern X-Forwarded-For, som Vikunja läser, och WebSocket-headrarna. Gränssnittet i version 2.8.0 öppnar en WebSocket-anslutning på /api/v2/ws för sina liveuppdateringar; när den misslyckas faller dess aviseringar tillbaka på en kontroll var 10:e sekund. Lägg först till detta block map i sektionen http i /etc/nginx/nginx.conf:

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

Sedan detta serverblock, på port 80, så att Certbot kan ställa in HTTPS:

Nginx-block
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 motsvarar den största filstorleken i Vikunja, som standard 20 MB. Om du höjer den med VIKUNJA_FILES_MAXSIZE ber dokumentationen dig att höja även den här raden.

Vikunjas egna inställningar

Nästan varje nyckel i filen config.yml har sin miljövariabel: service.enablecaldav blir VIKUNJA_SERVICE_ENABLECALDAV. När ett alternativ är satt på båda ställena vinner variabeln. Dokumentationens checklista för säkerhetshärdning går igenom de funktioner du kan stänga av om du inte har nytta av dem:

NyckelStandardStäng av för att
service.enablelinksharingtrueFörhindra delning av projekt via offentliga länkar
service.enablecaldavtrueTa bort CalDAV-slutpunkten, som accepterar HTTP basic auth
webhooks.enabledtrueHindra Vikunja från att skicka begäranden till adresser som användarna väljer
service.enabletaskattachmentstrueFörhindra uppladdning av filer till uppgifter
service.enableuserdeletiontrueHindra användare från att ta bort sina egna konton
plugins.enabledfalseRedan avstängt: hålla kod från tredje part borta från Vikunja

Sökning utan accenter på PostgreSQL

Sedan 2.8.0 ignorerar sökningen accenter på PostgreSQL när tillägget unaccent är aktivt: ”cafe” hittar också ”café”. Den officiella PostgreSQL-avbilden levereras med det; aktivera det i Vikunjas databas och starta sedan om Vikunja. Loggen visar då 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

Importera dina uppgifter

Varje användare importerar uppgifter från fliken ”Import” i sina inställningar och kan där också exportera alla sina data som ett zip-arkiv. Filimporterna, Vikunja-arkiv, CSV, TickTick och WeKan, liksom importen från en Planka-instans, är alltid tillgängliga. Todoist, Trello och Microsoft To Do går via OAuth: de är avstängda som standard och aktiveras i sektionen migration i konfigurationen, med inloggningsuppgifterna för den app som skapats hos varje tjänst. OAuth-omdirigeringen sker i webbläsaren: instansen behöver inte kunna nås av de tjänsterna, men service.publicurl måste vara korrekt.

CalDAV

CalDAV synkroniserar uppgifterna med dina appar, med anslutningsuppgifterna på fliken CalDAV i inställningarna. Dokumentationen presenterar den här integrationen som en alfaversion som fungerar bra med vissa klienter: prova din innan du gör den till hela teamets verktyg. På iPhone och iPad blir varje projekt en lista i appen Påminnelser. Ett konto med tvåfaktorsautentisering ansluter med en egen CalDAV-token.

E-post: påminnelser, bekräftelser och lösenord

Vikunja skickar e-post för påminnelser om uppgifter, bekräftelse av nya konton och återställning av lösenord. Utskicket är avstängt som standard: konton är då aktiva så snart de har skapats, och lösenordsåterställning via e-post är inte möjlig. När utskicket är påslaget bekräftar varje nytt lokalt konto sin adress före användning.

Från en Simafri-VPS ställer du in en autentiserad SMTP-server, på port 587 eller 465: den från din utskickstjänst eller din e-postleverantör. Lägg till dessa variabler i tjänsten 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 och skicka sedan ett testmeddelande. Kommandot kontrollerar anslutningen med ett SMTP-kommando NOOP, som vissa minimala reläer inte stöder: välj hellre en fullständig SMTP-server.

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

Säkerhetskopiorna

Dokumentationen räknar två delar att säkerhetskopiera tillsammans: databasen och mappen med bilagor. Sedan 2.8.0 hamnar borttagna uppgifter och projekt först i papperskorgen i 30 dagar; när den tiden har gått eller papperskorgen har tömts är det bara en säkerhetskopia som kan få tillbaka dem.

DelVad den innehållerHur den kopieras
PostgreSQL-databasenKonton, projekt, uppgifter, kommentarer och inställningarpg_dump, utan att stoppa Vikunja
filesBilagor, avatarer och projektbakgrunderEn kopia av mappen
Med SQLite, db/vikunja.dbHela databasenEn kopia av filen, med Vikunja stoppat
docker-compose.ymlHemligheten, den publika URL:en och lösenordenFörvarad separat, som en hemlighet
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 ber om krypterade säkerhetskopior som förvaras utanför servern, och om återställningar som testas regelbundet: logga in på en separat instans och öppna en uppgift med en bilaga. Ligger arkiven kvar på serverns disk ingår de också i dess nattliga säkerhetskopior.

Kommandot vikunja dump samlar konfigurationen, databasen och alla filer i ett zip-arkiv, och vikunja restore läser in det igen. Arkivet innehåller konfigurationsfilen och varje variabel VIKUNJA_* i klartext: kryptera det och skydda det som själva databasen.

Återställa

På en ny installation, med samma docker-compose.yml, läser du in exporten i den ännu tomma databasen före Vikunjas första start, och lägger sedan tillbaka mappen files på sin plats:

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

Uppdateringarna

Vikunja kör sina databasmigreringar av sig själv när en ny version startar. Dokumentationen ber därför om en säkerhetskopia före varje uppdatering, så att du kan återgå till det tidigare läget, och om att läsa versionsanteckningarna, som pekar ut eventuella manuella steg.

  1. Läs anteckningarna för den nya versionen.
  2. Exportera databasen och kopiera mappen files.
  3. Ändra avbildens tagg i docker-compose.yml, till exempel från 2.8.0 till nästa version.
  4. Hämta den nya avbilden och starta om tjänsten.
Terminal
docker compose pull
docker compose up -d

Med Debian-paketet ersätter sudo apt update && sudo apt upgrade binärfilen och startar om tjänsten. Att gå från en stabil version till byggena unstable fungerar, men dokumentationen avråder från att gå tillbaka: vänta i stället på nästa stabila version.

Säkerhetsrättelser publiceras som säkerhetsmeddelanden på GitHub och tillkännages i versionsanteckningarna. Version 2.8.0 från den 5 november 2026 rättar nitton av dem, och dess tillkännagivande ber dig uppdatera så snart du kan. För att få besked kan du bevaka utgåvorna i GitHub-förrådet eller följa ändringsloggens RSS-flöde.

Vem gör vad på en Managed VPS

Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; Vikunja förblir din programvara, med sina inställningar, dina projekt och dina uppgifter.

OmrådeVåra teamDu
ServernUppdateringar av system och säkerhet, ingrepp på servern inräknadeTidpunkten som passar din verksamhet
ÖvervakningenServern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtalLäsningen av din instans loggar
VikunjaProaktiv uppföljning: fel, långsamma svarstider och diskutrymme upptäcks, med rekommenderad rättelseInstallationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent
Kontona och projektenServern som bär dem, övervakad och säkerhetskopieradDitt teams konton, registreringen, delningarna och behörigheterna
E-postenEn server som når din SMTP-server på port 587 eller 465Din utskickstjänst och dess inloggningsuppgifter
SäkerhetskopiornaVarje natt, krypterade och förvarade utanför maskinen; återställning ingårDina exporter av databasen och mappen files, och begäran om återställning, när du behöver den
MigreringenDin nuvarande server migreras kostnadsfrittTidpunkten för bytet

Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.

Vikunja, på en server som sköts åt dig

Med en Managed VPS från Simafri håller våra team servern för din Vikunja-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.

Upptäck Managed VPS

Vanliga frågor

Är Vikunja gratis för ett företag?

Ja. Vikunja omfattas av AGPL-3.0-licensen: du kan använda den i företaget utan att köpa någon licens. Om du ändrar den måste dina användare på distans kunna få källkoden till din version. Kvar blir kostnaden för servern som kör den.

Vilken databas ska jag välja för Vikunja?

SQLite, som ingår i avbilden, räcker för en handfull användare. Utöver det rekommenderar dokumentationen PostgreSQL eller MySQL. PostgreSQL är databasen i dess Docker-exempel, och sedan 2.8.0 ignorerar sökningen accenter med tillägget unaccent.

Hur installerar jag Vikunja med Docker Compose?

Skapa en docker-compose.yml med avbilderna vikunja/vikunja:2.8.0 och postgres:18, port 3456 publicerad på 127.0.0.1, en mapp files överlämnad till användare 1000, den publika URL:en och hemligheten, och kör sedan docker compose up -d. Ställ därefter en omvänd proxy med HTTPS framför port 3456.

Vad används service.publicurl och service.secret till?

service.publicurl är din instans HTTPS-adress: Vikunja bygger sina länkar och sitt CORS-ursprung med den, därav felet unauthorized när den är fel. service.secret signerar sessionerna; lämnas den tom ändras den vid varje start och loggar ut alla användare.

Hur skapar jag det första Vikunja-kontot?

Vikunja har inget standardkonto: registrera dig på din instans. Stäng sedan registreringen genom att sätta VIKUNJA_SERVICE_ENABLEREGISTRATION till false, och skapa nästa konton med kommandot vikunja user create, kört inne i containern.

Hur ställer jag in e-post i Vikunja?

Slå på utskicket med VIKUNJA_MAILER_ENABLED och ange sedan värd, port 587 eller 465, användarnamn, lösenord och avsändaradress för din SMTP-server. Utan e-post är konton aktiva så snart de har skapats, och lösenord återställs från kommandoraden.

Hur säkerhetskopierar jag Vikunja?

Säkerhetskopiera databasen, med pg_dump för PostgreSQL, och mappen files med bilagorna tillsammans. Förvara kopiorna krypterade och utanför servern, ta en före varje uppdatering och testa att återställa dem regelbundet.

Täcker en Managed VPS Vikunja?

En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.

Källor och officiell dokumentation

Kontakta oss