Hostovanie Actual Budget na Managed VPS: vaše rozpočty na vašom serveri

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.

Simon Vasconcelos Lee Autor: Publikované 17. novembra 2026Čas čítania: 14 minút

Všetci sprievodcovia

To najdôležitejšie

  1. Licencia MIT umožňuje Actual Budget voľne používať, upravovať a ďalej šíriť, pokiaľ v kópiách zostane jeho upozornenie o autorských právach a licencii.
  2. Server synchronizuje vaše rozpočty medzi zariadeniami a obsluhuje webovú aplikáciu: nainštalujte ho cez Docker Compose, jeden obraz a priečinok s údajmi.
  3. HTTPS je nevyhnutné: aplikácia potrebuje SharedArrayBuffer, ktorý prehliadače zapínajú len na stránke obsluhovanej cez HTTPS. Postará sa o to reverzná proxy.
  4. Hneď pri prvom spustení servera otvorte svoju adresu a zvoľte heslo servera. OpenID pridáva dvojfaktorové overenie vášho poskytovateľa a viacerých používateľov.
  5. Voliteľné koncové šifrovanie robí vaše rozpočty pre server nečitateľnými. Zálohujte priečinok s údajmi, exportujte svoje rozpočty a aktualizujte príkazom docker compose pull.

Čo Actual Budget robí a aká je úloha jeho servera

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

FunkciaBez serveraSo 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

Čo umožňuje licencia MIT

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ť.

Inštalácia pomocou Docker Compose

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:

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é 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ť.

HTTPS: podmienka spustenia aplikácie

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:

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.

S Caddy

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:

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

S Nginx a Certbotom

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.

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

Terminál
sudo certbot --nginx

Overenie

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.

Heslo servera

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.

Obnovenie zabudnutého hesla

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:

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

OpenID a viacerí používatelia

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.

  1. Zaregistrujte Actual u svojho poskytovateľa s URI presmerovania https://budget.example.com/openid/callback.
  2. V otvorenom rozpočte prejdite do nastavení a kliknite na Start using OpenID, potom vyplňte poskytovateľa, ID klienta a jeho tajomstvo.
  3. Prihláste sa cez OpenID. Dokumentácia upozorňuje, že prvá osoba, ktorá sa prihlási, sa stane správcom a vlastníkom servera, a túto rolu už v rozhraní nemožno zmeniť: postarajte sa, aby ste sa prihlásili ako prví.

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:

compose.yaml, v službe
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.

Koncové šifrovanie

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ť.

  1. Otvorte rozpočet, prejdite do nastavení, časť Encryption, a kliknite na Enable encryption.
  2. Zvoľte heslo odlišné od hesla servera.
  3. Na každom ďalšom zariadení zadajte toto isté heslo raz, pri prvom stiahnutí rozpočtu.

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ášaKde sa nastavuje
HTTPSŠifruje cestu medzi vašimi zariadeniami a serverom a umožňuje spustenie aplikácieReverzná proxy
Heslo serveraObmedzuje prístup k rozpočtom, zahashované pomocou argon2 na serveriPri prvom spustení, potom v nastaveniach
OpenIDDvojfaktorové overenie vášho poskytovateľa a jeden účet na osobuU poskytovateľa, potom v nastaveniach
Koncové šifrovanieRobí rozpočty nečitateľnými pre server aj pre jeho zálohyV každom rozpočte
Šifrovanie diskuChrá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.

Bankové synchronizovanie

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ácieStav vo verzii 26.11.0
SimpleFIN BridgeSeveroamerické bankyPodporovaný; od 26.11.0 možné prístupové údaje pre každý rozpočet zvlášť
GoCardless Bank Account DataEurópske bankyPodporovaný pre existujúce účty: GoCardless od júla 2025 neprijíma nové účty
Pluggy.aiBrazílske bankyPodporovaný
Enable BankingEurópske bankyExperimentálna funkcia
AkahuNovozélandské bankyExperimentálna funkcia

Zálohy

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ávaZálohovať
server-files/account.sqliteZahashované heslo, zoznam rozpočtov, relácie, účty OpenID a bankové prístupové údajePovinne, šifrovane
user-files/Súbory rozpočtov ako binárne súboryPovinne
config.jsonKonfigurácia servera, ak ste ju vytvoriliOdporúčané, šifrovane
Export každého rozpočtuSúbor zip s databázou db.sqlite a metadata.jsonOdporúčané

Priečinok servera

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:

Terminál, v priečinku so súborom compose.yaml
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.

Export každého rozpočtu

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.

Obnova

  1. Zatvorte otvorený rozpočet: kliknite na jeho názov vľavo hore a potom na Switch file.
  2. Kliknite na Import file, zvoľte Actual a potom súbor zip s exportom.
  3. Importovaný rozpočet sa zobrazí vedľa pôvodného: skontrolujte ho, podľa potreby premenujte a potom starú kópiu odstráňte.

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ň.

Aktualizácie

Dokumentácia uvádza príkaz, spúšťaný z priečinka so súborom compose.yaml. Priečinok s údajmi zostáva na mieste:

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

Kto čo robí na Managed VPS

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émaNaše tímyVy
ServerAktualizácie systému a zabezpečenia, vrátane zásahov na serveriČas, ktorý vyhovuje vašej činnosti
DohľadServer 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 BudgetProaktívne sledovanie: chyby, spomalenia a miesto na disku, s odporúčanou opravouJeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent
Prístupy a rozpočtyServer, ktorý ich nesie, sledovaný a zálohovanýHeslo servera, OpenID, používatelia a koncové šifrovanie
Bankové synchronizovanieServer, ktorý uchováva jeho prístupové údaje, sledovaný a zálohovanýVýber poskytovateľa, jeho kľúče a prepojené účty
ZálohyKaždú noc, šifrované a uchovávané mimo stroja; obnova je v ceneExporty vašich rozpočtov a žiadosť o obnovu, keď ju potrebujete
MigráciaVáš 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.

Actual Budget na serveri, o ktorý sa staráme za vás

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.

Objaviť Managed VPS

Časté otázky

Je Actual Budget zadarmo?

Á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ží.

Potrebujem na používanie Actual Budget server?

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.

Ako nainštalovať Actual Budget cez Docker Compose?

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.

Prečo Actual Budget vyžaduje HTTPS?

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.

Ako chrániť údaje v rozpočte Actual?

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ť.

Pripája sa Actual Budget k mojej banke?

Á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.

Ako zálohovať Actual Budget?

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.

Pokrýva Managed VPS aj Actual Budget?

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.

Zdroje a oficiálna dokumentácia

Kontaktujte nás