Hostovanie Actual Budget na Managed VPS znamená, že vaše rozpočty a ich synchronizácia zostávajú na vlastnom stroji, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. Actual Budget je nástroj na osobné financie postavený na princípe local-first, vydaný pod licenciou MIT. Tento sprievodca postupuje podľa jeho oficiálnej dokumentácie: úloha servera, inštalácia cez Docker Compose, HTTPS, heslo servera, OpenID, koncové šifrovanie, bankové synchronizovanie, zálohy a aktualizácie.
Autor: Simon Vasconcelos Lee
Publikované 17. novembra 2026Čas čítania: 14 minút
SharedArrayBuffer, ktorý prehliadače zapínajú len na stránke obsluhovanej cez HTTPS. Postará sa o to reverzná proxy.docker compose pull.Actual Budget je nástroj na osobné financie postavený na princípe local-first a napísaný v Node.js, ktorý jeho README opisuje ako úplne bezplatný a otvorený. Všetky vaše údaje uchováva na každom z vašich zariadení a na pozadí ich synchronizuje so serverom, ktorý ste si zvolili: aplikácia funguje aj bez pripojenia a vaše zmeny sa dostanú na ostatné zariadenia, hneď ako je sieť späť.
Projekt sa skladá z klienta a servera. Server je voliteľný, no dokumentácia ho dôrazne odporúča, pretože sprístupňuje viacero funkcií:
| Funkcia | Bez servera | So serverom |
|---|---|---|
| Rozpočty, prehľady, plánované platby | Áno | Áno |
| Import transakcií zo súboru | Áno | Áno |
| Import a export súborov rozpočtu | Áno | Áno |
| Aplikácia v prehliadači a na telefóne | Áno | |
| Synchronizácia medzi zariadeniami | Áno | |
| Bankové synchronizovanie | Áno | |
| API Actual | Áno |
Actual Budget vychádza pod licenciou MIT, s autorskými právami Jamesa Longa. Text bezplatne udeľuje každému, kto získa kópiu, právo používať ju, kopírovať, upravovať, zlučovať, zverejňovať, šíriť, poskytovať sublicencie a predávať jej kópie.
Podmienka je jediná: upozornenie o autorských právach a text licencie sprevádzajú všetky kópie alebo podstatné časti softvéru. Obraz zverejnený projektom teda môžete prevádzkovať pre seba, svoju rodinu alebo svoju firmu bez licencie, ktorú by ste museli kupovať.
Projekt zverejňuje server ako obraz Docker, actualbudget/actual-server na Docker Hub, a ten istý obraz v registri GitHubu, ghcr.io/actualbudget/actual. Na serveri s nainštalovaným Dockerom vytvorte priečinok a umiestnite doň tento súbor compose.yaml, prevzatý zo súboru dodávaného v repozitári:
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ý jedine cez reverznú proxy na tom istom serveri, ktorá pridáva HTTPS.actual-data uchováva všetko, čo server ukladá. Vytvorí v ňom dva podpriečinky, server-files a user-files, a dokumentácia upozorňuje, že toto pripojenie zachová vaše údaje aj po odstránení kontajnera.latest sleduje najnovšie oficiálne vydanie a dokumentácia ju odporúča väčšine používateľov. latest-alpine dáva to isté vydanie na ľahšom základe Alpine a značka ako 26.11.0 pripne verziu. Značky nightly sledujú vývoj, s každou zmenou v jeho hlavnej vetve.Vaše doménové meno ukazuje na server záznamami A a AAAA a návštevníci prichádzajú na porty 80 a 443. Kým HTTPS nie je nasadené, aplikácia sa neotvorí: prejdite priamo na nasledujúcu časť.
Projekt neuvádza nároky na pamäť ani procesor. Veľkosť závisí od počtu rozpočtov, ich histórie a počtu zariadení, ktoré sa synchronizujú. Na spravovanom VPS (Managed VPS) nám opíšte svoje použitie a odporučíme vám vhodnú veľkosť.
Actual Budget sa opiera o SharedArrayBuffer, technológiu prehliadačov, ktorú jeho dokumentácia označuje za nevyhnutnú: bez nej sa aplikácia nespustí. Prehliadače ju zapínajú len na izolovanej stránke, čo si vyžaduje dve podmienky:
localhost.Cross-Origin-Embedder-Policy nastavená na require-corp a Cross-Origin-Opener-Policy nastavená na same-origin. Oficiálny server ich vždy nastavuje sám.Ak chcete Actual sprístupniť na internete, dokumentácia žiada umiestniť ho za reverznú proxy s HTTPS. Server dokáže HTTPS obsluhovať aj sám, s certifikátom, ktorý mu poskytnete, cez ACTUAL_HTTPS_KEY a ACTUAL_HTTPS_CERT: dokumentácia opisuje túto cestu pre server, ktorý zostáva mimo internetu.
Dokumentácia predstavuje Caddy ako jednoduchú reverznú proxy, ktorá svoje certifikáty získava a obnovuje sama. Toto je jej príklad, prispôsobený pre Caddy nainštalované na serveri:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Tento blok preberá konfiguráciu Nginx z dokumentácie, zredukovanú na port 80, aby HTTPS zapol Certbot. Skryje dve hlavičky posielané aplikáciou Actual a nastaví ich znova, raz: dokumentácia upozorňuje, že zdvojená hlavička politiku zneplatní a aplikácia sa potom zastaví na chybe 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 veľkosti v Nginx, ako v príklade z dokumentácie, takže aj veľký súbor rozpočtu sa dostane na server. Certbot potom nainštaluje certifikát a postará sa o jeho obnovu:
sudo certbot --nginx
Otvorte svoju adresu cez https, a to na novej karte, nie opätovným načítaním stránky, ktorá zobrazila chybu, ako radí dokumentácia. Zobrazí sa uvítacia obrazovka Actual: HTTPS aj hlavičky sú na mieste.
Pri prvom spustení vás uvítacia obrazovka vyzve zvoliť heslo pre server: práve ono chráni prístup k vašim rozpočtom. Kým nie je nastavené, táto obrazovka sa zobrazí prvému, kto adresu otvorí. Otvorte ju teda hneď, ako HTTPS funguje, a zvoľte dlhé heslo, ktoré používate len pre tento server.
Server uchováva toto heslo zahashované pomocou argon2 v súbore account.sqlite v server-files, spolu so zoznamom súborov rozpočtov, ktoré pozná, a aktívnym tokenom relácie.
Dokumentácia poskytuje príkaz, ktorý nastaví nové heslo bez zásahu do vašich súborov a údajov. Vypýta si ho dvakrát:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: predvolene password, openid pre poskytovateľa identity alebo header.x-actual-password. Dokumentácia upozorňuje, že chybná konfigurácia v tomto kroku by mohla sprístupniť inštanciu celému internetu: vyhraďte ju pre tieto služby.ACTUAL_ALLOWED_LOGIN_METHODS, zoznam oddelený čiarkami.Pre robustnejšie overovanie než heslo dokumentácia odporúča poskytovateľa OpenID: väčšina z nich ponúka dvojfaktorové overenie. Práve to zároveň otvára server viacerým používateľom. Referenčná príručka konfigurácie predstavuje tento spôsob ako ukážkovú funkciu.
https://budget.example.com/openid/callback.Tá istá konfigurácia môže ísť aj do config.json alebo do premenných prostredia, s adresou URL na zisťovanie, keď ju poskytovateľ zverejň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"
Tajomstvo patrí do súboru .env vedľa compose.yaml. Od verzie 26.10.0 ho ACTUAL_OPENID_CLIENT_SECRET_FILE vie načítať aj zo súboru, čo sa hodí pre tajné údaje Docker.
"authMethod": "oauth2" v config.json.ACTUAL_USER_CREATION_MODE nastavené na login ich vytvára pri prvom prihlásení.ACTUAL_OPENID_ENFORCE nastavené na true z neho robí jediný prijímaný spôsob prihlásenia.ACTUAL_TOKEN_EXPIRATION je predvolene never. Môže sa riadiť trvaním u poskytovateľa, s openid-provider, alebo trvaním v sekundách.Popri hesle servera môže byť každý rozpočet koncovo šifrovaný. Jeho údaje sa potom šifrujú na vašom zariadení kľúčom odvodeným z druhého hesla, ešte predtým, ako ho opustia: server len odovzdáva zmeny, ktoré nedokáže prečítať.
Dokumentácia je jednoznačná: zabudnuté šifrovacie heslo nemožno obnoviť. Ak ešte existuje lokálna kópia rozpočtu, môžete vygenerovať nový kľúč, čo resetuje synchronizáciu. Šifrovanie sa nedá ani vypnúť: návrat k nešifrovanému súboru vedie cez export a následný import.
| Ochrana | Čo prináša | Kde sa nastavuje |
|---|---|---|
| HTTPS | Šifruje cestu medzi vašimi zariadeniami a serverom a umožňuje spustenie aplikácie | Reverzná proxy |
| Heslo servera | Obmedzuje prístup k rozpočtom, zahashované pomocou argon2 na serveri | Pri prvom spustení, potom v nastaveniach |
| OpenID | Dvojfaktorové overenie vášho poskytovateľa a jeden účet na osobu | U poskytovateľa, potom v nastaveniach |
| Koncové šifrovanie | Robí rozpočty nečitateľnými pre server aj pre jeho zálohy | V každom rozpočte |
| Šifrovanie disku | Chráni lokálnu kópiu, ktorá podľa dokumentácie nie je šifrovaná | Na každom z vašich zariadení |
Koncové šifrovanie pokrýva údaje rozpočtov. Prístupové údaje k bankovému synchronizovaniu sa uchovávajú na serveri, v account.sqlite, mimo tohto šifrovania: podľa toho chráňte prístup k serveru aj k jeho zálohám.
Actual importuje vaše transakcie zo súboru, bez akéhokoľvek nastavenia. Vie ich aj sťahovať priamo z vašej banky, cez poskytovateľa bankových údajov. Toto synchronizovanie je voliteľné, potrebuje server a opiera sa o vaše vlastné prístupové údaje: u poskytovateľa si otvoríte účet a vytvoríte tam kľúče, ktoré odovzdáte aplikácii Actual. Tieto kľúče sa uchovávajú na serveri a zadávate ich len raz.
| Poskytovateľ | Pokryté banky podľa dokumentácie | Stav vo verzii 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Severoamerické banky | Podporovaný; od 26.11.0 možné prístupové údaje pre každý rozpočet zvlášť |
| GoCardless Bank Account Data | Európske banky | Podporovaný pre existujúce účty: GoCardless od júla 2025 neprijíma nové účty |
| Pluggy.ai | Brazílske banky | Podporovaný |
| Enable Banking | Európske banky | Experimentálna funkcia |
| Akahu | Novozélandské banky | Experimentálna funkcia |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Verejné mosty SimpleFIN nepotrebujú žiadne nastavenie.Každé zariadenie uchováva úplnú kópiu vašich rozpočtov a server ďalšiu. Dobrá záloha pokrýva oboje: priečinok s údajmi servera a export každého rozpočtu.
| Prvok | Čo uchováva | Zálohovať |
|---|---|---|
server-files/account.sqlite | Zahashované heslo, zoznam rozpočtov, relácie, účty OpenID a bankové prístupové údaje | Povinne, šifrovane |
user-files/ | Súbory rozpočtov ako binárne súbory | Povinne |
config.json | Konfigurácia servera, ak ste ju vytvorili | Odporúčané, šifrovane |
| Export každého rozpočtu | Súbor zip s databázou db.sqlite a metadata.json | Odporúčané |
Všetko, čo server uchováva, je v actual-data. Pri zastavenom serveri ho možno skopírovať naraz, s databázami SQLite v pokoji:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Túto kópiu naplánujte na serveri, zašifrujte ju a jednu uchovávajte inde. Uložená na disku servera sa dostane aj do jeho nočných záloh.
Z otvoreného rozpočtu: Settings, časť Data, Export data. Súbor môžete uchovávať, kde chcete, a otvorí sa znova aj bez servera. Dokumentácia používa tento export na návrat zo šifrovaného rozpočtu k nešifrovanému súboru: obsahuje vaše údaje v čitateľnej podobe, preto ho uchovávajte na bezpečnom mieste.
Starý rozpočet dáva veľký export, pretože Actual uchováva v súbore každú zmenu. Dokumentácia vtedy pred exportom radí Reset sync v rozšírených nastaveniach: história sa zhustí do jediného súboru a veľkosť výrazne klesne.
Na ostatných zariadeniach potom tento rozpočet zvoľte v zozname súborov: stiahne sa a potom synchronizuje. Desktopové aplikácie si navyše vedú vlastné automatické zálohy, jednu za každý z posledných desiatich dní používania a niekoľko za aktuálny deň.
Dokumentácia uvádza príkaz, spúšťaný z priečinka so súborom compose.yaml. Priečinok s údajmi zostáva na mieste:
docker compose pull
docker compose up -d
Verzie sa číslujú podľa roka a mesiaca: 26.11.0 vyšla 1. novembra 2026 a posledné vydania vychádzali na začiatku každého mesiaca. Pred aktualizáciou si prečítajte ich poznámky a tesne predtým exportujte svoje rozpočty, ako odporúča dokumentácia. Poznámky upozorňujú na zmeny, s ktorými treba počítať, napríklad na zoznam povolených sietí SimpleFIN vo verzii 26.11.0 alebo na prechod obrazu Ubuntu na Node.js 24 vo verzii 26.9.0, po ktorom tento obraz už nie je dostupný pre 32-bitové procesory ARM a nahrádza ho obraz Alpine.
nightly: návrat z nightly na latest môže spôsobiť, že rozpočet bude pre stabilné vydanie nečitateľný. Dokumentácia opisuje nápravu a pri týchto značkách žiada zálohy vašich rozpočtov.Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Actual Budget zostáva vaším softvérom, s vašimi nastaveniami a rozpočtami.
| Téma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vyhovuje vašej činnosti |
| Dohľad | Server sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanie | Čítanie záznamov vašej inštancie |
| Actual Budget | Proaktívne sledovanie: chyby, spomalenia a miesto na disku, s odporúčanou opravou | Jeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Prístupy a rozpočty | Server, ktorý ich nesie, sledovaný a zálohovaný | Heslo servera, OpenID, používatelia a koncové šifrovanie |
| Bankové synchronizovanie | Server, ktorý uchováva jeho prístupové údaje, sledovaný a zálohovaný | Výber poskytovateľa, jeho kľúče a prepojené účty |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Exporty vašich rozpočtov a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš súčasný server prenesený zdarma | Čas prepnutia |
Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.
S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie Actual Budget aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.
Áno. Actual Budget vychádza pod licenciou MIT: môžete ho voľne používať, upravovať a ďalej šíriť, pre seba aj pre firmu, pokiaľ v kópiách zostane jeho upozornenie o autorských právach a licencii. Zostáva náklad na server, na ktorom beží.
Desktopové aplikácie fungujú samostatne. Server, ktorý dokumentácia dôrazne odporúča, pridáva webovú a mobilnú aplikáciu, synchronizáciu medzi zariadeniami, bankové synchronizovanie a API. Každé zariadenie uchováva úplnú kópiu vašich rozpočtov, synchronizovanú so serverom.
Vytvorte compose.yaml s obrazom actualbudget/actual-server, portom 5006 publikovaným na 127.0.0.1 a priečinkom s údajmi pripojeným na /data a spustite docker compose up -d. Potom pred neho umiestnite reverznú proxy s HTTPS a otvorte svoju adresu, aby ste zvolili heslo servera.
Aplikácia potrebuje SharedArrayBuffer, ktorý prehliadače zapínajú len na stránke obsluhovanej cez HTTPS s hlavičkami Cross-Origin-Embedder-Policy a Cross-Origin-Opener-Policy. Hlavičky nastavuje server, HTTPS prináša reverzná proxy. Bez neho sa zaobíde len prístup cez localhost.
Obsluhujte inštanciu cez HTTPS, zvoľte silné heslo servera alebo použite OpenID s dvojfaktorovým overením a zapnite koncové šifrovanie: server potom vaše rozpočty nedokáže prečítať. Toto druhé heslo uchovávajte na bezpečnom mieste, pretože ho nemožno obnoviť.
Áno, cez poskytovateľa bankových údajov, s vašimi vlastnými prístupovými údajmi: SimpleFIN Bridge, GoCardless Bank Account Data pre existujúce účty, Pluggy.ai a ako experimentálne funkcie Enable Banking a Akahu. Synchronizovanie potrebuje server a od verzie 26.11.0 môže bežať automaticky.
Skopírujte priečinok s údajmi servera pri zastavenom serveri: server-files obsahuje účty a prístupové údaje, user-files rozpočty. Exportujte aj každý rozpočet cez Settings, Export data a tieto kópie uchovávajte šifrované. Export sa obnovuje cez Import file.
Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy vašu inštanciu aj proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v samotnej aplikácii sa fakturuje hodinovo alebo paušálne.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.