Hostovat Vikunja na Managed VPS: vaše úkoly a projekty na vašem serveru

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.

Simon Vasconcelos Lee Autor: Publikováno 19. listopadu 2026Doba čtení: 13 minut

Všichni průvodci

To nejdůležitější

  1. Licence AGPL-3.0 vám dovoluje používat Vikunju 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.
  2. Nainstalujte ji pomocí Docker Compose: obraz vikunja/vikunja:2.8.0 a PostgreSQL, s portem 3456 publikovaným na 127.0.0.1 za reverzní proxy s HTTPS.
  3. Dvě nastavení patří na místo od samého začátku: service.publicurl, adresa HTTPS vaší instance, a service.secret, který podepisuje relace.
  4. Vikunja nemá žádný výchozí účet: vytvořte si vlastní, potom uzavřete registraci a další účty přidávejte z příkazového řádku.
  5. Zálohujte databázi a složku files společně, před každou aktualizací; migrace databáze se spouštějí samy při startu.

Co Vikunja umí

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.

Co dovoluje licence AGPL-3.0

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.

Zdroje a databáze

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ázeCo říká dokumentaceVerze testovaná v CI
SQLiteJe 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á
PostgreSQLDatabáze z příkladů Docker v dokumentaci. Od verze 2.8.0 vyhledávání ignoruje diakritiku díky rozšíření unaccent.18
MySQL, MariaDBNejmé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.

Instalace pomocí Docker Compose

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:

Terminál
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:

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

Terminál, ve složce se souborem docker-compose.yml
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í.

Se SQLite

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:

docker-compose.yml, služba vikunja
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db

Bez Dockeru: balíček pro Debian

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:

Terminál
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.

/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"
Terminál
sudo systemctl start vikunja

První účet a registrace

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:

docker-compose.yml, pod environment
      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:

Terminál, ve složce se souborem 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

Zabezpečení účtů

HTTPS: reverzní proxy

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.

S Caddy

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:

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

S Nginx

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:

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

Potom tento blok serveru, na portu 80, aby Certbot mohl nastavit HTTPS:

Blok Nginx
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;
    }
}
Terminál
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.

Nastavení specifická pro Vikunju

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í hodnotaVypněte, chcete-li
service.enablelinksharingtrueZabránit sdílení projektů přes veřejné odkazy
service.enablecaldavtrueOdstranit koncový bod CalDAV, který přijímá ověření HTTP Basic
webhooks.enabledtrueZabránit Vikunji v odesílání požadavků na adresy zvolené uživateli
service.enabletaskattachmentstrueZabránit nahrávání souborů k úkolům
service.enableuserdeletiontrueZabránit uživatelům mazat vlastní účty
plugins.enabledfalseUž vypnuto: kód třetích stran zůstává mimo Vikunju

Vyhledávání bez ohledu na diakritiku v PostgreSQL

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.

Terminál, ve složce se souborem docker-compose.yml
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja

Import vašich úkolů

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

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.

E-mail: připomínky, potvrzení a hesla

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:

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

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.

Terminál
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com

Zálohy

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žkaCo uchováváJak ji zkopírovat
Databáze PostgreSQLÚčty, projekty, úkoly, komentáře a nastavenípg_dump, bez zastavení Vikunji
filesPřílohy, avatary a pozadí projektůKopie složky
Se SQLite db/vikunja.dbCelá databázeKopie souboru, při zastavené Vikunji
docker-compose.ymlTajný klíč, veřejná adresa URL a heslaUchovávaný zvlášť, jako tajemství
Terminál, ve složce se souborem 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

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.

Obnova

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:

Terminál
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

Aktualizace

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.

  1. Přečtěte si poznámky k nové verzi.
  2. Exportujte databázi a zkopírujte složku files.
  3. Změňte tag obrazu v docker-compose.yml, například z 2.8.0 na další verzi.
  4. Stáhněte nový obraz a službu znovu spusťte.
Terminál
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.

Kdo co dělá na Managed VPS

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émaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vyhovuje vašemu provozu
DohledServer sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše voláníČtení protokolů vaší instance
VikunjaProaktivní sledování: chyby, zpomalení a místo na disku zachycené, doporučená opravaJejí instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent
Účty a projektyServer, který je nese, hlídaný a zálohovanýÚčty vašeho týmu, registrace, sdílení a oprávnění
E-mailServer, který se spojí s vaším serverem SMTP na portu 587 nebo 465Vaše odesílací služba a její přihlašovací údaje
ZálohyKaž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
MigraceVáš stávající server přenesen zdarmaOkamž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.

Vikunja na serveru, o který se staráme za vás

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.

Objevit Managed VPS

Časté otázky

Je Vikunja pro firmu 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ěží.

Jakou databázi pro Vikunju zvolit?

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.

Jak nainstalovat Vikunju pomocí Docker Compose?

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.

K čemu slouží service.publicurl a service.secret?

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.

Jak vytvořit první účet ve Vikunji?

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.

Jak ve Vikunji nastavit e-mail?

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.

Jak zálohovat Vikunju?

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.

Pokrývá Managed VPS i Vikunju?

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.

Zdroje a oficiální dokumentace

Kontaktujte nás