Hosting Actual Budget na Managed VPS oznacza, że Państwa budżety i ich synchronizacja pozostają na maszynie, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Actual Budget to narzędzie do finansów osobistych działające w modelu local-first, udostępniane na licencji MIT. Ten poradnik podąża za jego oficjalną dokumentacją: rola serwera, instalacja przez Docker Compose, HTTPS, hasło serwera, OpenID, szyfrowanie end-to-end, synchronizacja z bankiem, kopie zapasowe i aktualizacje.
Autor: Simon Vasconcelos Lee
Opublikowano 17 listopada 2026Czas czytania: 14 minut
SharedArrayBuffer, który przeglądarki włączają tylko na stronie udostępnianej przez HTTPS. Zajmuje się tym odwrotne proxy.docker compose pull.Actual Budget to narzędzie do finansów osobistych działające w modelu local-first, napisane w Node.js, które README opisuje jako całkowicie bezpłatne i otwartoźródłowe. Przechowuje wszystkie Państwa dane na każdym z urządzeń i synchronizuje je w tle z wybranym serwerem: aplikacja działa nawet bez połączenia, a zmiany docierają do pozostałych urządzeń, gdy tylko sieć wróci.
Projekt składa się z klienta i serwera. Serwer jest opcjonalny, ale dokumentacja gorąco go zaleca, ponieważ odblokowuje kilka funkcji:
| Funkcja | Bez serwera | Z serwerem |
|---|---|---|
| Budżety, raporty, harmonogramy | Tak | Tak |
| Import transakcji z pliku | Tak | Tak |
| Import i eksport plików budżetu | Tak | Tak |
| Aplikacja w przeglądarce i na telefonie | Tak | |
| Synchronizacja między urządzeniami | Tak | |
| Synchronizacja z bankiem | Tak | |
| API Actual | Tak |
Actual Budget jest udostępniany na licencji MIT, prawa autorskie James Long. Tekst przyznaje każdemu, kto uzyska kopię, bezpłatnie prawo do używania, kopiowania, modyfikowania, łączenia, publikowania, rozpowszechniania, sublicencjonowania i sprzedawania jej kopii.
Warunek jest jeden: informacja o prawach autorskich i tekst licencji towarzyszą wszystkim kopiom lub istotnym częściom oprogramowania. Mogą więc Państwo uruchomić obraz opublikowany przez projekt dla siebie, rodziny lub firmy, bez zakupu licencji.
Projekt publikuje serwer jako obraz Docker, actualbudget/actual-server na Docker Hub, a ten sam obraz w rejestrze GitHuba, ghcr.io/actualbudget/actual. Na serwerze z zainstalowanym Dockerem proszę utworzyć katalog i umieścić w nim ten compose.yaml, zaczerpnięty z pliku dostarczonego w repozytorium:
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, jest osiągalny wyłącznie przez odwrotne proxy na tym samym serwerze, które dodaje HTTPS.actual-data przechowuje wszystko, co zachowuje serwer. Tworzy on w nim dwa podkatalogi, server-files i user-files, a dokumentacja zaznacza, że to zamontowanie zachowuje Państwa dane po usunięciu kontenera.latest podąża za najnowszym oficjalnym wydaniem, a dokumentacja zaleca go większości użytkowników. latest-alpine daje to samo wydanie na lżejszej bazie Alpine, a tag taki jak 26.11.0 przypina wersję. Tagi nightly podążają za rozwojem, przy każdej zmianie w jego gałęzi głównej.Państwa nazwa domeny wskazuje na serwer rekordami A i AAAA, a odwiedzający docierają na porty 80 i 443. Dopóki HTTPS nie jest skonfigurowany, aplikacja się nie otwiera: proszę przejść od razu do następnej sekcji.
Projekt nie podaje wymagań dotyczących pamięci ani procesora. Rozmiar zależy od liczby budżetów, ich historii i liczby synchronizowanych urządzeń. Na Managed VPS wystarczy opisać nam swoje zastosowanie, a polecimy odpowiedni rozmiar.
Actual Budget opiera się na SharedArrayBuffer, technologii przeglądarek, którą dokumentacja opisuje jako wymaganą: bez niej aplikacja się nie uruchamia. Przeglądarki włączają ją tylko na stronie izolowanej, co wymaga spełnienia dwóch warunków:
localhost.Cross-Origin-Embedder-Policy o wartości require-corp i Cross-Origin-Opener-Policy o wartości same-origin. Oficjalny serwer zawsze ustawia je sam.Aby udostępnić Actual w internecie, dokumentacja prosi o umieszczenie go za odwrotnym proxy z HTTPS. Serwer może też sam obsługiwać HTTPS z certyfikatem, który mu Państwo przekażą, przez ACTUAL_HTTPS_KEY i ACTUAL_HTTPS_CERT: dokumentacja opisuje tę drogę dla serwera, który pozostaje poza internetem.
Dokumentacja przedstawia Caddy jako proste odwrotne proxy, które samo uzyskuje i odnawia certyfikaty. Oto jej przykład, dostosowany do Caddy zainstalowanego na serwerze:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Ten blok podąża za konfiguracją Nginx z dokumentacji, zredukowaną do portu 80, aby Certbot mógł zainstalować HTTPS. Ukrywa dwa nagłówki wysyłane przez Actual i ustawia je ponownie, jeden raz: dokumentacja ostrzega, że zdublowany nagłówek unieważnia politykę, a aplikacja zatrzymuje się wtedy na błędzie 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 znosi limit rozmiaru Nginx, jak w przykładzie z dokumentacji, aby duży plik budżetu mógł dotrzeć do serwera. Certbot następnie instaluje certyfikat i zajmuje się jego odnawianiem:
sudo certbot --nginx
Proszę otworzyć swój adres w https, w nowej karcie, a nie przez odświeżenie strony, która wyświetliła błąd, jak radzi dokumentacja. Pojawia się ekran powitalny Actual: HTTPS i nagłówki są na miejscu.
Przy pierwszym uruchomieniu ekran powitalny prosi o wybranie hasła serwera: to ono chroni dostęp do Państwa budżetów. Dopóki hasło nie jest ustawione, ten ekran wyświetla się pierwszej osobie, która otworzy adres. Proszę więc otworzyć go, gdy tylko HTTPS działa, i wybrać długie hasło, używane wyłącznie dla tego serwera.
Serwer przechowuje to hasło w postaci zahaszowanej, algorytmem argon2, w pliku account.sqlite w server-files, wraz z listą znanych mu plików budżetu i aktywnym tokenem sesji.
Dokumentacja dostarcza polecenie, które ustawia nowe hasło bez naruszania plików i danych. Prosi o nie dwukrotnie:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: domyślnie password, openid dla dostawcy tożsamości albo header.x-actual-password. Dokumentacja ostrzega, że błąd konfiguracji na tym etapie mógłby udostępnić instancję całemu internetowi: proszę zastrzec tę metodę dla takich usług.ACTUAL_ALLOWED_LOGIN_METHODS, listę rozdzieloną przecinkami.Dla uwierzytelniania solidniejszego niż hasło dokumentacja zaleca dostawcę OpenID: większość z nich oferuje uwierzytelnianie dwuskładnikowe. To również ono otwiera serwer dla wielu użytkowników. Dokumentacja konfiguracji przedstawia tę metodę jako wersję zapoznawczą.
https://budget.example.com/openid/callback.Tę samą konfigurację można też umieścić w config.json albo w zmiennych środowiskowych, z adresem wykrywania, gdy dostawca go publikuje:
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"
Sekret trafia do pliku .env obok compose.yaml. Od wersji 26.10.0 ACTUAL_OPENID_CLIENT_SECRET_FILE może też odczytać go z pliku, co pasuje do sekretów Dockera.
"authMethod": "oauth2" w config.json.ACTUAL_USER_CREATION_MODE ustawione na login tworzy konta przy pierwszym logowaniu.ACTUAL_OPENID_ENFORCE ustawione na true czyni go jedyną dopuszczalną metodą logowania.ACTUAL_TOKEN_EXPIRATION ma domyślnie wartość never. Może podążać za czasem dostawcy, przez openid-provider, albo przyjmować czas w sekundach.Oprócz hasła serwera każdy budżet można zaszyfrować end-to-end. Jego dane są wtedy szyfrowane na Państwa urządzeniu, kluczem wyprowadzonym z drugiego hasła, zanim je opuszczą: serwer przekazuje jedynie zmiany, których nie potrafi odczytać.
Dokumentacja jest jednoznaczna: zapomnianego hasła szyfrowania nie da się odzyskać. Jeśli istnieje jeszcze lokalna kopia budżetu, można wygenerować nowy klucz, co resetuje synchronizację. Szyfrowania nie można też wyłączyć: powrót do niezaszyfrowanego pliku wymaga eksportu, a następnie importu.
| Ochrona | Co daje | Gdzie się ją ustawia |
|---|---|---|
| HTTPS | Szyfruje drogę między Państwa urządzeniami a serwerem i pozwala uruchomić aplikację | Odwrotne proxy |
| Hasło serwera | Ogranicza dostęp do budżetów, zahaszowane algorytmem argon2 na serwerze | Przy pierwszym uruchomieniu, a potem w ustawieniach |
| OpenID | Uwierzytelnianie dwuskładnikowe Państwa dostawcy i jedno konto na osobę | U dostawcy, a potem w ustawieniach |
| Szyfrowanie end-to-end | Sprawia, że budżety są nieczytelne dla serwera i jego kopii zapasowych | W każdym budżecie |
| Szyfrowanie dysku | Chroni kopię lokalną, która według dokumentacji nie jest szyfrowana | Na każdym z Państwa urządzeń |
Szyfrowanie end-to-end obejmuje dane budżetu. Dane dostępowe do synchronizacji z bankiem są przechowywane na serwerze, w account.sqlite, poza tym szyfrowaniem: proszę odpowiednio chronić dostęp do serwera i jego kopii zapasowych.
Actual importuje transakcje z pliku, bez żadnej konfiguracji. Może też pobierać je bezpośrednio z Państwa banku, przez dostawcę danych bankowych. Ta synchronizacja jest opcjonalna, wymaga serwera i opiera się na Państwa własnych danych dostępowych: zakładają Państwo konto u dostawcy i tworzą tam klucze, które przekazują Państwo Actual. Klucze te są przechowywane na serwerze i wpisuje się je tylko raz.
| Dostawca | Obsługiwane banki według dokumentacji | Status w wersji 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Banki północnoamerykańskie | Obsługiwany; od 26.11.0 możliwe dane dostępowe dla każdego budżetu osobno |
| GoCardless Bank Account Data | Banki europejskie | Obsługiwany dla istniejących kont: GoCardless nie przyjmuje nowych kont od lipca 2025 roku |
| Pluggy.ai | Banki brazylijskie | Obsługiwany |
| Enable Banking | Banki europejskie | Funkcja eksperymentalna |
| Akahu | Banki nowozelandzkie | Funkcja eksperymentalna |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Publiczne mosty SimpleFIN nie wymagają żadnego ustawienia.Każde urządzenie przechowuje pełną kopię Państwa budżetów, a serwer kolejną. Dobra kopia zapasowa obejmuje obie: katalog z danymi serwera i eksport każdego budżetu.
| Element | Co przechowuje | Do skopiowania |
|---|---|---|
server-files/account.sqlite | Zahaszowane hasło, listę budżetów, sesje, konta OpenID i dane dostępowe do banków | Obowiązkowo, w postaci szyfrowanej |
user-files/ | Pliki budżetów, w postaci plików binarnych | Obowiązkowo |
config.json | Konfigurację serwera, jeśli ją Państwo utworzyli | Zalecane, w postaci szyfrowanej |
| Eksport każdego budżetu | Plik zip z bazą db.sqlite i metadata.json | Zalecane |
Wszystko, co przechowuje serwer, znajduje się w actual-data. Przy zatrzymanym serwerze można skopiować go za jednym razem, z bazami SQLite w stanie spoczynku:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Proszę zaplanować tę kopię na serwerze, zaszyfrować ją i przechowywać jeden egzemplarz w innym miejscu. Umieszczona na dysku serwera, trafia także do jego nocnych kopii zapasowych.
Z otwartego budżetu: Settings, sekcja Data, Export data. Plik można przechowywać w dowolnym miejscu i otworzyć ponownie bez serwera. Dokumentacja używa tego eksportu, aby wrócić z zaszyfrowanego budżetu do niezaszyfrowanego pliku: zawiera on Państwa dane jawnym tekstem, dlatego proszę przechowywać go w bezpiecznym miejscu.
Stary budżet daje duży eksport, ponieważ Actual zachowuje w pliku każdą zmianę. Dokumentacja radzi wtedy użyć Reset sync, w ustawieniach zaawansowanych, przed eksportem: historia zostaje scalona w jeden plik, a rozmiar wyraźnie spada.
Na pozostałych urządzeniach proszę następnie wybrać ten budżet z listy plików: pobiera się, a potem synchronizuje. Aplikacje na komputer wykonują też własne automatyczne kopie zapasowe, po jednej z każdego z dziesięciu ostatnich dni użytkowania i kilka z bieżącego dnia.
Dokumentacja podaje polecenie, wydawane z katalogu z compose.yaml. Katalog z danymi pozostaje na miejscu:
docker compose pull
docker compose up -d
Wersje są numerowane według roku i miesiąca: 26.11.0 ukazała się 1 listopada 2026 roku, a ostatnie wydania publikowano na początku każdego miesiąca. Proszę czytać ich notatki przed aktualizacją i tuż przed nią eksportować budżety, jak zaleca dokumentacja. Notatki wskazują zmiany, które trzeba zaplanować, takie jak lista dozwolonych sieci SimpleFIN w 26.11.0 albo przejście obrazu Ubuntu na Node.js 24 w 26.9.0, które wycofało go z 32-bitowych procesorów ARM na rzecz obrazu Alpine.
nightly: powrót z nightly na latest może sprawić, że budżet stanie się nieczytelny dla wersji stabilnej. Dokumentacja opisuje rozwiązanie i prosi o kopie zapasowe budżetów przy tych tagach.Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; Actual Budget pozostaje Państwa oprogramowaniem, z jego ustawieniami i Państwa budżetami.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa działalności |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Czytanie dzienników Państwa instancji |
| Actual Budget | Proaktywna opieka: wychwytujemy błędy, spowolnienia i brak miejsca na dysku oraz polecamy poprawkę | Instalacja, aktualizacje i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI |
| Dostęp i budżety | Serwer, który je utrzymuje, nadzorowany i objęty kopiami zapasowymi | Hasło serwera, OpenID, użytkownicy i szyfrowanie end-to-end |
| Synchronizacja z bankiem | Serwer, który przechowuje jej dane dostępowe, nadzorowany i objęty kopiami zapasowymi | Wybór dostawcy, jego klucze i połączone konta |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Eksporty Państwa budżetów oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment przełączenia |
Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.
Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji Actual Budget w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.
Tak. Actual Budget jest udostępniany na licencji MIT: mogą Państwo swobodnie używać go, modyfikować i rozpowszechniać, dla siebie lub dla firmy, pod warunkiem że informacja o prawach autorskich i licencji pozostaje w kopiach. Pozostaje koszt serwera, na którym działa.
Aplikacje na komputer działają samodzielnie. Serwer, który dokumentacja gorąco zaleca, dodaje aplikację webową i mobilną, synchronizację między urządzeniami, synchronizację z bankiem i API. Każde urządzenie przechowuje pełną kopię budżetów, synchronizowaną z serwerem.
Proszę utworzyć compose.yaml z obrazem actualbudget/actual-server, portem 5006 opublikowanym na 127.0.0.1 i katalogiem z danymi zamontowanym w /data, a następnie uruchomić docker compose up -d. Potem proszę postawić przed nim odwrotne proxy z HTTPS i otworzyć swój adres, aby wybrać hasło serwera.
Aplikacja potrzebuje SharedArrayBuffer, który przeglądarki włączają tylko na stronie udostępnianej przez HTTPS z nagłówkami Cross-Origin-Embedder-Policy i Cross-Origin-Opener-Policy. Te nagłówki ustawia serwer; HTTPS zapewnia odwrotne proxy. Bez HTTPS obywa się tylko dostęp przez localhost.
Proszę udostępniać instancję przez HTTPS, wybrać silne hasło serwera albo używać OpenID z uwierzytelnianiem dwuskładnikowym i włączyć szyfrowanie end-to-end: serwer nie może już wtedy odczytać budżetów. To drugie hasło proszę przechowywać w bezpiecznym miejscu, ponieważ nie da się go odzyskać.
Tak, przez dostawcę danych bankowych, z Państwa własnymi danymi dostępowymi: SimpleFIN Bridge, GoCardless Bank Account Data dla istniejących kont, Pluggy.ai oraz Enable Banking i Akahu jako funkcje eksperymentalne. Synchronizacja wymaga serwera i od wersji 26.11.0 może działać automatycznie.
Proszę kopiować katalog z danymi serwera przy zatrzymanym serwerze: server-files zawiera konta i dane dostępowe, user-files budżety. Proszę też eksportować każdy budżet przez Settings, Export data, i przechowywać te kopie w postaci szyfrowanej. Eksport przywraca się przez Import file.
Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.