Actual Budgetin hostaus Managed VPS:llä tarkoittaa, että budjettinne ja niiden synkronointi pysyvät koneella, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Actual Budget on paikallisuutta korostava (local-first) henkilökohtaisen talouden työkalu, joka julkaistaan MIT-lisenssillä. Tämä opas seuraa sen virallista dokumentaatiota: palvelimen rooli, asennus Docker Composella, HTTPS, palvelimen salasana, OpenID, päästä päähän -salaus, pankkisynkronointi, varmuuskopiot ja päivitykset.
Kirjoittaja: Simon Vasconcelos Lee
Julkaistu 17. marraskuuta 2026Lukuaika: 14 minuuttia
SharedArrayBuffer-ominaisuutta, jonka selaimet ottavat käyttöön vain HTTPS:llä tarjotulla sivulla. Käänteinen välityspalvelin hoitaa sen.docker compose pull.Actual Budget on Node.js:llä kirjoitettu, paikallisuutta korostava henkilökohtaisen talouden työkalu, jota sen README kuvaa täysin maksuttomaksi ja avoimeksi lähdekoodiksi. Se säilyttää kaikki tietonne jokaisella laitteellanne ja synkronoi ne taustalla valitsemanne palvelimen kanssa: sovellus toimii myös ilman yhteyttä, ja muutoksenne siirtyvät muille laitteillenne heti, kun verkko palaa.
Projekti koostuu asiakasohjelmasta ja palvelimesta. Palvelin on valinnainen, mutta dokumentaatio suosittelee sitä painokkaasti, koska se avaa useita ominaisuuksia:
| Ominaisuus | Ilman palvelinta | Palvelimen kanssa |
|---|---|---|
| Budjetit, raportit, aikataulut | Kyllä | Kyllä |
| Tapahtumien tuonti tiedostosta | Kyllä | Kyllä |
| Budjettitiedostojen tuonti ja vienti | Kyllä | Kyllä |
| Sovellus selaimessa ja puhelimessa | Kyllä | |
| Synkronointi laitteiden välillä | Kyllä | |
| Pankkisynkronointi | Kyllä | |
| Actual-rajapinta | Kyllä |
Actual Budget julkaistaan MIT-lisenssillä, tekijänoikeuden haltijana James Long. Teksti antaa jokaiselle kopion saavalle maksutta oikeuden käyttää, kopioida, muokata, yhdistää, julkaista, jakaa, alilisensoida ja myydä sen kopioita.
Ehtoja on yksi: tekijänoikeusilmoitus ja lisenssin teksti kulkevat kaikkien ohjelmiston kopioiden tai sen merkittävien osien mukana. Voitte siis ajaa projektin julkaisemaa imagea itsellenne, perheellenne tai yrityksellenne ilman ostettavaa lisenssiä.
Projekti julkaisee palvelimen Docker-imagena, Docker Hubissa nimellä actualbudget/actual-server, ja saman imagen GitHubin rekisterissä, ghcr.io/actualbudget/actual. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja sijoittakaa sinne tämä compose.yaml, joka on poimittu repositorion tiedostosta:
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 julkaistuna siihen pääsee vain samalla palvelimella olevan käänteisen välityspalvelimen kautta, joka lisää HTTPS:n.actual-data-kansio sisältää kaiken, mitä palvelin säilyttää. Palvelin luo sinne kaksi alikansiota, server-files ja user-files, ja dokumentaatio huomauttaa, että tämä liitos säilyttää tietonne, kun kontti poistetaan.latest seuraa uusinta virallista julkaisua, ja dokumentaatio suosittelee sitä useimmille käyttäjille. latest-alpine antaa saman julkaisun kevyemmällä Alpine-pohjalla, ja tunniste, kuten 26.11.0, kiinnittää version. nightly-tunnisteet seuraavat kehitystä jokaisen päähaaran muutoksen myötä.Verkkotunnuksenne osoittaa palvelimeen A- ja AAAA-tietueilla, ja kävijät saapuvat portteihin 80 ja 443. Kunnes HTTPS on paikallaan, sovellus ei avaudu: siirtykää suoraan seuraavaan osioon.
Projekti ei ilmoita muistin eikä suorittimen tarvetta. Koko riippuu budjettien määrästä, niiden historiasta ja synkronoivien laitteiden määrästä. Managed VPS -palvelimella kertokaa meille käyttötarkoituksenne, niin suosittelemme sopivaa kokoa.
Actual Budget nojaa SharedArrayBuffer-ominaisuuteen, selaintekniikkaan, jota sen dokumentaatio kuvaa pakolliseksi: ilman sitä sovellus ei käynnisty. Selaimet ottavat sen käyttöön vain eristetyllä sivulla, mikä vaatii kaksi ehtoa:
localhost kautta avatun palvelimen.Cross-Origin-Embedder-Policy arvolla require-corp ja Cross-Origin-Opener-Policy arvolla same-origin. Virallinen palvelin asettaa ne aina itse.Actualin avaamiseksi internetiin dokumentaatio pyytää asettamaan sen HTTPS:llä toimivan käänteisen välityspalvelimen taakse. Palvelin voi myös tarjota HTTPS:n itse sille annetulla varmenteella muuttujien ACTUAL_HTTPS_KEY ja ACTUAL_HTTPS_CERT kautta: dokumentaatio kuvaa tämän tien palvelimelle, joka pysyy poissa internetistä.
Dokumentaatio esittelee Caddyn helppona käänteisenä välityspalvelimena, joka hankkii ja uusii varmenteensa itse. Tässä on sen esimerkki mukautettuna palvelimelle asennettuun Caddyyn:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Tämä lohko noudattaa dokumentaation Nginx-määritystä supistettuna porttiin 80, jotta Certbot voi asentaa HTTPS:n. Se piilottaa Actualin lähettämät kaksi otsaketta ja asettaa ne uudelleen kerran: dokumentaatio varoittaa, että kahdentunut otsake mitätöi käytännön, jolloin sovellus pysähtyy virheeseen 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 poistaa Nginxin kokorajan, kuten dokumentaation esimerkissä, jotta suuri budjettitiedosto pääsee palvelimelle. Certbot asentaa sen jälkeen varmenteen ja huolehtii sen uusimisesta:
sudo certbot --nginx
Avatkaa osoitteenne https-muodossa uudessa välilehdessä eikä lataamalla uudelleen sivua, joka näytti virheen, kuten dokumentaatio neuvoo. Actualin aloitusnäyttö tulee näkyviin: HTTPS ja otsakkeet ovat paikallaan.
Ensimmäisellä käynnistyskerralla aloitusnäyttö pyytää valitsemaan palvelimelle salasanan: se suojaa pääsyn budjetteihinne. Kunnes salasana on asetettu, tämä näyttö näkyy ensimmäiselle osoitteen avaavalle. Avatkaa se siis heti, kun HTTPS toimii, ja valitkaa pitkä salasana, jota käytetään vain tällä palvelimella.
Palvelin säilyttää tämän salasanan argon2-tiivisteenä server-files-kansion tiedostossa account.sqlite yhdessä tuntemiensa budjettitiedostojen luettelon ja aktiivisen istuntotunnuksen kanssa.
Dokumentaatio tarjoaa komennon, joka asettaa uuden salasanan koskematta tiedostoihinne tai tietoihinne. Se kysyy salasanan kahdesti:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: oletuksena password, tunnistuspalvelulle openid tai header.x-actual-password. Dokumentaatio varoittaa, että tämän vaiheen virheellinen määritys voisi avata instanssin koko internetille: varatkaa se näille palveluille.ACTUAL_ALLOWED_LOGIN_METHODS, pilkuin eroteltuna luettelona.Salasanaa vahvempaa todennusta varten dokumentaatio suosittelee OpenID-tunnistuspalvelua: useimmat niistä tarjoavat kaksivaiheisen tunnistautumisen. Se myös avaa palvelimen useille käyttäjille. Asetusviite esittelee tämän tavan esiversiona.
https://budget.example.com/openid/callback.Samat asetukset voi sijoittaa myös tiedostoon config.json tai ympäristömuuttujiin, ja haun osoitteen kanssa, kun tunnistuspalvelu julkaisee sellaisen:
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"
Salaisuus sijoitetaan tiedostoon .env, compose.yaml-tiedoston viereen. Versiosta 26.10.0 alkaen ACTUAL_OPENID_CLIENT_SECRET_FILE voi myös lukea sen tiedostosta, mikä sopii Docker-salaisuuksille.
"authMethod": "oauth2" tiedostossa config.json.ACTUAL_USER_CREATION_MODE arvolla login luo käyttäjät heidän ensimmäisellä kirjautumisellaan.ACTUAL_OPENID_ENFORCE arvolla true tekee siitä ainoan hyväksytyn kirjautumistavan.ACTUAL_TOKEN_EXPIRATION on oletuksena never. Se voi seurata tunnistuspalvelun kestoa arvolla openid-provider tai olla kesto sekunteina.Palvelimen salasanan lisäksi jokainen budjetti voidaan salata päästä päähän. Sen tiedot salataan silloin laitteellanne toisesta salasanasta johdetulla avaimella ennen kuin ne lähtevät: palvelin välittää vain muutoksia, joita se ei pysty lukemaan.
Dokumentaatio on selvä: unohtunutta salaussalasanaa ei voi palauttaa. Jos budjetista on yhä paikallinen kopio, voitte luoda uuden avaimen, mikä nollaa synkronoinnin. Salausta ei voi myöskään poistaa käytöstä: paluu salaamattomaan tiedostoon kulkee viennin ja tuonnin kautta.
| Suoja | Mitä se tuo | Missä se asetetaan |
|---|---|---|
| HTTPS | Salaa reitin laitteidenne ja palvelimen välillä ja antaa sovelluksen käynnistyä | Käänteinen välityspalvelin |
| Palvelimen salasana | Rajaa pääsyn budjetteihin, argon2-tiivisteenä palvelimella | Ensimmäisellä käynnistyksellä, sitten asetuksissa |
| OpenID | Tunnistuspalvelunne kaksivaiheinen tunnistautuminen ja yksi tili henkilöä kohden | Tunnistuspalvelussa, sitten asetuksissa |
| Päästä päähän -salaus | Tekee budjeteista lukukelvottomia palvelimelle ja sen varmuuskopioille | Jokaisessa budjetissa |
| Levyn salaus | Suojaa paikallista kopiota, joka dokumentaation mukaan on salaamaton | Jokaisella laitteellanne |
Päästä päähän -salaus kattaa budjettien tiedot. Pankkisynkronoinnin tunnukset säilytetään palvelimella tiedostossa account.sqlite tämän salauksen ulkopuolella: suojatkaa pääsy palvelimeen ja sen varmuuskopioihin sen mukaisesti.
Actual tuo tapahtumanne tiedostosta ilman asetuksia. Se voi myös hakea ne suoraan pankistanne pankkitietojen palveluntarjoajan kautta. Tämä synkronointi on valinnainen, tarvitsee palvelimen ja nojaa omiin tunnuksiinne: avaatte tilin palveluntarjoajalla ja luotte siellä avaimet, jotka annatte Actualille. Nämä avaimet säilytetään palvelimella, ja syötätte ne vain kerran.
| Palveluntarjoaja | Katetut pankit dokumentaation mukaan | Tila versiossa 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Pohjoisamerikkalaiset pankit | Tuettu; budjettikohtaiset tunnukset mahdollisia versiosta 26.11.0 alkaen |
| GoCardless Bank Account Data | Eurooppalaiset pankit | Tuettu olemassa oleville tileille: GoCardless ei ole ottanut uusia tilejä heinäkuun 2025 jälkeen |
| Pluggy.ai | Brasilialaiset pankit | Tuettu |
| Enable Banking | Eurooppalaiset pankit | Kokeellinen ominaisuus |
| Akahu | Uusiseelantilaiset pankit | Kokeellinen ominaisuus |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Julkiset SimpleFIN-sillat eivät tarvitse asetusta.Jokainen laite säilyttää täydellisen kopion budjeteistanne, ja palvelin säilyttää toisen. Hyvä varmuuskopio kattaa molemmat: palvelimen datakansion ja jokaisen budjetin viennin.
| Osa | Mitä se säilyttää | Varmuuskopioitava |
|---|---|---|
server-files/account.sqlite | Salasanan tiiviste, budjettien luettelo, istunnot, OpenID-tilit ja pankkitunnukset | Pakollinen, salattuna |
user-files/ | Budjettitiedostot binääritiedostoina | Pakollinen |
config.json | Palvelimen asetukset, jos olette luoneet sellaisen | Suositeltava, salattuna |
| Jokaisen budjetin vienti | Zip-tiedosto, jossa on tietokanta db.sqlite ja metadata.json | Suositeltava |
Kaikki, mitä palvelin säilyttää, on kansiossa actual-data. Palvelimen ollessa pysäytettynä sen voi kopioida kerralla, SQLite-tietokantojen ollessa levossa:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Ajastakaa tämä kopio palvelimella, salatkaa se ja säilyttäkää yksi kopio muualla. Palvelimen levylle tallennettuna se päätyy myös sen yöllisiin varmuuskopioihin.
Avatusta budjetista: Settings, osio Data, Export data. Tiedoston voi säilyttää missä haluatte, ja se avautuu uudelleen ilman palvelinta. Dokumentaatio käyttää tätä vientiä palatakseen salatusta budjetista salaamattomaan tiedostoon: se sisältää tietonne selväkielisinä, joten säilyttäkää se turvassa.
Vanha budjetti tuottaa suuren viennin, koska Actual säilyttää tiedostossa jokaisen muutoksen. Dokumentaatio neuvoo silloin käyttämään lisäasetusten kohtaa Reset sync ennen vientiä: historia tiivistyy yhdeksi tiedostoksi, ja koko pienenee selvästi.
Valitkaa sitten muilla laitteillanne tämä budjetti tiedostoluettelosta: se latautuu ja synkronoituu. Työpöytäsovellukset ylläpitävät myös omia automaattisia varmuuskopioitaan, yhden kutakin kymmentä viimeistä käyttöpäivää kohden ja useita kuluvalta päivältä.
Dokumentaatio antaa komennon, ajettavaksi compose.yaml-tiedoston kansiossa. Datakansio pysyy paikallaan:
docker compose pull
docker compose up -d
Versiot numeroidaan vuoden ja kuukauden mukaan: 26.11.0 julkaistiin 1. marraskuuta 2026, ja viimeisimmät julkaisut ovat ilmestyneet kunkin kuukauden alussa. Lukekaa niiden tiedot ennen päivitystä ja viekää budjettinne juuri sitä ennen, kuten dokumentaatio suosittelee. Tiedot nostavat esiin huomioitavat muutokset, kuten sallittujen SimpleFIN-verkkojen luettelon versiossa 26.11.0 tai Ubuntu-imagen siirtymisen Node.js 24:ään versiossa 26.9.0, mikä poisti sen 32-bittisiltä ARM-suorittimilta Alpine-imagen hyväksi.
nightly-tunnisteet: paluu tunnisteesta nightly tunnisteeseen latest voi jättää budjetin vakaalle julkaisulle lukukelvottomaksi. Dokumentaatio kuvaa korjauksen ja pyytää varmuuskopioimaan budjettinne näitä tunnisteita käytettäessä.Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Actual Budget pysyy teidän ohjelmananne asetuksineen ja budjetteineen.
| Aihe | Tiimimme | Te |
|---|---|---|
| Palvelin | Järjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukien | Toimintaanne sopiva ajankohta |
| Valvonta | Palvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanne | Instanssinne lokien lukeminen |
| Actual Budget | Proaktiivinen seuranta: virheet, hitaus ja levytila havaitaan, ja korjausta suositellaan | Sen asennus, päivitykset ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa |
| Pääsy ja budjetit | Niitä kantava palvelin, valvottuna ja varmuuskopioituna | Palvelimen salasana, OpenID, käyttäjät ja päästä päähän -salaus |
| Pankkisynkronointi | Sen tunnukset säilyttävä palvelin, valvottuna ja varmuuskopioituna | Palveluntarjoajan valinta, sen avaimet ja liitetyt tilit |
| Varmuuskopiot | Joka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyy | Budjettienne viennit sekä palautuspyyntö, kun tarvitsette sitä |
| Siirto | Nykyinen palvelimenne siirretään, veloituksetta | Käyttöönoton ajankohta |
Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.
Simafrin Managed VPS -palvelussa tiimimme pitävät Actual Budget -instanssinne palvelimen ajan tasalla, valvovat sitä yötä päivää ja toimivat odottamatta yhteydenottoanne; ne seuraavat myös instanssianne proaktiivisesti ja suosittelevat teille hyödyllisiä korjauksia, jotka toteutatte itse tai tekoälyavustajanne kanssa. Varmuuskopiot salataan joka yö ja säilytetään koneen ulkopuolella, niiden palautus sisältyy, ja nykyisen palvelimenne siirto tehdään veloituksetta.
Kyllä. Actual Budget julkaistaan MIT-lisenssillä: voitte käyttää, muokata ja jakaa sitä edelleen vapaasti itsellenne tai yritykselle, kunhan sen tekijänoikeus- ja lisenssi-ilmoitus säilyy kopioissa. Jäljelle jää sen pyörittävän palvelimen kustannus.
Työpöytäsovellukset toimivat itsenäisesti. Palvelin, jota dokumentaatio suosittelee painokkaasti, lisää verkko- ja mobiilisovelluksen, synkronoinnin laitteiden välillä, pankkisynkronoinnin ja rajapinnan. Jokainen laite säilyttää täydellisen kopion budjeteistanne palvelimen kanssa synkronoituna.
Luokaa compose.yaml, jossa on image actualbudget/actual-server, portti 5006 julkaistuna osoitteessa 127.0.0.1 ja polkuun /data liitetty datakansio, ja ajakaa docker compose up -d. Asettakaa sen jälkeen eteen HTTPS:llä toimiva käänteinen välityspalvelin ja avatkaa osoitteenne palvelimen salasanan valitsemiseksi.
Sovellus tarvitsee SharedArrayBuffer-ominaisuutta, jonka selaimet ottavat käyttöön vain HTTPS:llä tarjotulla sivulla otsakkeiden Cross-Origin-Embedder-Policy ja Cross-Origin-Opener-Policy kanssa. Palvelin asettaa nämä otsakkeet; käänteinen välityspalvelin tuo HTTPS:n. Vain localhostin kautta käytettäessä sitä ei tarvita.
Tarjotkaa instanssi HTTPS:llä, valitkaa vahva palvelimen salasana tai käyttäkää OpenID:tä kaksivaiheisen tunnistautumisen kanssa ja ottakaa käyttöön päästä päähän -salaus: palvelin ei enää voi lukea budjettejanne. Säilyttäkää tämä toinen salasana turvassa, koska sitä ei voi palauttaa.
Kyllä, pankkitietojen palveluntarjoajan kautta omilla tunnuksillanne: SimpleFIN Bridge, GoCardless Bank Account Data olemassa oleville tileille, Pluggy.ai sekä kokeellisina ominaisuuksina Enable Banking ja Akahu. Synkronointi tarvitsee palvelimen, ja se voi toimia automaattisesti versiosta 26.11.0 alkaen.
Kopioikaa palvelimen datakansio palvelimen ollessa pysäytettynä: server-files sisältää tilit ja tunnukset, user-files budjetit. Viekää myös jokainen budjetti kohdasta Settings, Export data, ja säilyttäkää nämä kopiot salattuina. Vienti palautetaan kohdasta Import file.
Managed VPS kattaa palvelimen: järjestelmän, tietoturvan, valvonnan ja varmuuskopiot. Tiimimme seuraavat myös instanssianne proaktiivisesti ja suosittelevat hyödyllisiä korjauksia, jotka toteutatte itse. Toimenpide sovelluksessa laskutetaan tuntiveloituksella tai kiinteällä hinnalla.
Simafri
Jutellaan hankkeestasi
Kerro meille muutamalla sanalla, mitä tarvitset: vastaamme sinulle nopeasti.
Kiitos! Pyyntösi on lähetetty. Vastaamme sinulle pian.
Suositko sähköpostia? Kirjoita meille osoitteeseen support@simafri.com.