Hostati Actual Budget na Managed VPS-u znači čuvati svoje budžete i njihovu sinkronizaciju na stroju koji je vaš, a koji naši timovi održavaju ažurnim i nadziru danju i noću. Actual Budget alat je za osobne financije koji podatke prije svega čuva lokalno, objavljen pod licencom MIT. Ovaj vodič prati njegovu službenu dokumentaciju: ulogu poslužitelja, instalaciju s Docker Composeom, HTTPS, lozinku poslužitelja, OpenID, end-to-end šifriranje, sinkronizaciju s bankom, sigurnosne kopije i ažuriranja.
Autor: Simon Vasconcelos Lee
Objavljeno 17. studenoga 2026.Vrijeme čitanja: 14 minuta
SharedArrayBuffer, koji preglednici uključuju samo na stranici posluženoj preko HTTPS-a. Za to se brine obrnuti proxy.docker compose pull.Actual Budget alat je za osobne financije napisan u Node.js-u, koji podatke prije svega čuva lokalno, a README ga opisuje kao potpuno besplatan i otvorenog koda. Sve vaše podatke čuva na svakom vašem uređaju i u pozadini ih sinkronizira s poslužiteljem koji ste odabrali: aplikacija radi i bez veze, a vaše promjene stižu na ostale uređaje čim se mreža vrati.
Projekt se sastoji od klijenta i poslužitelja. Poslužitelj nije obavezan, ali ga dokumentacija izričito preporučuje, jer otključava nekoliko funkcija:
| Funkcija | Bez poslužitelja | S poslužiteljem |
|---|---|---|
| Budžeti, izvješća, rasporedi | Da | Da |
| Uvoz transakcija iz datoteke | Da | Da |
| Uvoz i izvoz datoteka budžeta | Da | Da |
| Aplikacija u pregledniku i na telefonu | Da | |
| Sinkronizacija između uređaja | Da | |
| Sinkronizacija s bankom | Da | |
| Actual API | Da |
Actual Budget objavljen je pod licencom MIT, uz autorska prava Jamesa Longa. Tekst svakome tko dobije primjerak besplatno daje pravo na upotrebu, kopiranje, izmjenu, spajanje, objavljivanje, distribuciju, podlicenciranje i prodaju njegovih primjeraka.
Postoji jedan uvjet: napomena o autorskim pravima i tekst licence idu uz sve primjerke ili bitne dijelove softvera. Stoga sliku koju objavljuje projekt možete pokretati za sebe, svoju obitelj ili svoju tvrtku, bez kupnje licence.
Projekt poslužitelj objavljuje kao Docker sliku, actualbudget/actual-server na Docker Hubu, a istu sliku i u registru GitHuba, ghcr.io/actualbudget/actual. Na poslužitelju s instaliranim Dockerom izradite mapu i u nju stavite ovaj compose.yaml, preuzet iz datoteke koja se nalazi u repozitoriju:
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, dostupan je samo preko obrnutog proxyja na istom poslužitelju, koji dodaje HTTPS.actual-data sadrži sve što poslužitelj čuva. U njoj izrađuje dvije podmape, server-files i user-files, a dokumentacija ističe da to montiranje čuva vaše podatke kada se kontejner ukloni.latest prati najnovije službeno izdanje, a dokumentacija je preporučuje većini korisnika. latest-alpine daje isto izdanje na laganoj osnovi Alpine, a oznaka poput 26.11.0 fiksira inačicu. Oznake nightly prate razvoj, uz svaku promjenu na glavnoj grani.Vaš naziv domene pokazuje na poslužitelj putem A i AAAA zapisa, a posjetitelji stižu na portove 80 i 443. Dok HTTPS nije postavljen, aplikacija se ne otvara: odmah prijeđite na sljedeći odjeljak.
Projekt ne navodi potrebnu memoriju ni procesor. Veličina ovisi o broju budžeta, njihovoj povijesti i broju uređaja koji se sinkroniziraju. Na Managed VPS-u opišite nam svoju upotrebu, a mi vam preporučujemo odgovarajuću veličinu.
Actual Budget oslanja se na SharedArrayBuffer, tehnologiju preglednika koju njegova dokumentacija opisuje kao obaveznu: bez nje se aplikacija ne pokreće. Preglednici je uključuju samo na izoliranoj stranici, za što trebaju dva uvjeta:
localhost.Cross-Origin-Embedder-Policy postavljeno na require-corp i Cross-Origin-Opener-Policy postavljeno na same-origin. Službeni poslužitelj uvijek ih postavlja sam.Da biste Actual izložili internetu, dokumentacija traži da ga postavite iza obrnutog proxyja s HTTPS-om. Poslužitelj može i sam posluživati HTTPS s certifikatom koji mu date, preko ACTUAL_HTTPS_KEY i ACTUAL_HTTPS_CERT: dokumentacija taj put opisuje za poslužitelj koji ostaje izvan interneta.
Dokumentacija Caddy predstavlja kao jednostavan obrnuti proxy, koji sam pribavlja i obnavlja svoje certifikate. Evo njezina primjera, prilagođenog Caddyju instaliranom na poslužitelju:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Ovaj blok preuzima konfiguraciju za Nginx iz dokumentacije, svedenu na port 80 kako bi Certbot postavio HTTPS. Skriva dva zaglavlja koja šalje Actual i ponovno ih postavlja, jednom: dokumentacija upozorava da udvostručeno zaglavlje poništava pravilo, a aplikacija se tada zaustavlja na pogrešci 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 ukida Nginxovo ograničenje veličine, kao u primjeru iz dokumentacije, kako bi velika datoteka budžeta stigla do poslužitelja. Certbot zatim postavlja certifikat i brine se za njegovu obnovu:
sudo certbot --nginx
Otvorite svoju adresu preko https, u novoj kartici, a ne ponovnim učitavanjem stranice koja je prikazala pogrešku, kako savjetuje dokumentacija. Pojavljuje se početni zaslon Actuala: HTTPS i zaglavlja su na mjestu.
Pri prvom pokretanju početni zaslon traži da odaberete lozinku za poslužitelj: ona štiti pristup vašim budžetima. Dok nije postavljena, taj se zaslon prikazuje prvoj osobi koja otvori adresu. Otvorite je stoga čim HTTPS proradi i odaberite dugu lozinku koju koristite samo za ovaj poslužitelj.
Poslužitelj tu lozinku čuva hashiranu, algoritmom argon2, u datoteci account.sqlite u mapi server-files, zajedno s popisom datoteka budžeta koje poznaje i tokenom aktivne sesije.
Dokumentacija daje naredbu koja postavlja novu lozinku bez diranja vaših datoteka ili podataka. Lozinku traži dvaput:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: prema zadanim postavkama password, openid za pružatelja identiteta ili header.x-actual-password. Dokumentacija upozorava da bi pogrešna konfiguracija u tom koraku mogla instancu učiniti dostupnom cijelom internetu: zadržite je za te usluge.ACTUAL_ALLOWED_LOGIN_METHODS, popisom odvojenim zarezima.Za autentifikaciju pouzdaniju od lozinke dokumentacija preporučuje pružatelja OpenID: većina njih nudi dvofaktorsku autentifikaciju. To je ujedno ono što poslužitelj otvara većem broju korisnika. Referenca za konfiguraciju tu metodu predstavlja kao pretpregled.
https://budget.example.com/openid/callback.Ista konfiguracija može ići i u config.json ili u varijable okruženja, s URL-om za otkrivanje kada ga pružatelj objavljuje:
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"
Tajna ide u datoteku .env pokraj compose.yaml. Od inačice 26.10.0 ACTUAL_OPENID_CLIENT_SECRET_FILE može je čitati i iz datoteke, što odgovara Docker tajnama.
"authMethod": "oauth2", u config.json.ACTUAL_USER_CREATION_MODE postavljen na login izrađuje ih pri prvoj prijavi.ACTUAL_OPENID_ENFORCE postavljen na true čini ga jedinim prihvaćenim načinom prijave.ACTUAL_TOKEN_EXPIRATION je prema zadanim postavkama never. Može pratiti trajanje kod pružatelja, s openid-provider, ili trajanje u sekundama.Uz lozinku poslužitelja svaki se budžet može šifrirati end-to-end. Njegovi se podaci tada šifriraju na vašem uređaju, ključem izvedenim iz druge lozinke, prije nego ga napuste: poslužitelj samo prenosi promjene koje ne može pročitati.
Dokumentacija je jasna: zaboravljena lozinka za šifriranje ne može se vratiti. Ako lokalna kopija budžeta još postoji, možete generirati novi ključ, čime se sinkronizacija ponovno postavlja. Šifriranje se ne može ni isključiti: povratak na nešifriranu datoteku ide preko izvoza, a zatim uvoza.
| Zaštita | Što donosi | Gdje se podešava |
|---|---|---|
| HTTPS | Šifrira put između vaših uređaja i poslužitelja i omogućuje pokretanje aplikacije | Obrnuti proxy |
| Lozinka poslužitelja | Ograničava pristup budžetima, hashirana algoritmom argon2 na poslužitelju | Pri prvom pokretanju, zatim u postavkama |
| OpenID | Dvofaktorska autentifikacija vašeg pružatelja i jedan račun po osobi | Kod pružatelja, zatim u postavkama |
| End-to-end šifriranje | Budžete čini nečitljivima za poslužitelj i njegove sigurnosne kopije | U svakom budžetu |
| Šifriranje diska | Štiti lokalnu kopiju, za koju dokumentacija napominje da nije šifrirana | Na svakom vašem uređaju |
End-to-end šifriranje pokriva podatke budžeta. Pristupni podaci za sinkronizaciju s bankom čuvaju se na poslužitelju, u account.sqlite, izvan tog šifriranja: u skladu s tim zaštitite pristup poslužitelju i njegovim sigurnosnim kopijama.
Actual vaše transakcije uvozi iz datoteke, bez ikakvog postavljanja. Može ih i izravno preuzimati iz vaše banke, preko pružatelja bankovnih podataka. Ta sinkronizacija nije obavezna, traži poslužitelj i oslanja se na vaše vlastite pristupne podatke: otvarate račun kod pružatelja i ondje izrađujete ključeve koje dajete Actualu. Ti se ključevi čuvaju na poslužitelju, a unosite ih samo jednom.
| Pružatelj | Obuhvaćene banke, prema dokumentaciji | Status u inačici 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Sjevernoameričke banke | Podržano; pristupni podaci po budžetu mogući od inačice 26.11.0 |
| GoCardless Bank Account Data | Europske banke | Podržano za postojeće račune: GoCardless od srpnja 2025. ne prima nove račune |
| Pluggy.ai | Brazilske banke | Podržano |
| Enable Banking | Europske banke | Eksperimentalna funkcija |
| Akahu | Novozelandske banke | Eksperimentalna funkcija |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Javni mostovi SimpleFIN ne traže nikakvu postavku.Svaki uređaj čuva potpunu kopiju vaših budžeta, a poslužitelj još jednu. Dobra sigurnosna kopija pokriva oboje: mapu s podacima poslužitelja i izvoz svakog budžeta.
| Element | Što čuva | Za sigurnosno kopiranje |
|---|---|---|
server-files/account.sqlite | Hashiranu lozinku, popis budžeta, sesije, račune OpenID i pristupne podatke za banke | Obavezno, šifrirano |
user-files/ | Datoteke budžeta, kao binarne datoteke | Obavezno |
config.json | Konfiguraciju poslužitelja, ako ste je izradili | Preporučeno, šifrirano |
| Izvoz svakog budžeta | Zip datoteku s bazom db.sqlite i metadata.json | Preporučeno |
Sve što poslužitelj čuva nalazi se u actual-data. Uz zaustavljeni poslužitelj može se kopirati odjednom, dok njegove baze SQLite miruju:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Planirajte to kopiranje na poslužitelju, šifrirajte ga i jednu kopiju čuvajte na drugom mjestu. Postavljena na disk poslužitelja, ulazi i u njegove noćne sigurnosne kopije.
Iz otvorenog budžeta: Settings, odjeljak Data, Export data. Datoteka se može čuvati gdje god želite i ponovno se otvara bez poslužitelja. Dokumentacija taj izvoz koristi za povratak sa šifriranog budžeta na nešifriranu datoteku: vaše podatke sadrži u čitljivom obliku, pa ga čuvajte na sigurnom mjestu.
Stari budžet daje velik izvoz, jer Actual svaku promjenu čuva u datoteci. Dokumentacija tada prije izvoza savjetuje Reset sync, u naprednim postavkama: povijest se sažima u jednu datoteku, a veličina se znatno smanjuje.
Na svojim ostalim uređajima zatim odaberite taj budžet na popisu datoteka: preuzima se, a zatim sinkronizira. Desktop aplikacije čuvaju i vlastite automatske sigurnosne kopije, po jednu za svaki od posljednjih deset dana upotrebe i nekoliko za tekući dan.
Dokumentacija daje naredbu, iz mape s datotekom compose.yaml. Mapa s podacima ostaje na mjestu:
docker compose pull
docker compose up -d
Inačice su numerirane prema godini i mjesecu: 26.11.0 izašla je 1. studenoga 2026., a posljednja su izdanja objavljivana početkom svakog mjeseca. Pročitajte njihove bilješke prije ažuriranja i izvezite svoje budžete neposredno prije, kako preporučuje dokumentacija. Bilješke ističu promjene koje treba predvidjeti, poput popisa dopuštenih mreža SimpleFIN u inačici 26.11.0 ili prelaska Ubuntu slike na Node.js 24 u inačici 26.9.0, čime je ona prestala podržavati 32-bitne ARM procesore, za koje je predviđena slika Alpine.
nightly: povratak s nightly na latest može budžet učiniti nečitljivim za stabilno izdanje. Dokumentacija opisuje rješenje i uz te oznake traži sigurnosne kopije vaših budžeta.Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Actual Budget ostaje vaš softver, sa svojim postavkama i vašim budžetima.
| Tema | Naši timovi | Vi |
|---|---|---|
| Poslužitelj | Ažuriranja sustava i sigurnosti, uključujući intervencije na poslužitelju | Trenutak koji odgovara vašem poslovanju |
| Nadzor | Poslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg poziva | Čitanje zapisnika vaše instance |
| Actual Budget | Proaktivno praćenje: uočene pogreške, usporavanja i prostor na disku, preporučen ispravak | Njegova instalacija, ažuriranja i postavke, koje primjenjujete vi ili vaš AI asistent |
| Pristup i budžeti | Poslužitelj koji ih nosi, nadziran i sigurnosno kopiran | Lozinka poslužitelja, OpenID, korisnici i end-to-end šifriranje |
| Sinkronizacija s bankom | Poslužitelj koji čuva njezine pristupne podatke, nadziran i sigurnosno kopiran | Izbor pružatelja, njegovi ključevi i povezani računi |
| Sigurnosne kopije | Svake noći, šifrirane i čuvane izvan stroja; vraćanje uključeno | Izvozi vaših budžeta i zahtjev za vraćanje, kada vam zatreba |
| Migracija | Vaš trenutačni poslužitelj migriran, besplatno | Trenutak prelaska |
Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.
Uz Simafri Managed VPS naši timovi održavaju poslužitelj vaše instance Actual Budgeta ažurnim, nadziru ga danju i noću i interveniraju bez čekanja vašeg poziva; uz to proaktivno prate vašu instancu i preporučuju vam korisne ispravke, koje primjenjujete vi ili vaš AI asistent. Sigurnosne kopije svake se noći šifriraju i čuvaju izvan stroja, njihovo vraćanje je uključeno, a migracija vašeg trenutačnog poslužitelja je besplatna.
Da. Actual Budget objavljen je pod licencom MIT: možete ga slobodno koristiti, mijenjati i dalje distribuirati, za sebe ili za tvrtku, uz uvjet da napomena o autorskim pravima i licenci ostane u primjercima. Ostaje trošak poslužitelja na kojem radi.
Desktop aplikacije rade samostalno. Poslužitelj, koji dokumentacija izričito preporučuje, dodaje web-aplikaciju i mobilnu aplikaciju, sinkronizaciju između uređaja, sinkronizaciju s bankom i API. Svaki uređaj čuva potpunu kopiju vaših budžeta, sinkroniziranu s poslužiteljem.
Izradite compose.yaml sa slikom actualbudget/actual-server, portom 5006 objavljenim na 127.0.0.1 i mapom s podacima montiranom na /data, a zatim pokrenite docker compose up -d. Nakon toga ispred postavite obrnuti proxy s HTTPS-om i otvorite svoju adresu kako biste odabrali lozinku poslužitelja.
Aplikaciji treba SharedArrayBuffer, koji preglednici uključuju samo na stranici posluženoj preko HTTPS-a sa zaglavljima Cross-Origin-Embedder-Policy i Cross-Origin-Opener-Policy. Poslužitelj postavlja ta zaglavlja, a obrnuti proxy donosi HTTPS. Samo pristup preko localhosta radi bez njega.
Poslužujte instancu preko HTTPS-a, odaberite snažnu lozinku poslužitelja ili koristite OpenID s dvofaktorskom autentifikacijom i uključite end-to-end šifriranje: poslužitelj tada više ne može čitati vaše budžete. Tu drugu lozinku čuvajte na sigurnom mjestu, jer se ne može vratiti.
Da, preko pružatelja bankovnih podataka, s vašim vlastitim pristupnim podacima: SimpleFIN Bridge, GoCardless Bank Account Data za postojeće račune, Pluggy.ai te Enable Banking i Akahu kao eksperimentalne funkcije. Sinkronizacija traži poslužitelj, a od inačice 26.11.0 može raditi automatski.
Kopirajte mapu s podacima poslužitelja uz zaustavljeni poslužitelj: server-files sadrži račune i pristupne podatke, user-files budžete. Izvezite i svaki budžet iz Settings, Export data, a te kopije čuvajte šifrirane. Izvoz se vraća s Import file.
Managed VPS pokriva poslužitelj: sustav, sigurnost, nadzor i sigurnosne kopije. Naši timovi proaktivno prate i vašu instancu te vam preporučuju korisne ispravke, koje primjenjujete vi. Intervencija u aplikaciji naplaćuje se po satu ili paušalno.
Simafri
Porazgovarajmo o Vašem projektu
Recite nam u nekoliko riječi što trebate: javljamo Vam se brzo.
Hvala! Vaš upit je poslan. Javit ćemo vam se uskoro.
Više volite e-mail? Pišite nam na support@simafri.com.