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.
Autor: Simon Vasconcelos Lee
Publikováno 17. listopadu 2026Doba čtení: 14 minut
SharedArrayBuffer, který prohlížeče zapínají jen na stránce obsluhované přes HTTPS. Postará se o to reverzní proxy.docker compose pull.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í:
| Funkce | Bez serveru | Se serverem |
|---|---|---|
| Rozpočty, přehledy, plány | Ano | Ano |
| Import transakcí ze souboru | Ano | Ano |
| Import a export souborů rozpočtu | Ano | Ano |
| Aplikace v prohlížeči a v telefonu | Ano | |
| Synchronizace mezi zařízeními | Ano | |
| Synchronizace s bankou | Ano | |
| Actual API | Ano |
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.
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:
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
docker compose up -d
127.0.0.1 je dostupný jen přes reverzní proxy na stejném serveru, která přidává HTTPS.actual-data obsahuje vše, co server uchovává. Vytvoří v ní dvě podsložky, server-files a user-files, a dokumentace upozorňuje, že toto připojení zachová vaše data i při odstranění kontejneru.latest sleduje nejnovější oficiální vydání a dokumentace ji doporučuje většině uživatelů. latest-alpine dává totéž vydání na lehčím základu Alpine a značka jako 26.11.0 verzi pevně určí. Značky nightly sledují vývoj, s každou změnou v jeho hlavní větvi.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.
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:
localhost.Cross-Origin-Embedder-Policy nastavená na require-corp a Cross-Origin-Opener-Policy nastavená na same-origin. Oficiální server je vždy nastavuje sám.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.
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:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
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.
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:
sudo certbot --nginx
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ě.
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.
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:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: ve výchozím nastavení password, openid pro poskytovatele identity, nebo header.x-actual-password. Dokumentace upozorňuje, že chyba v nastavení v tomto kroku by mohla instanci zpřístupnit celému internetu: vyhraďte ho těmto službám.ACTUAL_ALLOWED_LOGIN_METHODS, seznamu odděleného čárkami.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.
https://budget.example.com/openid/callback.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:
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.
"authMethod": "oauth2" v config.json.ACTUAL_USER_CREATION_MODE nastavené na login je vytvoří při jejich prvním přihlášení.ACTUAL_OPENID_ENFORCE nastavené na true z něj udělá jediný přijímaný způsob přihlášení.ACTUAL_TOKEN_EXPIRATION má ve výchozím nastavení hodnotu never. Může se řídit poskytovatelem, s openid-provider, nebo dobou v sekundách.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.
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.
| Ochrana | Co přináší | Kde se nastavuje |
|---|---|---|
| HTTPS | Šifruje cestu mezi vašimi zařízeními a serverem a umožňuje spuštění aplikace | Reverzní proxy |
| Heslo serveru | Omezuje přístup k rozpočtům, na serveru hašované pomocí argon2 | Při prvním spuštění, pak v nastavení |
| OpenID | Dvoufázové ověření vašeho poskytovatele a jeden účet na osobu | U poskytovatele, pak v nastavení |
| Koncové šifrování | Činí rozpočty nečitelnými pro server i pro jeho zálohy | V každém rozpočtu |
| Šifrování disku | Chrá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.
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.
| Poskytovatel | Pokryté banky podle dokumentace | Stav ve verzi 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Severoamerické banky | Podporováno; od 26.11.0 možné přístupové údaje pro jednotlivé rozpočty |
| GoCardless Bank Account Data | Evropské banky | Podporováno pro stávající účty: GoCardless od července 2025 nepřijímá nové účty |
| Pluggy.ai | Brazilské banky | Podporováno |
| Enable Banking | Evropské banky | Experimentální funkce |
| Akahu | Novozélandské banky | Experimentální funkce |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Veřejné mosty SimpleFIN žádné nastavení nepotřebují.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žka | Co uchovává | Zálohovat |
|---|---|---|
server-files/account.sqlite | Hašované heslo, seznam rozpočtů, relace, účty OpenID a bankovní přístupové údaje | Povinně, šifrovaně |
user-files/ | Soubory rozpočtů, jako binární soubory | Povinně |
config.json | Konfiguraci serveru, pokud jste ji vytvořili | Doporučeno, šifrovaně |
| Export každého rozpočtu | Soubor zip s databází db.sqlite a metadata.json | Doporučeno |
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:
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.
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.
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.
Dokumentace uvádí příkaz, ze složky se souborem compose.yaml. Složka s daty zůstává na místě:
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.
nightly: návrat z nightly na latest může zanechat rozpočet pro stabilní vydání nečitelný. Dokumentace popisuje opravu a s těmito značkami žádá zálohy vašich rozpočtů.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é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 |
| Actual Budget | Proaktivní sledování: chyby, zpomalení a místo na disku zachycené, doporučená oprava | Jeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent |
| Přístupy a rozpočty | Server, který je nese, hlídaný a zálohovaný | Heslo serveru, OpenID, uživatelé a koncové šifrování |
| Synchronizace s bankou | Server, který uchovává její přístupové údaje, hlídaný a zálohovaný | Volba poskytovatele, jeho klíče a propojené účty |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Exporty vašich rozpočtů 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 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.
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ěží.
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.
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.
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.
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.
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.
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.
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.