Hostovat Actual Budget na Managed VPS: vaše rozpočty na vašem serveru

Hostovat Actual Budget na Managed VPS znamená mít své rozpočty a jejich synchronizaci na vlastním stroji, který naše týmy udržují aktuální a ve dne i v noci hlídají. Actual Budget je nástroj pro osobní finance, který staví na lokálních datech, vydaný pod licencí MIT. Tento průvodce sleduje jeho oficiální dokumentaci: roli serveru, instalaci pomocí Docker Compose, HTTPS, heslo serveru, OpenID, koncové šifrování, synchronizaci s bankou, zálohy a aktualizace.

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

Všichni průvodci

To nejdůležitější

  1. Licence MIT dovoluje Actual Budget volně používat, upravovat a dále šířit, pokud v kopiích zůstane jeho upozornění o autorských právech a licenci.
  2. Server synchronizuje vaše rozpočty mezi zařízeními a nabízí webovou aplikaci: nainstalujte ho pomocí Docker Compose, jeden obraz a složka s daty.
  3. HTTPS je nezbytné: aplikace potřebuje SharedArrayBuffer, který prohlížeče zapínají jen na stránce obsluhované přes HTTPS. Postará se o to reverzní proxy.
  4. Hned po prvním spuštění serveru otevřete svou adresu a zvolte heslo serveru. OpenID přidává dvoufázové ověření vašeho poskytovatele a více uživatelů.
  5. Volitelné koncové šifrování učiní vaše rozpočty pro server nečitelnými. Zálohujte složku s daty a exportujte své rozpočty, pak aktualizujte pomocí docker compose pull.

Co Actual Budget umí a jakou roli má jeho server

Actual Budget je nástroj pro osobní finance napsaný v Node.js, postavený na lokálních datech, který jeho README popisuje jako zcela bezplatný a otevřený. Všechna vaše data uchovává na každém z vašich zařízení a na pozadí je synchronizuje se serverem, který jste zvolili: aplikace funguje i bez připojení a vaše změny se dostanou na ostatní zařízení, jakmile je síť zpět.

Projekt tvoří klient a server. Server je volitelný, ale dokumentace ho důrazně doporučuje, protože zpřístupňuje několik funkcí:

FunkceBez serveruSe serverem
Rozpočty, přehledy, plányAnoAno
Import transakcí ze souboruAnoAno
Import a export souborů rozpočtuAnoAno
Aplikace v prohlížeči a v telefonuAno
Synchronizace mezi zařízenímiAno
Synchronizace s bankouAno
Actual APIAno

Co dovoluje licence MIT

Actual Budget je vydáván pod licencí MIT, s autorskými právy Jamese Longa. Text bezplatně uděluje každému, kdo získá kopii, právo ji používat, kopírovat, upravovat, slučovat, zveřejňovat, šířit, sublicencovat a prodávat její kopie.

Podmínka je jediná: upozornění o autorských právech a text licence doprovázejí všechny kopie nebo podstatné části softwaru. Obraz zveřejněný projektem tedy můžete provozovat pro sebe, svou rodinu nebo svou firmu, aniž byste kupovali licenci.

Instalace pomocí Docker Compose

Projekt zveřejňuje server jako obraz Docker, actualbudget/actual-server na Docker Hubu, a tentýž obraz v registru GitHubu, ghcr.io/actualbudget/actual. Na serveru s nainstalovaným Dockerem vytvořte složku a umístěte do ní tento compose.yaml, převzatý ze souboru dodávaného v repozitáři:

compose.yaml
services:
  actual_server:
    image: docker.io/actualbudget/actual-server:latest
    container_name: actual_server
    restart: unless-stopped
    ports:
      - 127.0.0.1:5006:5006
    volumes:
      - ./actual-data:/data
    healthcheck:
      test: ['CMD-SHELL', 'node scripts/health-check.js']
      interval: 60s
      timeout: 10s
      retries: 3
      start_period: 20s
Terminál
docker compose up -d

Vaše doménové jméno ukazuje na server záznamy A a AAAA a návštěvníci přicházejí na porty 80 a 443. Dokud není nasazené HTTPS, aplikace se neotevře: přejděte rovnou k další části.

Projekt neuvádí žádné údaje o paměti ani procesoru. Velikost závisí na počtu rozpočtů, jejich historii a počtu zařízení, která se synchronizují. Na Managed VPS nám popište své využití a doporučíme vám vhodnou velikost.

HTTPS: podmínka spuštění aplikace

Actual Budget se opírá o SharedArrayBuffer, technologii prohlížečů, kterou jeho dokumentace označuje za nezbytnou: bez ní se aplikace nespustí. Prohlížeče ji zapínají jen na izolované stránce, k čemuž jsou potřeba dvě podmínky:

Chcete-li Actual zpřístupnit z internetu, dokumentace žádá umístit ho za reverzní proxy s HTTPS. Server umí HTTPS obsluhovat i sám, s certifikátem, který mu předáte přes ACTUAL_HTTPS_KEY a ACTUAL_HTTPS_CERT: dokumentace tuto cestu popisuje pro server, který zůstává mimo internet.

S Caddy

Dokumentace představuje Caddy jako snadnou reverzní proxy, která své certifikáty získává a obnovuje sama. Toto je její příklad, přizpůsobený Caddy nainstalovanému na serveru:

Caddyfile
budget.example.com {
    encode gzip zstd
    reverse_proxy 127.0.0.1:5006
}

S Nginx a Certbotem

Tento blok vychází z konfigurace Nginx v dokumentaci, zkrácené na port 80, aby HTTPS nasadil Certbot. Skryje dvě hlavičky posílané Actual a nastaví je znovu, jednou: dokumentace upozorňuje, že zdvojená hlavička zásadu zneplatní a aplikace se pak zastaví na chybě SharedArrayBufferMissing.

Blok Nginx
server {
    listen 80;
    listen [::]:80;
    server_name budget.example.com;

    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:5006;

        proxy_hide_header Cross-Origin-Embedder-Policy;
        proxy_hide_header Cross-Origin-Opener-Policy;

        add_header Cross-Origin-Embedder-Policy "require-corp" always;
        add_header Cross-Origin-Opener-Policy "same-origin" always;
        add_header Origin-Agent-Cluster "?1" always;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

client_max_body_size 0 ruší limit velikosti v Nginx, jako v příkladu z dokumentace, aby se na server dostal i velký soubor rozpočtu. Certbot pak nainstaluje certifikát a postará se o jeho obnovu:

Terminál
sudo certbot --nginx

Ověření

Otevřete svou adresu přes https, na nové kartě, ne opětovným načtením stránky, která zobrazila chybu, jak radí dokumentace. Objeví se uvítací obrazovka Actual: HTTPS i hlavičky jsou na místě.

Heslo serveru

Při prvním spuštění vás uvítací obrazovka požádá o zvolení hesla serveru: právě to chrání přístup k vašim rozpočtům. Dokud není nastavené, zobrazí se tato obrazovka prvnímu, kdo adresu otevře. Otevřete ji proto, jakmile HTTPS funguje, a zvolte dlouhé heslo používané jen pro tento server.

Server uchovává toto heslo hašované pomocí argon2 v souboru account.sqlite ve složce server-files, spolu se seznamem souborů rozpočtů, které zná, a s aktivním tokenem relace.

Obnovení zapomenutého hesla

Dokumentace nabízí příkaz, který nastaví nové heslo, aniž by se dotkl vašich souborů nebo dat. Zeptá se na něj dvakrát:

Terminál
docker exec -it actual_server node /app/src/scripts/reset-password.js

OpenID a více uživatelů

Pro ověřování odolnější než heslo doporučuje dokumentace poskytovatele OpenID: většina z nich nabízí dvoufázové ověření. Právě to také otevírá server více uživatelům. Referenční příručka konfigurace tento způsob představuje jako předběžnou verzi.

  1. Zaregistrujte Actual u svého poskytovatele s adresou přesměrování https://budget.example.com/openid/callback.
  2. V otevřeném rozpočtu přejděte do nastavení a klikněte na Start using OpenID, pak vyplňte poskytovatele, ID klienta a jeho tajný klíč.
  3. Přihlaste se přes OpenID. Dokumentace upozorňuje, že první, kdo se přihlásí, se stává správcem a vlastníkem serveru, a tuto roli už z rozhraní nelze změnit: dbejte na to, abyste se přihlásili první.

Stejná konfigurace může být také v config.json nebo v proměnných prostředí, s adresou pro zjišťování, když ji poskytovatel zveřejňuje:

compose.yaml, ve službě
environment:
  ACTUAL_OPENID_DISCOVERY_URL: "https://auth.example.com/.well-known/openid-configuration"
  ACTUAL_OPENID_CLIENT_ID: "actual"
  ACTUAL_OPENID_CLIENT_SECRET: ${ACTUAL_OPENID_CLIENT_SECRET}
  ACTUAL_OPENID_SERVER_HOSTNAME: "https://budget.example.com"

Tajný klíč patří do souboru .env vedle compose.yaml. Od verze 26.10.0 ho umí ACTUAL_OPENID_CLIENT_SECRET_FILE číst i ze souboru, což se hodí pro tajné údaje Docker.

Koncové šifrování

Nad rámec hesla serveru lze každý rozpočet koncově zašifrovat. Jeho data se pak šifrují na vašem zařízení, klíčem odvozeným z druhého hesla, ještě než ho opustí: server jen předává změny, které nedokáže přečíst.

  1. Otevřete rozpočet, přejděte do nastavení, části Encryption, a klikněte na Enable encryption.
  2. Zvolte heslo odlišné od hesla serveru.
  3. Na každém dalším zařízení zadejte toto heslo jednou, při prvním stažení rozpočtu.

Dokumentace je jednoznačná: zapomenuté šifrovací heslo nelze obnovit. Pokud ještě existuje místní kopie rozpočtu, můžete vygenerovat nový klíč, čímž se synchronizace resetuje. Šifrování nelze ani vypnout: návrat k nešifrovanému souboru vede přes export a následný import.

OchranaCo přinášíKde se nastavuje
HTTPSŠifruje cestu mezi vašimi zařízeními a serverem a umožňuje spuštění aplikaceReverzní proxy
Heslo serveruOmezuje přístup k rozpočtům, na serveru hašované pomocí argon2Při prvním spuštění, pak v nastavení
OpenIDDvoufázové ověření vašeho poskytovatele a jeden účet na osobuU poskytovatele, pak v nastavení
Koncové šifrováníČiní rozpočty nečitelnými pro server i pro jeho zálohyV každém rozpočtu
Šifrování diskuChrání místní kopii, která podle dokumentace šifrovaná neníNa každém z vašich zařízení

Koncové šifrování pokrývá data rozpočtu. Přístupové údaje pro synchronizaci s bankou se uchovávají na serveru, v account.sqlite, mimo toto šifrování: chraňte proto odpovídajícím způsobem přístup k serveru a k jeho zálohám.

Synchronizace s bankou

Actual importuje vaše transakce ze souboru, bez jakéhokoli nastavení. Umí je také stahovat přímo z vaší banky, prostřednictvím poskytovatele bankovních dat. Tato synchronizace je volitelná, vyžaduje server a opírá se o vaše vlastní přístupové údaje: u poskytovatele si otevřete účet a vytvoříte tam klíče, které předáte Actual. Tyto klíče se uchovávají na serveru a zadáváte je jen jednou.

PoskytovatelPokryté banky podle dokumentaceStav ve verzi 26.11.0
SimpleFIN BridgeSeveroamerické bankyPodporováno; od 26.11.0 možné přístupové údaje pro jednotlivé rozpočty
GoCardless Bank Account DataEvropské bankyPodporováno pro stávající účty: GoCardless od července 2025 nepřijímá nové účty
Pluggy.aiBrazilské bankyPodporováno
Enable BankingEvropské bankyExperimentální funkce
AkahuNovozélandské bankyExperimentální funkce

Zálohy

Každé zařízení uchovává úplnou kopii vašich rozpočtů a server další. Dobrá záloha pokrývá obojí: složku s daty serveru a export každého rozpočtu.

PoložkaCo uchováváZálohovat
server-files/account.sqliteHašované heslo, seznam rozpočtů, relace, účty OpenID a bankovní přístupové údajePovinně, šifrovaně
user-files/Soubory rozpočtů, jako binární souboryPovinně
config.jsonKonfiguraci serveru, pokud jste ji vytvořiliDoporučeno, šifrovaně
Export každého rozpočtuSoubor zip s databází db.sqlite a metadata.jsonDoporučeno

Složka serveru

Vše, co server uchovává, je v actual-data. Při zastaveném serveru ji lze zkopírovat najednou, s databázemi SQLite v klidu:

Terminál, ve složce se souborem compose.yaml
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d

Naplánujte tuto kopii na serveru, zašifrujte ji a jednu uchovávejte jinde. Uložená na disku serveru se dostane i do jeho nočních záloh.

Export každého rozpočtu

Z otevřeného rozpočtu: Settings, část Data, Export data. Soubor lze uchovávat, kde chcete, a otevře se znovu i bez serveru. Dokumentace tento export používá k návratu od šifrovaného rozpočtu k nešifrovanému souboru: obsahuje vaše data v čitelné podobě, proto ho uchovávejte na bezpečném místě.

Starý rozpočet dává velký export, protože Actual uchovává v souboru každou změnu. Dokumentace pak před exportem radí Reset sync v pokročilém nastavení: historie se zhutní do jediného souboru a velikost výrazně klesne.

Obnova

  1. Zavřete otevřený rozpočet: klikněte na jeho název vlevo nahoře a pak na Switch file.
  2. Klikněte na Import file, zvolte Actual a pak soubor zip s exportem.
  3. Importovaný rozpočet se objeví vedle původního: zkontrolujte ho, případně ho přejmenujte a pak smažte starou kopii.

Na ostatních zařízeních pak v seznamu souborů zvolte tento rozpočet: stáhne se a pak se synchronizuje. Desktopové aplikace navíc uchovávají vlastní automatické zálohy, jednu za každý z posledních deseti dnů používání a několik za aktuální den.

Aktualizace

Dokumentace uvádí příkaz, ze složky se souborem compose.yaml. Složka s daty zůstává na místě:

Terminál
docker compose pull
docker compose up -d

Verze se číslují podle roku a měsíce: 26.11.0 vyšla 1. listopadu 2026 a poslední vydání vycházela na začátku každého měsíce. Před aktualizací si přečtěte jejich poznámky a těsně předtím exportujte své rozpočty, jak dokumentace doporučuje. Poznámky upozorňují na změny, se kterými je třeba počítat, například na seznam povolených sítí SimpleFIN ve verzi 26.11.0 nebo na přechod obrazu Ubuntu na Node.js 24 ve verzi 26.9.0, kvůli kterému tento obraz přestal podporovat 32bitové procesory ARM ve prospěch obrazu Alpine.

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í; Actual Budget zůstává vaším softwarem, s jeho nastavením a vašimi rozpočty.

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
Actual BudgetProaktivní sledování: chyby, zpomalení a místo na disku zachycené, doporučená opravaJeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent
Přístupy a rozpočtyServer, který je nese, hlídaný a zálohovanýHeslo serveru, OpenID, uživatelé a koncové šifrování
Synchronizace s bankouServer, který uchovává její přístupové údaje, hlídaný a zálohovanýVolba poskytovatele, jeho klíče a propojené účty
ZálohyKaždou noc, šifrované a uchovávané mimo stroj; obnova v ceněExporty vašich rozpočtů 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.

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

S Managed VPS od Simafri udržují naše týmy server vaší instance Actual Budget 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 Actual Budget zdarma?

Ano. Actual Budget je vydáván pod licencí MIT: můžete ho volně používat, upravovat a dále šířit, pro sebe i pro firmu, pokud v kopiích zůstane jeho upozornění o autorských právech a licenci. Zbývají náklady na server, na kterém běží.

Potřebuji k používání Actual Budget server?

Desktopové aplikace fungují samostatně. Server, který dokumentace důrazně doporučuje, přidává webovou a mobilní aplikaci, synchronizaci mezi zařízeními, synchronizaci s bankou a API. Každé zařízení uchovává úplnou kopii vašich rozpočtů, synchronizovanou se serverem.

Jak nainstalovat Actual Budget pomocí Docker Compose?

Vytvořte compose.yaml s obrazem actualbudget/actual-server, portem 5006 publikovaným na 127.0.0.1 a složkou s daty připojenou na /data a spusťte docker compose up -d. Potom před něj umístěte reverzní proxy s HTTPS a otevřete svou adresu, abyste zvolili heslo serveru.

Proč Actual Budget vyžaduje HTTPS?

Aplikace potřebuje SharedArrayBuffer, který prohlížeče zapínají jen na stránce obsluhované přes HTTPS s hlavičkami Cross-Origin-Embedder-Policy a Cross-Origin-Opener-Policy. Tyto hlavičky nastavuje server; HTTPS přináší reverzní proxy. Obejde se bez něj jen přístup přes localhost.

Jak chránit data v rozpočtu Actual?

Provozujte instanci přes HTTPS, zvolte silné heslo serveru nebo použijte OpenID s dvoufázovým ověřením a zapněte koncové šifrování: server pak vaše rozpočty přečíst nemůže. Toto druhé heslo uchovávejte na bezpečném místě, protože ho nelze obnovit.

Propojí se Actual Budget s mou bankou?

Ano, prostřednictvím poskytovatele bankovních dat a s vašimi vlastními přístupovými údaji: SimpleFIN Bridge, GoCardless Bank Account Data pro stávající účty, Pluggy.ai a jako experimentální funkce Enable Banking a Akahu. Synchronizace vyžaduje server a od verze 26.11.0 může běžet automaticky.

Jak zálohovat Actual Budget?

Kopírujte složku s daty serveru při zastaveném serveru: server-files obsahuje účty a přístupové údaje, user-files rozpočty. Exportujte také každý rozpočet přes Settings, Export data a tyto kopie uchovávejte šifrované. Export se obnovuje pomocí Import file.

Pokrývá Managed VPS i Actual Budget?

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