Hostovat Vikunja na Managed VPS znamená mít úkoly a projekty svého týmu na vlastním stroji, který naše týmy udržují aktuální a ve dne i v noci hlídají. Vikunja je svobodný software pod licencí AGPL-3.0. Tento průvodce sleduje její oficiální dokumentaci: volbu databáze, instalaci pomocí Docker Compose, veřejnou adresu URL a tajný klíč, účty, HTTPS, vlastní nastavení Vikunji, e-mail, zálohy a aktualizace.
Autor: Simon Vasconcelos Lee
Publikováno 19. listopadu 2026Doba čtení: 13 minut
vikunja/vikunja:2.8.0 a PostgreSQL, s portem 3456 publikovaným na 127.0.0.1 za reverzní proxy s HTTPS.service.publicurl, adresa HTTPS vaší instance, a service.secret, který podepisuje relace.files společně, před každou aktualizací; migrace databáze se spouštějí samy při startu.Vikunja je open source správce úkolů a projektů pro vlastní hosting, kterého jeho repozitář představuje jako „správce úkolů, který opravdu vlastníte“. API napsané v Go a webové rozhraní se dodávají v jediném binárním souboru, nebo v jediném obrazu Docker: instalujete jen jednu věc.
Vikunja je vydávána pod licencí GNU AGPL verze 3 nebo novější, s výjimkou složky desktop/ v jejím repozitáři, tedy desktopové aplikace, která je pod licencí GPL verze 3 nebo novější. Můžete ji používat, i ve firmě, pro svůj tým i pro své zákazníky, aniž byste kupovali licenci. Zbývají náklady na server, na kterém běží.
Článek 13 přidává podmínku specifickou pro AGPL: pokud program upravíte, musí vaše verze všem, kdo ji používají na dálku přes síť, jasně nabídnout možnost získat její zdrojový kód zdarma. Pokud šíříte kopie, platí také povinnosti licence týkající se sdílení kódu. Provozování Vikunji bez úprav tento článek nespouští.
Tento průvodce instaluje tuto open source edici, kterou dokumentace popisuje jako plně funkční samu o sobě. Vikunja Pro, volitelná licence, přidává pro organizace administrační panel, sledování času a auditní protokoly.
Vikunja běží na SQLite, PostgreSQL, MySQL nebo MariaDB. Dokumentace neuvádí žádné hodnoty pro paměť ani CPU; volbu databáze řídí podle počtu uživatelů:
| Databáze | Co říká dokumentace | Verze testovaná v CI |
|---|---|---|
| SQLite | Je součástí binárního souboru i obrazu Docker, nic se neinstaluje. Nad několik málo uživatelů dokumentace doporučuje MySQL nebo PostgreSQL. | Ta přibalená |
| PostgreSQL | Databáze z příkladů Docker v dokumentaci. Od verze 2.8.0 vyhledávání ignoruje diakritiku díky rozšíření unaccent. | 18 |
| MySQL, MariaDB | Nejméně MySQL 8.0, protože verze 5.7 není podporována. Kvůli nelatinkovým znakům musí databáze používat utf8mb4. | MySQL 8, MariaDB 12 |
Dokumentace doporučuje vydání databáze, které je stále udržované. Redis může sloužit jako mezipaměť, dokumentace ale uvádí, že ho nejspíš potřebovat nebudete, dokud má instance jen několik uživatelů: tento průvodce se bez něj obejde.
Obsazení disku se řídí hlavně vašimi přílohami a pozadími projektů, uloženými ve složce files, ve výchozím nastavení nejvýše 20 MB na soubor. Na Managed VPS nám stačí popsat váš tým, počet uživatelů a to, jak hodně využívá přílohy, a doporučíme vám vhodnou velikost.
Dokumentace instaluje Vikunju a PostgreSQL pomocí Docker Compose. Na serveru s nainstalovaným Dockerem vytvořte složku a nejprve vygenerujte tajný klíč instance, náhodnou hodnotu, kterou vložíte do souboru:
openssl rand -hex 32
Potom do složky umístěte tento docker-compose.yml, převzatý z příkladu s PostgreSQL v dokumentaci. Nahraďte tasks.example.com svým doménovým jménem, paste-your-secret-here vygenerovanou hodnotou a changeme silným heslem, stejným na obou místech:
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 běží jako uživatel 1000: podle pokynu dokumentace vytvořte složku files a před prvním spuštěním ji tomuto uživateli předejte, potom spusťte služby:
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja
Při prvním spuštění Vikunja vytvoří svou databázi a provede všechny migrace. Řádek http server started on [::]:3456 v protokolech znamená, že je připravená, a curl http://127.0.0.1:3456/api/v1/info, spuštěný na serveru, vrátí její verzi a veřejná nastavení.
127.0.0.1: v tomto bodě se odchylujeme od příkladů v dokumentaci, které port publikují na všech adresách. Její kontrolní seznam zabezpečení žádá, aby se k Vikunji dostala jen reverzní proxy: rozhraní se pak otevírá přes ni, přes HTTPS.VIKUNJA_SERVICE_PUBLICURL: adresa HTTPS, kterou otevírají vaši uživatelé, s koncovým lomítkem. Vikunja z ní sestavuje své odkazy, například v e-mailech, a používá ji jako povolený původ CORS, který je ve výchozím stavu zapnutý: toto nastavení je proto povinné. Chybná adresa, třeba s chybějícím portem, se projeví chybou „unauthorized“ při vytváření prvního účtu.VIKUNJA_SERVICE_SECRET podepisuje tokeny relací. Když zůstane prázdný, losuje se při každém startu a každý restart pak odhlásí všechny uživatele.2.8.0 pevně určuje verzi, jak doporučuje dokumentace, takže aktualizace proběhnou, až se rozhodnete vy. latest sleduje nejnovější stabilní vydání a unstable vývojová sestavení.files a db uchovávají přílohy a data PostgreSQL na serveru: právě ty zálohujete.scratch. docker exec do shellu nefunguje a proměnné PUID a PGID známé z jiných obrazů na něj nemají vliv. Chyby se čtou pomocí docker compose logs vikunja.Pro několik málo uživatelů dokumentace nabízí SQLite: odstraňte službu db, blok depends_on a proměnné VIKUNJA_DATABASE_* a připojte složku do /db, kam obraz už ukládá vikunja.db. Vytvořte ji a předejte ji uživateli 1000, stejně jako files:
volumes:
- ./files:/app/vikunja/files
- ./db:/db
Od verze 2.4.0 Vikunja publikuje repozitář balíčků pro Debian a Ubuntu, pro amd64, arm64 a armhf, podepsaný svým klíčem 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
Balíček nainstaluje Vikunju do /opt/vikunja, ve výchozím stavu se SQLite, a službu systemd, která je povolená, ale zatím nespuštěná. Zapíše také náhodný tajný klíč do sekce service souboru /etc/vikunja/config.yml: doplňte tutéž sekci a potom službu spusťte.
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 ve výchozím stavu nevytváří žádný účet. Jakmile je HTTPS na místě, otevřete https://tasks.example.com/ a zaregistrujte se: to je váš první účet. Registrace je ve výchozím stavu otevřená každému, kdo se na adresu dostane; jakmile účty vašeho týmu existují, dokumentace doporučuje ji uzavřít. Přidejte tento řádek do proměnných služby vikunja a znovu spusťte docker compose up -d:
VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
Další účty se spravují z příkazového řádku. Protože obraz nemá shell, voláte přímo jeho binární soubor:
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 se zeptá na heslo, pokud ho neuvádí přepínač -p, takže se nedostane do historie vašeho terminálu.user reset-password pošle e-mailem odkaz na obnovení hesla, nebo s --direct heslo přímo nahradí, podle ID, které zobrazí user list.user change-status účet zablokuje nebo znovu povolí, pomocí --disable nebo --enable.doctor zkontroluje konfiguraci, veřejnou adresu URL, tajný klíč, databázi, právo zápisu do files a, pokud je zapnutý, server SMTP.VIKUNJA_SERVICE_TIMEZONE má výchozí hodnotu GMT a očekává název z databáze tz, například Europe/Paris, nikdy posun vůči UTC. Slouží jako výchozí časové pásmo uživatelů, a tím určuje čas jejich připomínek.Vikunja obsluhuje prosté HTTP. Dokumentace ukončuje HTTPS na reverzní proxy, aby hesla a tokeny nikdy necestovaly nešifrované: proxy naslouchá na portech 80 a 443, získá certifikát a předává provoz Vikunji na 127.0.0.1:3456.
Za proxy Vikunja ve výchozím stavu vidí u každého požadavku adresu proxy: protokoly i omezení četnosti pak míří na všechny naráz. Nastavení VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, které už je v souboru Compose, zajistí, že čte hlavičku X-Forwarded-For. Této hlavičce důvěřuje jen u požadavků z adres zpětné smyčky a privátních sítí, včetně sítě Dockeru: s portem publikovaným na 127.0.0.1 se tam dostane jen vaše proxy.
Toto je Caddyfile z dokumentace. Caddy sám získá certifikát Let’s Encrypt pro zadané jméno, předá hlavičku X-Forwarded-For a propustí spojení WebSocket:
tasks.example.com {
reverse_proxy 127.0.0.1:3456
}
Blok z dokumentace se omezuje na řádek proxy_pass a velikost nahrávaných souborů. Tento blok z něj vychází a přidává dvě věci: hlavičku X-Forwarded-For, kterou Vikunja čte, a hlavičky WebSocket. Rozhraní verze 2.8.0 otevírá pro živé aktualizace spojení WebSocket na /api/v2/ws; když selže, jeho oznámení přejdou na dotazování každých 10 sekund. Nejprve přidejte tento blok map do sekce http souboru /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Potom tento blok serveru, na portu 80, aby Certbot mohl nastavit 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 odpovídá maximální velikosti souboru ve Vikunji, ve výchozím stavu 20 MB. Pokud ji zvýšíte pomocí VIKUNJA_FILES_MAXSIZE, dokumentace žádá, abyste zvýšili i tento řádek.
Téměř každý klíč souboru config.yml má svou proměnnou prostředí: z service.enablecaldav se stává VIKUNJA_SERVICE_ENABLECALDAV. Pokud je volba nastavená na obou místech, má přednost proměnná. Kontrolní seznam zabezpečení v dokumentaci prochází funkce, které je vhodné vypnout, pokud je nevyužijete:
| Klíč | Výchozí hodnota | Vypněte, chcete-li |
|---|---|---|
service.enablelinksharing | true | Zabránit sdílení projektů přes veřejné odkazy |
service.enablecaldav | true | Odstranit koncový bod CalDAV, který přijímá ověření HTTP Basic |
webhooks.enabled | true | Zabránit Vikunji v odesílání požadavků na adresy zvolené uživateli |
service.enabletaskattachments | true | Zabránit nahrávání souborů k úkolům |
service.enableuserdeletion | true | Zabránit uživatelům mazat vlastní účty |
plugins.enabled | false | Už vypnuto: kód třetích stran zůstává mimo Vikunju |
Od verze 2.8.0 vyhledávání v PostgreSQL ignoruje diakritiku, pokud je aktivní rozšíření unaccent: „cafe“ najde i „café“. Oficiální obraz PostgreSQL ho obsahuje; zapněte ho v databázi Vikunji a potom Vikunju restartujte. Protokol pak ukáže 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
Každý uživatel importuje úkoly na kartě „Import“ ve svém nastavení a může tam také exportovat všechna svá data jako archiv zip. Importy ze souborů, archivu Vikunji, CSV, TickTick a WeKan, stejně jako import z instance Planka, jsou dostupné vždy. Todoist, Trello a Microsoft To Do vedou přes OAuth: ve výchozím stavu jsou vypnuté a zapínají se v sekci migration konfigurace, s přihlašovacími údaji aplikace vytvořené u každé z těchto služeb. Přesměrování OAuth probíhá v prohlížeči: instance nemusí být pro tyto služby dosažitelná, service.publicurl ale musí být správně.
CalDAV synchronizuje úkoly s vašimi aplikacemi pomocí údajů pro připojení z karty CalDAV v nastavení. Dokumentace tuto integraci představuje jako alfa verzi, která s některými klienty funguje dobře: vyzkoušejte ten svůj, než z něj uděláte nástroj celého týmu. Na iPhonu a iPadu se z každého projektu stane seznam v aplikaci Připomínky. Účet s dvoufázovým ověřením se připojuje vyhrazeným tokenem CalDAV.
Vikunja posílá e-maily s připomínkami úkolů, s potvrzením nového účtu a pro obnovení hesla. Odesílání je ve výchozím stavu vypnuté: účty jsou pak aktivní hned po vytvoření a obnova hesla e-mailem není možná. Jakmile odesílání zapnete, každý nový lokální účet před použitím potvrdí svou adresu.
Z VPS Simafri nastavte ověřovaný server SMTP, na portu 587 nebo 465: server vaší odesílací služby nebo vašeho poskytovatele e-mailu. Přidejte tyto proměnné do služby 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", které vynutí TLS od začátku spojení a odmítne nešifrovaná spojení.plain, případně login nebo cram-md5 pomocí VIKUNJA_MAILER_AUTHTYPE, podle vašeho serveru.Znovu spusťte docker compose up -d a pošlete testovací zprávu. Příkaz ověří spojení příkazem SMTP NOOP, který některé minimalistické relaye nepodporují: dejte přednost plnohodnotnému serveru SMTP.
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com
Dokumentace počítá se dvěma částmi, které se zálohují společně: s databází a se složkou příloh. Od verze 2.8.0 smazané úkoly a projekty nejprve stráví 30 dní v koši; jakmile tato doba uplyne nebo se koš vysype, vrátí je už jen záloha.
| Položka | Co uchovává | Jak ji zkopírovat |
|---|---|---|
| Databáze PostgreSQL | Účty, projekty, úkoly, komentáře a nastavení | pg_dump, bez zastavení Vikunji |
files | Přílohy, avatary a pozadí projektů | Kopie složky |
Se SQLite db/vikunja.db | Celá databáze | Kopie souboru, při zastavené Vikunji |
docker-compose.yml | Tajný klíč, veřejná adresa URL a hesla | Uchovávaný zvlášť, jako tajemství |
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files
Dokumentace žádá šifrované zálohy uchovávané mimo server a pravidelně testovanou obnovu: na samostatné instanci se přihlaste a otevřete úkol s přílohou. Pokud tyto archivy zůstanou na disku serveru, jsou také součástí jeho nočních záloh.
Příkaz vikunja dump shromáždí konfiguraci, databázi a všechny soubory do archivu zip a vikunja restore je z něj znovu načte. Archiv obsahuje konfigurační soubor a všechny proměnné VIKUNJA_* v čitelné podobě: zašifrujte ho a chraňte stejně jako samotnou databázi.
Na čisté instalaci se stejným docker-compose.yml načtěte export do dosud prázdné databáze před prvním spuštěním Vikunji a potom vraťte na místo složku 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 při startu nové verze sama provede migrace databáze. Dokumentace proto žádá zálohu před každou aktualizací, abyste se mohli vrátit k předchozímu stavu, a přečtení poznámek k verzi, které upozorňují na případné ruční kroky.
files.docker-compose.yml, například z 2.8.0 na další verzi.docker compose pull
docker compose up -d
S balíčkem pro Debian sudo apt update && sudo apt upgrade nahradí binární soubor a službu restartuje. Přechod ze stabilního vydání na sestavení unstable funguje, dokumentace ale nedoporučuje vracet se zpět: počkejte raději na další stabilní vydání.
Bezpečnostní opravy se zveřejňují jako bezpečnostní upozornění na GitHubu a oznamují se v poznámkách k verzi. Verze 2.8.0 z 5. listopadu 2026 jich opravuje devatenáct a její oznámení vyzývá k co nejrychlejší aktualizaci. Chcete-li dostávat upozornění, sledujte vydání v repozitáři GitHub nebo odebírejte kanál RSS se seznamem změn.
Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Vikunja zůstává vaším softwarem, s jejím nastavením, vašimi projekty a úkoly.
| Téma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vyhovuje vašemu provozu |
| Dohled | Server sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše volání | Čtení protokolů vaší instance |
| Vikunja | Proaktivní sledování: chyby, zpomalení a místo na disku zachycené, doporučená oprava | Její instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent |
| Účty a projekty | Server, který je nese, hlídaný a zálohovaný | Účty vašeho týmu, registrace, sdílení a oprávnění |
| Server, který se spojí s vaším serverem SMTP na portu 587 nebo 465 | Vaše odesílací služba a její přihlašovací údaje | |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Vaše exporty databáze a složky files a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamžik přepnutí |
Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.
S Managed VPS od Simafri udržují naše týmy server vaší instance Vikunja aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.
Ano. Vikunja je pod licencí AGPL-3.0: můžete ji používat v práci, aniž byste kupovali licenci. Pokud ji upravíte, musí mít vaši vzdálení uživatelé možnost získat zdrojový kód vaší verze. Zbývají náklady na server, na kterém běží.
SQLite, přibalená v obrazu, stačí pro několik málo uživatelů. Pro více uživatelů dokumentace doporučuje PostgreSQL nebo MySQL. PostgreSQL je databáze z jejích příkladů Docker a od verze 2.8.0 v ní vyhledávání ignoruje diakritiku díky rozšíření unaccent.
Vytvořte docker-compose.yml s obrazy vikunja/vikunja:2.8.0 a postgres:18, portem 3456 publikovaným na 127.0.0.1, složkou files předanou uživateli 1000, veřejnou adresou URL a tajným klíčem, potom spusťte docker compose up -d. Nakonec před port 3456 postavte reverzní proxy s HTTPS.
service.publicurl je adresa HTTPS vaší instance: Vikunja z ní sestavuje své odkazy a původ CORS, proto se při chybné hodnotě objeví chyba unauthorized. service.secret podepisuje relace; když zůstane prázdný, mění se při každém startu a odhlásí všechny uživatele.
Vikunja nemá výchozí účet: zaregistrujte se na své instanci. Potom uzavřete registraci nastavením VIKUNJA_SERVICE_ENABLEREGISTRATION na false a další účty vytvářejte příkazem vikunja user create, spuštěným v kontejneru.
Zapněte odesílání pomocí VIKUNJA_MAILER_ENABLED a potom zadejte hostitele, port 587 nebo 465, uživatelské jméno, heslo a adresu odesílatele svého serveru SMTP. Bez e-mailu jsou účty aktivní hned po vytvoření a hesla se obnovují z příkazového řádku.
Zálohujte společně databázi, u PostgreSQL pomocí pg_dump, a složku files s přílohami. Kopie uchovávejte šifrované a mimo server, pořiďte jednu před každou aktualizací a pravidelně testujte jejich obnovu.
Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy také proaktivně sledují vaši instanci a doporučí vám užitečné opravy, které zapracujete vy. Zásah v samotné aplikaci se účtuje po hodinách nebo paušálem.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.