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.
Av Simon Vasconcelos Lee
Publicerad den 19 november 2026Lästid: 13 minuter
vikunja/vikunja:2.8.0 och PostgreSQL, med port 3456 publicerad på 127.0.0.1 bakom en omvänd proxy med HTTPS.service.publicurl, din instans HTTPS-adress, och service.secret, som signerar sessionerna.files tillsammans, före varje uppdatering; databasmigreringarna körs av sig själva vid start.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.
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.
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:
| Databas | Det dokumentationen säger | Version testad i CI |
|---|---|---|
| SQLite | Ingår i binärfilen och i Docker-avbilden, inget att installera. Bortom en handfull användare rekommenderar dokumentationen MySQL eller PostgreSQL. | Den medföljande |
| PostgreSQL | Databasen i dokumentationens Docker-exempel. Sedan 2.8.0 ignorerar sökningen accenter med tillägget unaccent. | 18 |
| MySQL, MariaDB | Minst 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.
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:
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:
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:
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.
127.0.0.1: här avviker vi från dokumentationens exempel, som publicerar porten på alla adresser. Dess checklista för säkerhetshärdning ber att bara den omvända proxyn ska kunna nå Vikunja: gränssnittet öppnas då genom den, över HTTPS.VIKUNJA_SERVICE_PUBLICURL: HTTPS-adressen som dina användare öppnar, med det avslutande snedstrecket. Vikunja bygger sina länkar med den, till exempel i e-post, och använder den som tillåtet CORS-ursprung, som är påslaget som standard: den här inställningen är därför obligatorisk. En felaktig adress, till exempel en saknad port, visar sig som felet ”unauthorized” när du skapar det första kontot.VIKUNJA_SERVICE_SECRET signerar sessionstoken. Lämnas den tom dras den slumpmässigt vid varje start, och varje omstart loggar då ut alla användare.2.8.0 låser versionen, som dokumentationen rekommenderar, så att uppdateringar sker när du bestämmer det. latest följer den senaste stabila versionen, och unstable utvecklingsversionerna.files och db behåller bilagorna och PostgreSQL-data på servern: det är dem du säkerhetskopierar.scratch. docker exec in i ett skal fungerar inte, och variablerna PUID och PGID från andra avbilder har ingen effekt på den. Fel läser du med docker compose logs vikunja.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:
volumes:
- ./files:/app/vikunja/files
- ./db:/db
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:
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.
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 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:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
Ytterligare konton hanteras från kommandoraden. Eftersom avbilden saknar skal anropar du dess binärfil direkt:
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 frågar efter lösenordet när flaggan -p inte anger det, vilket håller det borta från din terminalhistorik.user reset-password skickar en länk för återställning via e-post, eller ersätter lösenordet direkt med --direct, utifrån det ID som user list visar.user change-status inaktiverar ett konto eller aktiverar det igen, med --disable eller --enable.doctor kontrollerar konfigurationen, den publika URL:en, hemligheten, databasen, skrivåtkomsten till files och, när den är påslagen, SMTP-servern.VIKUNJA_SERVICE_TIMEZONE är som standard GMT och förväntar sig ett namn från tz-databasen, till exempel Europe/Paris, aldrig en UTC-förskjutning. Den används som användarnas standardtidszon och bestämmer därmed tiden för deras påminnelser.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.
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:
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
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:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Sedan detta serverblock, på port 80, så att Certbot kan ställa in HTTPS:
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 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.
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:
| Nyckel | Standard | Stäng av för att |
|---|---|---|
service.enablelinksharing | true | Förhindra delning av projekt via offentliga länkar |
service.enablecaldav | true | Ta bort CalDAV-slutpunkten, som accepterar HTTP basic auth |
webhooks.enabled | true | Hindra Vikunja från att skicka begäranden till adresser som användarna väljer |
service.enabletaskattachments | true | Förhindra uppladdning av filer till uppgifter |
service.enableuserdeletion | true | Hindra användare från att ta bort sina egna konton |
plugins.enabled | false | Redan avstängt: hålla kod från tredje part borta från Vikunja |
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.
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja
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 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.
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:
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 från anslutningens början och vägrar okrypterade anslutningar.plain som standard, login eller cram-md5 med VIKUNJA_MAILER_AUTHTYPE, beroende på din server.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.
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com
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.
| Del | Vad den innehåller | Hur den kopieras |
|---|---|---|
| PostgreSQL-databasen | Konton, projekt, uppgifter, kommentarer och inställningar | pg_dump, utan att stoppa Vikunja |
files | Bilagor, avatarer och projektbakgrunder | En kopia av mappen |
Med SQLite, db/vikunja.db | Hela databasen | En kopia av filen, med Vikunja stoppat |
docker-compose.yml | Hemligheten, den publika URL:en och lösenorden | Förvarad separat, som en hemlighet |
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.
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:
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ö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.
files.docker-compose.yml, till exempel från 2.8.0 till nästa version.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.
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åde | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Läsningen av din instans loggar |
| Vikunja | Proaktiv uppföljning: fel, långsamma svarstider och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent |
| Kontona och projekten | Servern som bär dem, övervakad och säkerhetskopierad | Ditt teams konton, registreringen, delningarna och behörigheterna |
| E-posten | En server som når din SMTP-server på port 587 eller 465 | Din utskickstjänst och dess inloggningsuppgifter |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | Dina exporter av databasen och mappen files, och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.