Găzduirea Vikunja pe un Managed VPS înseamnă să păstrați sarcinile și proiectele echipei dumneavoastră pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Vikunja este un software liber sub licență AGPL-3.0. Acest ghid urmează documentația sa oficială: alegerea bazei de date, instalarea cu Docker Compose, URL-ul public și secretul, conturile, HTTPS, setările proprii Vikunja, e-mailul, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 19 noiembrie 2026Timp de citire: 13 minute
vikunja/vikunja:2.8.0 și PostgreSQL, cu portul 3456 publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.service.publicurl, adresa HTTPS a instanței dumneavoastră, și service.secret, care semnează sesiunile.files împreună, înainte de fiecare actualizare; migrările bazei de date rulează singure la pornire.Vikunja este un manager open source de sarcini și proiecte, găzduit pe propriul server, pe care depozitul său îl prezintă drept „managerul de sarcini care vă aparține cu adevărat”. API-ul, scris în Go, și interfața web vin într-un singur binar sau într-o singură imagine Docker: există un singur lucru de instalat.
Vikunja este publicat sub GNU AGPL versiunea 3 sau ulterioară, cu excepția directorului desktop/ din depozitul său, aplicația desktop, care este sub GPL versiunea 3 sau ulterioară. Îl puteți folosi, inclusiv în firmă, pentru echipa dumneavoastră ca și pentru clienții dumneavoastră, fără nicio licență de cumpărat. Rămâne costul serverului pe care rulează.
Secțiunea 13 adaugă o condiție proprie AGPL: dacă modificați programul, versiunea dumneavoastră trebuie să ofere vizibil tuturor celor care interacționează cu ea de la distanță, printr-o rețea, posibilitatea de a obține codul ei sursă, gratuit. Dacă distribuiți copii, se aplică și obligațiile licenței privind partajarea codului sursă. Rularea Vikunja fără modificări nu activează această secțiune.
Acest ghid instalează această ediție open source, pe care documentația o prezintă ca fiind complet funcțională de sine stătător. Vikunja Pro, o licență opțională, adaugă pentru organizații un panou de administrare, evidența timpului lucrat și jurnale de audit.
Vikunja funcționează cu SQLite, PostgreSQL, MySQL sau MariaDB. Documentația nu dă nicio cifră pentru memorie sau procesor; ea ghidează alegerea bazei de date după numărul de utilizatori:
| Baza de date | Ce spune documentația | Versiunea testată în integrarea continuă |
|---|---|---|
| SQLite | Inclusă în binar și în imaginea Docker, nimic de instalat. Peste câțiva utilizatori, documentația recomandă MySQL sau PostgreSQL. | Cea inclusă |
| PostgreSQL | Baza de date din exemplele Docker ale documentației. Începând cu 2.8.0, căutarea ignoră diacriticele cu extensia unaccent. | 18 |
| MySQL, MariaDB | Cel puțin MySQL 8.0, deoarece 5.7 nu este suportat. Pentru caracterele non-latine, baza de date trebuie să folosească utf8mb4. | MySQL 8, MariaDB 12 |
Documentația recomandă o versiune a bazei de date care este încă întreținută. Redis poate servi drept cache, dar ea notează că probabil nu veți avea nevoie de el cât timp instanța are doar câțiva utilizatori: acest ghid se lipsește de el.
Spațiul pe disc urmează mai ales atașamentele și fundalurile de proiect, păstrate în directorul files, cu cel mult 20 MB pe fișier în mod implicit. Pe un Managed VPS, spuneți-ne cum arată echipa dumneavoastră, numărul de utilizatori și cât folosește atașamentele, iar noi vă recomandăm dimensiunea potrivită.
Documentația instalează Vikunja și PostgreSQL cu Docker Compose. Pe un server cu Docker instalat, creați un director și generați mai întâi secretul instanței, o valoare aleatorie pe care o veți lipi în fișier:
openssl rand -hex 32
Puneți apoi în director acest docker-compose.yml, preluat din exemplul PostgreSQL al documentației. Înlocuiți tasks.example.com cu numele dumneavoastră de domeniu, paste-your-secret-here cu valoarea generată și changeme cu o parolă puternică, aceeași în ambele locuri:
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 rulează cu utilizatorul 1000: creați directorul files și dați-i-l în proprietate înainte de prima pornire, așa cum cere documentația, apoi porniți serviciile:
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja
La prima pornire, Vikunja își creează baza de date și rulează toate migrările. Linia http server started on [::]:3456 din jurnale arată că este gata, iar curl http://127.0.0.1:3456/api/v1/info, rulat pe server, întoarce versiunea și setările sale publice.
127.0.0.1: aici ne îndepărtăm de exemplele din documentație, care publică portul pe toate adresele. Lista sa de consolidare a securității cere ca doar proxy-ul invers să poată ajunge la Vikunja: interfața se deschide atunci prin el, în HTTPS.VIKUNJA_SERVICE_PUBLICURL: adresa HTTPS pe care o deschid utilizatorii dumneavoastră, cu bara oblică finală. Vikunja o folosește pentru a-și construi linkurile, în e-mailuri de exemplu, și ca origine CORS autorizată, activă implicit: această setare este deci obligatorie. O adresă greșită, căreia îi lipsește portul de exemplu, se vede printr-o eroare „unauthorized” la crearea primului cont.VIKUNJA_SERVICE_SECRET semnează tokenurile de sesiune. Lăsat gol, este generat aleatoriu la fiecare pornire, iar fiecare repornire deconectează atunci toți utilizatorii.2.8.0 fixează versiunea, așa cum recomandă documentația, pentru ca actualizările să aibă loc când decideți dumneavoastră. latest urmărește ultima versiune stabilă, iar unstable compilările de dezvoltare.files și db păstrează pe server atașamentele și datele PostgreSQL: pe ele le salvați.scratch. Un docker exec către un shell nu funcționează, iar variabilele PUID și PGID ale altor imagini nu au niciun efect asupra ei. Erorile se citesc cu docker compose logs vikunja.Pentru câțiva utilizatori, documentația propune SQLite: eliminați serviciul db, blocul depends_on și variabilele VIKUNJA_DATABASE_*, apoi montați un director pe /db, unde imaginea păstrează deja vikunja.db. Creați-l și dați-l în proprietatea utilizatorului 1000, ca pe files:
volumes:
- ./files:/app/vikunja/files
- ./db:/db
Începând cu versiunea 2.4.0, Vikunja publică un depozit de pachete pentru Debian și Ubuntu, pentru amd64, arm64 și armhf, semnat cu cheia sa GPG:
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
Pachetul instalează Vikunja în /opt/vikunja, cu SQLite implicit, și un serviciu systemd activat, dar încă nepornit. El scrie de asemenea un secret aleatoriu într-o secțiune service din /etc/vikunja/config.yml: completați aceeași secțiune, apoi porniți serviciul.
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 nu creează niciun cont implicit. Odată pus la punct HTTPS, deschideți https://tasks.example.com/ și înregistrați-vă: acesta este primul dumneavoastră cont. Înregistrarea este deschisă implicit oricui ajunge la adresă; odată create conturile echipei dumneavoastră, documentația sugerează închiderea ei. Adăugați această linie la variabilele serviciului vikunja, apoi rulați din nou docker compose up -d:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
Conturile următoare se gestionează din linia de comandă. Cum imaginea nu are shell, îi apelați direct binarul:
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 cere parola atunci când opțiunea -p nu o furnizează, ceea ce o ține în afara istoricului terminalului dumneavoastră.user reset-password trimite pe e-mail un link de resetare sau înlocuiește direct parola cu --direct, folosind identificatorul afișat de user list.user change-status dezactivează sau reactivează un cont, cu --disable sau --enable.doctor verifică configurația, URL-ul public, secretul, baza de date, accesul în scriere la files și, dacă este activat, serverul SMTP.VIKUNJA_SERVICE_TIMEZONE are implicit valoarea GMT și așteaptă un nume din baza tz, Europe/Paris de exemplu, niciodată un decalaj față de UTC. El servește drept fus orar implicit al utilizatorilor și stabilește deci ora mementourilor lor.Vikunja servește HTTP necriptat. Documentația încheie HTTPS la un proxy invers, pentru ca parolele și tokenurile să nu circule niciodată necriptate: el ascultă pe porturile 80 și 443, obține certificatul și transmite către Vikunja pe 127.0.0.1:3456.
În spatele unui proxy, Vikunja vede implicit adresa proxy-ului la fiecare cerere: jurnalele și limitele de rată îi vizează atunci pe toți deodată. Setarea VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, deja prezentă în fișierul Compose, îl face să citească antetul X-Forwarded-For. El are încredere în acest antet doar pentru cererile care vin de la adrese de loopback și de rețea privată, inclusiv rețeaua Docker: cu portul publicat pe 127.0.0.1, doar proxy-ul dumneavoastră ajunge acolo.
Iată fișierul Caddyfile din documentație. Caddy obține singur un certificat Let’s Encrypt pentru numele indicat, transmite antetul X-Forwarded-For și lasă să treacă conexiunile WebSocket:
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
Blocul din documentație se reduce la o linie proxy_pass și o dimensiune de încărcare. Blocul de mai jos pornește de la el și adaugă două lucruri: antetul X-Forwarded-For, pe care Vikunja îl citește, și anteturile WebSocket. Interfața versiunii 2.8.0 deschide o conexiune WebSocket pe /api/v2/ws pentru actualizările sale în timp real; când aceasta eșuează, notificările trec la o interogare la fiecare 10 secunde. Adăugați mai întâi acest bloc map în secțiunea http din /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Apoi acest bloc server, pe portul 80, pentru ca Certbot să poată configura 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 corespunde dimensiunii maxime a unui fișier în Vikunja, 20 MB implicit. Dacă o măriți cu VIKUNJA_FILES_MAXSIZE, documentația cere să măriți și această linie.
Aproape fiecare cheie din fișierul config.yml are variabila sa de mediu: service.enablecaldav devine VIKUNJA_SERVICE_ENABLECALDAV. Când o opțiune este definită în ambele locuri, variabila are prioritate. Lista de consolidare a securității din documentație trece în revistă funcțiile de dezactivat dacă nu le folosiți:
| Cheie | Implicit | Dezactivați-o pentru a |
|---|---|---|
service.enablelinksharing | true | Împiedica partajarea proiectelor prin linkuri publice |
service.enablecaldav | true | Elimina punctul de acces CalDAV, care acceptă autentificarea HTTP de bază |
webhooks.enabled | true | Împiedica Vikunja să trimită cereri către adrese alese de utilizatori |
service.enabletaskattachments | true | Împiedica încărcarea de fișiere în sarcini |
service.enableuserdeletion | true | Împiedica utilizatorii să își șteargă propriul cont |
plugins.enabled | false | Deja dezactivată: ține codul terților în afara Vikunja |
Începând cu 2.8.0, căutarea ignoră diacriticele pe PostgreSQL când extensia unaccent este activă: „cafe” găsește și „café”. Imaginea oficială PostgreSQL o include; activați-o în baza de date Vikunja, apoi reporniți Vikunja. Jurnalul afișează atunci 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
Fiecare utilizator își importă sarcinile din fila „Import” a setărilor sale, unde își poate și exporta toate datele într-o arhivă zip. Importurile din fișiere, arhivă Vikunja, CSV, TickTick și WeKan, precum și importul dintr-o instanță Planka, sunt mereu disponibile. Todoist, Trello și Microsoft To Do trec prin OAuth: sunt dezactivate implicit și se activează în secțiunea migration a configurației, cu datele de autentificare ale aplicației create la fiecare serviciu. Redirecționarea OAuth are loc în browser: instanța nu trebuie să fie accesibilă acestor servicii, dar service.publicurl trebuie să fie corect.
CalDAV sincronizează sarcinile cu aplicațiile dumneavoastră, cu datele de conectare din fila CalDAV a setărilor. Documentația prezintă această integrare ca pe o versiune alfa care funcționează bine cu anumiți clienți: testați-l pe al dumneavoastră înainte de a-l face instrumentul întregii echipe. Pe iPhone și iPad, fiecare proiect devine o listă în aplicația Mementouri. Un cont cu autentificare în doi pași se conectează cu un token CalDAV dedicat.
Vikunja trimite e-mailuri pentru mementourile sarcinilor, confirmarea unui cont nou și resetarea parolelor. Trimiterea este dezactivată implicit: conturile sunt atunci active imediat ce sunt create, iar resetarea parolei prin e-mail nu este posibilă. Odată activată trimiterea, fiecare cont local nou își confirmă adresa înainte de utilizare.
De pe un VPS Simafri, configurați un server SMTP autentificat, pe portul 587 sau 465: cel al serviciului dumneavoastră de trimitere sau al furnizorului dumneavoastră de e-mail. Adăugați aceste variabile la serviciul 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", care impune TLS încă de la începutul conexiunii și refuză conexiunile necriptate.plain implicit, login sau cram-md5 cu VIKUNJA_MAILER_AUTHTYPE, în funcție de serverul dumneavoastră.Rulați din nou docker compose up -d, apoi trimiteți un mesaj de test. Comanda verifică conexiunea cu o comandă SMTP NOOP, pe care unele relee minimale nu o suportă: preferați un server SMTP complet.
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com
Documentația numără două părți de salvat, împreună: baza de date și directorul atașamentelor. Începând cu 2.8.0, sarcinile și proiectele șterse petrec mai întâi 30 de zile în coșul de gunoi; după acest termen sau după golirea coșului, doar un backup le mai poate aduce înapoi.
| Element | Ce păstrează | Cum se copiază |
|---|---|---|
| Baza de date PostgreSQL | Conturile, proiectele, sarcinile, comentariile și setările | pg_dump, fără a opri Vikunja |
files | Atașamentele, avatarurile și fundalurile de proiect | O copie a directorului |
Cu SQLite, db/vikunja.db | Întreaga bază de date | O copie a fișierului, cu Vikunja oprit |
docker-compose.yml | Secretul, URL-ul public și parolele | Păstrat separat, ca un secret |
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files
Documentația cere backupuri criptate și păstrate în afara serverului, precum și restaurări testate regulat: pe o instanță separată, conectați-vă și deschideți o sarcină cu un atașament. Lăsate pe discul serverului, aceste arhive intră și în backupurile sale de noapte.
Comanda vikunja dump adună configurația, baza de date și toate fișierele într-o arhivă zip, iar vikunja restore o încarcă înapoi. Arhiva conține fișierul de configurare și toate variabilele VIKUNJA_* în clar: criptați-o și protejați-o ca pe baza de date însăși.
Pe o instalare nouă, cu același docker-compose.yml, încărcați exportul în baza de date încă goală înainte de prima pornire a Vikunja, apoi puneți la loc directorul files:
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 își rulează singur migrările bazei de date când pornește o versiune nouă. De aceea documentația cere un backup înainte de fiecare actualizare, pentru a putea reveni la starea anterioară, și citirea notelor de versiune, care semnalează eventualii pași manuali.
files.docker-compose.yml, de exemplu de la 2.8.0 la versiunea următoare.docker compose pull
docker compose up -d
Cu pachetul Debian, sudo apt update && sudo apt upgrade înlocuiește binarul și repornește serviciul. Trecerea de la o versiune stabilă la compilările unstable funcționează, dar documentația descurajează întoarcerea: așteptați mai degrabă următoarea versiune stabilă.
Corecturile de securitate sunt publicate ca avize de securitate GitHub și anunțate în notele de versiune. Versiunea 2.8.0 din 5 noiembrie 2026 corectează nouăsprezece dintre ele, iar anunțul ei cere actualizarea cât mai curând. Pentru a fi anunțat, urmăriți versiunile depozitului GitHub sau fluxul RSS al jurnalului de modificări.
Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Vikunja rămâne software-ul dumneavoastră, cu setările sale, proiectele și sarcinile dumneavoastră.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Citirea jurnalelor instanței dumneavoastră |
| Vikunja | Urmărire proactivă: erori, încetiniri și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Conturile și proiectele | Serverul care le poartă, supravegheat și salvat | Conturile echipei dumneavoastră, înregistrarea, partajările și permisiunile |
| E-mailul | Un server care ajunge la serverul dumneavoastră SMTP pe portul 587 sau 465 | Serviciul dumneavoastră de trimitere și datele sale de autentificare |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Exporturile dumneavoastră ale bazei de date și ale directorului files, și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră Vikunja, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. Vikunja este sub licență AGPL-3.0: îl puteți folosi în firmă fără nicio licență de cumpărat. Dacă îl modificați, utilizatorii dumneavoastră de la distanță trebuie să poată obține codul sursă al versiunii dumneavoastră. Rămâne costul serverului pe care rulează.
SQLite, inclusă în imagine, ajunge pentru câțiva utilizatori. Peste acest prag, documentația recomandă PostgreSQL sau MySQL. PostgreSQL este baza de date din exemplele sale Docker, iar începând cu 2.8.0 căutarea sa ignoră diacriticele cu extensia unaccent.
Creați un docker-compose.yml cu imaginile vikunja/vikunja:2.8.0 și postgres:18, portul 3456 publicat pe 127.0.0.1, un director files dat în proprietatea utilizatorului 1000, URL-ul public și secretul, apoi rulați docker compose up -d. Puneți apoi un proxy invers în HTTPS în fața portului 3456.
service.publicurl este adresa HTTPS a instanței dumneavoastră: Vikunja își construiește din ea linkurile și originea CORS, de unde o eroare unauthorized când este greșită. service.secret semnează sesiunile; lăsat gol, se schimbă la fiecare pornire și deconectează toți utilizatorii.
Vikunja nu are niciun cont implicit: înregistrați-vă pe instanța dumneavoastră. Închideți apoi înregistrarea setând VIKUNJA_SERVICE_ENABLEREGISTRATION la false și creați conturile următoare cu comanda vikunja user create, rulată în container.
Activați trimiterea cu VIKUNJA_MAILER_ENABLED, apoi indicați gazda, portul 587 sau 465, numele de utilizator, parola și adresa expeditorului serverului dumneavoastră SMTP. Fără e-mail, conturile sunt active imediat ce sunt create, iar parolele se resetează din linia de comandă.
Salvați împreună baza de date, cu pg_dump pentru PostgreSQL, și directorul files al atașamentelor. Păstrați copiile criptate și în afara serverului, faceți una înainte de fiecare actualizare și testați regulat restaurarea lor.
Un Managed VPS acoperă serverul: sistemul, securitatea, monitorizarea și backupurile. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.