Hosting Actual Budget na Managed VPS: Państwa budżety na Państwa serwerze

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.

Simon Vasconcelos Lee Autor: Opublikowano 17 listopada 2026Czas czytania: 14 minut

Wszystkie poradniki

W skrócie

  1. Licencja MIT pozwala swobodnie używać, modyfikować i rozpowszechniać Actual Budget, pod warunkiem że informacja o prawach autorskich i licencji pozostaje w kopiach.
  2. Serwer synchronizuje budżety między Państwa urządzeniami i udostępnia aplikację webową: proszę zainstalować go przez Docker Compose, z jednym obrazem i katalogiem z danymi.
  3. HTTPS jest niezbędny: aplikacja potrzebuje SharedArrayBuffer, który przeglądarki włączają tylko na stronie udostępnianej przez HTTPS. Zajmuje się tym odwrotne proxy.
  4. Proszę otworzyć swój adres zaraz po pierwszym uruchomieniu serwera, aby wybrać hasło serwera. OpenID dodaje uwierzytelnianie dwuskładnikowe Państwa dostawcy i obsługę wielu użytkowników.
  5. Opcjonalne szyfrowanie end-to-end sprawia, że budżety są nieczytelne dla serwera. Proszę kopiować katalog z danymi i eksportować budżety, a aktualizować poleceniem docker compose pull.

Co robi Actual Budget i jaka jest rola jego serwera

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:

FunkcjaBez serweraZ serwerem
Budżety, raporty, harmonogramyTakTak
Import transakcji z plikuTakTak
Import i eksport plików budżetuTakTak
Aplikacja w przeglądarce i na telefonieTak
Synchronizacja między urządzeniamiTak
Synchronizacja z bankiemTak
API ActualTak

Na co pozwala licencja MIT

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.

Instalacja przez Docker Compose

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:

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
Terminal
docker compose up -d

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.

HTTPS: warunek uruchomienia aplikacji

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:

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.

Z Caddy

Dokumentacja przedstawia Caddy jako proste odwrotne proxy, które samo uzyskuje i odnawia certyfikaty. Oto jej przykład, dostosowany do Caddy zainstalowanego na serwerze:

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

Z Nginx i Certbotem

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.

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

Terminal
sudo certbot --nginx

Sprawdzenie

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.

Hasło serwera

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.

Reset zapomnianego hasła

Dokumentacja dostarcza polecenie, które ustawia nowe hasło bez naruszania plików i danych. Prosi o nie dwukrotnie:

Terminal
docker exec -it actual_server node /app/src/scripts/reset-password.js

OpenID i wielu użytkowników

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

  1. Proszę zarejestrować Actual u swojego dostawcy, z adresem przekierowania https://budget.example.com/openid/callback.
  2. W otwartym budżecie proszę przejść do ustawień i kliknąć Start using OpenID, a następnie podać dostawcę, identyfikator klienta i jego sekret.
  3. Proszę zalogować się przez OpenID. Dokumentacja ostrzega, że pierwsza osoba, która się zaloguje, zostaje administratorem i właścicielem serwera, a tej roli nie można już zmienić z poziomu interfejsu: proszę upewnić się, że zalogują się Państwo jako pierwsi.

Tę samą konfigurację można też umieścić w config.json albo w zmiennych środowiskowych, z adresem wykrywania, gdy dostawca go publikuje:

compose.yaml, w usłudze
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.

Szyfrowanie end-to-end

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

  1. Proszę otworzyć budżet, przejść do ustawień, sekcja Encryption, i kliknąć Enable encryption.
  2. Proszę wybrać hasło inne niż hasło serwera.
  3. Na każdym kolejnym urządzeniu proszę wpisać to samo hasło jeden raz, przy pierwszym pobraniu budżetu.

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.

OchronaCo dajeGdzie się ją ustawia
HTTPSSzyfruje drogę między Państwa urządzeniami a serwerem i pozwala uruchomić aplikacjęOdwrotne proxy
Hasło serweraOgranicza dostęp do budżetów, zahaszowane algorytmem argon2 na serwerzePrzy pierwszym uruchomieniu, a potem w ustawieniach
OpenIDUwierzytelnianie dwuskładnikowe Państwa dostawcy i jedno konto na osobęU dostawcy, a potem w ustawieniach
Szyfrowanie end-to-endSprawia, że budżety są nieczytelne dla serwera i jego kopii zapasowychW każdym budżecie
Szyfrowanie dyskuChroni kopię lokalną, która według dokumentacji nie jest szyfrowanaNa 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.

Synchronizacja z bankiem

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.

DostawcaObsługiwane banki według dokumentacjiStatus w wersji 26.11.0
SimpleFIN BridgeBanki północnoamerykańskieObsługiwany; od 26.11.0 możliwe dane dostępowe dla każdego budżetu osobno
GoCardless Bank Account DataBanki europejskieObsługiwany dla istniejących kont: GoCardless nie przyjmuje nowych kont od lipca 2025 roku
Pluggy.aiBanki brazylijskieObsługiwany
Enable BankingBanki europejskieFunkcja eksperymentalna
AkahuBanki nowozelandzkieFunkcja eksperymentalna

Kopie zapasowe

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.

ElementCo przechowujeDo skopiowania
server-files/account.sqliteZahaszowane hasło, listę budżetów, sesje, konta OpenID i dane dostępowe do bankówObowiązkowo, w postaci szyfrowanej
user-files/Pliki budżetów, w postaci plików binarnychObowiązkowo
config.jsonKonfigurację serwera, jeśli ją Państwo utworzyliZalecane, w postaci szyfrowanej
Eksport każdego budżetuPlik zip z bazą db.sqlite i metadata.jsonZalecane

Katalog serwera

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:

Terminal, w katalogu z compose.yaml
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.

Eksport każdego budżetu

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.

Przywracanie

  1. Proszę zamknąć otwarty budżet: kliknąć jego nazwę w lewym górnym rogu, a następnie Switch file.
  2. Proszę kliknąć Import file, wybrać Actual, a następnie plik zip eksportu.
  3. Zaimportowany budżet pojawia się obok oryginału: proszę go sprawdzić, w razie potrzeby zmienić jego nazwę, a następnie usunąć starą kopię.

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.

Aktualizacje

Dokumentacja podaje polecenie, wydawane z katalogu z compose.yaml. Katalog z danymi pozostaje na miejscu:

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

Kto za co odpowiada na Managed VPS

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.

TematNasze zespołyPaństwo
SerwerAktualizacje systemu i zabezpieczeń, w tym interwencje na serwerzeMoment dogodny dla Państwa działalności
NadzórSerwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefonCzytanie dzienników Państwa instancji
Actual BudgetProaktywna 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żetySerwer, który je utrzymuje, nadzorowany i objęty kopiami zapasowymiHasło serwera, OpenID, użytkownicy i szyfrowanie end-to-end
Synchronizacja z bankiemSerwer, który przechowuje jej dane dostępowe, nadzorowany i objęty kopiami zapasowymiWybór dostawcy, jego klucze i połączone konta
Kopie zapasoweCo noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenieEksporty Państwa budżetów oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne
MigracjaMigracja Państwa obecnego serwera, bezpłatnaMoment 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ą.

Actual Budget na serwerze prowadzonym za Państwa

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.

Poznaj Managed VPS

Częste pytania

Czy Actual Budget jest bezpłatny?

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.

Czy do korzystania z Actual Budget potrzebny jest serwer?

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.

Jak zainstalować Actual Budget przez Docker Compose?

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.

Dlaczego Actual Budget wymaga HTTPS?

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.

Jak chronić dane budżetu Actual?

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

Czy Actual Budget łączy się z moim bankiem?

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.

Jak wykonać kopię zapasową Actual Budget?

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.

Czy Managed VPS obejmuje Actual Budget?

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.

Źródła i oficjalna dokumentacja

Powiązane poradniki

Różnica między VPS zarządzanym a niezarządzanym: kto co robiRóżnica między VPS zarządzanym a niezarządzanym sprowadza się do jednego pytania: kto zajmuje się serwerem, gdy już działa. Samo słowo „zarządzany” nie ma przy tym oficjalnej definicji: u różnych firm hostingowych oznacza wszystko, od samej instalacji systemu po pełne prowadzenie serwera. Ten poradnik pokazuje, kto co robi, punkt po punkcie, łącznie z pośrednim poziomem, jakim jest wsparcie, i podaje pytania, które rozwiewają wątpliwości przed podpisaniem umowy.Kopie zapasowe VPS: co sprawdzić przed podpisaniem umowyOferta VPS prawie zawsze zapowiada „kopie zapasowe w cenie”. Za tymi słowami może kryć się kopia wykonywana co noc, przechowywana poza maszyną i przywracana przez ekspertów, albo migawka zapisana na tym samym dysku co serwer. Ten poradnik podaje pytania, które robią różnicę, wyjaśnia, co oznacza każda odpowiedź, i pokazuje, jak sprawdzić, czy kopię da się przywrócić.Hosting Vaultwarden na Managed VPS: Państwa hasła na Państwa serwerzeHosting Vaultwarden na Managed VPS oznacza, że hasła Państwa i Państwa zespołu trafiają na maszynę, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Vaultwarden to wolne oprogramowanie na licencji AGPL-3.0. Ten poradnik podąża za jego oficjalną dokumentacją: instalacja przez Docker Compose, HTTPS, zamknięcie rejestracji, token administratora, to, co chroni sejf, baza danych, e-maile, kopie zapasowe i aktualizacje.
Skontaktuj się z nami