Actual Budget ను మీ సొంత VPS లో హోస్ట్ చేయడం ఎలా?
Docker Compose ఉపయోగించి Actual Budget ను VPS లో సెటప్ చేయండి. HTTPS అవసరం, డేటా వాల్యూమ్ కాన్ఫిగరేషన్, బ్యాంక్ ఇంపోర్ట్స్ మరియు బ్యాకప్ పద్ధతుల గురించి పూర్తి వివరాలు ఇక్కడ ఉన్నాయి.
మీరు నిర్మించేది
Actual Budget అనేది self-hosted envelope budgeting app. స్వయంగా host చేయగల YNAB ప్రత్యామ్నాయం కోసం చూసేవారికి ఇది సాధారణంగా సూచించే ఎంపిక. server ఒక container, ఒక data volume, ఒక HTTPS పేరు కలిగి ఉంటుంది. server ప్రధానంగా files ను నిల్వ చేసి, వాటిని sync చేస్తుంది.
మీరు ఏదైనా టైప్ చేయడానికి ముందు architecture ను అర్థం చేసుకోవాలి. అసలు budget అనేది మీ browser లోను, ప్రతి mobile app లోను ఉండే SQLite database. మీరు ఇప్పుడు install చేయబోయే server ఒక sync endpoint. ఇది account list, budget files, అలాగే phone మరియు laptop లోని ప్రతులు సమన్వయంగా ఉండేందుకు అవసరమైన change log ను నిల్వ చేస్తుంది. అందువల్ల server down అయినా app పనిచేస్తూనే ఉంటుంది. ఒక client వద్ద budget ప్రతిలో ఒకటి ఇంకా ఉంటే, server కోల్పోయినా మీ budget కోల్పోరు.
సర్వర్కు HTTPS ఎందుకు అవసరం
Actual కు HTTPS అవసరం. ఇది కేవలం లాంఛనం కాదు. Actual సరిగా పనిచేయడానికి SharedArrayBuffer అనే browser feature అవసరం. Browsers ఈ feature ను specification లో secure context అని పిలిచే cross-origin isolated page లో మాత్రమే enable చేస్తాయి. Secure context అనేది https:// లేదా http://localhost. మరో machine లోని browser ద్వారా http://203.0.113.10:5006 నుంచి app ను load చేస్తే, browser ఆ feature ను page కు అందించదు. అందువల్ల budget load కాదు. Phones కు దీనిలో మినహాయింపు లేదు. Actual యొక్క FAQ ప్రకారం official iOS app beta testing లో ఉంది. ఇది మీ స్వంత server కు connect అవుతుంది. ఇంకా official Android app లేదు. కాబట్టి చాలా phones లో మీరు అదే web app ను home screen కు Progressive Web App గా install చేసి ఉపయోగిస్తారు. అదే secure-context నియమం అక్కడ కూడా వర్తిస్తుంది.
కాబట్టి ఉపయోగించగల setup లు రెండు ఉన్నాయి. Container ముందు ఉన్న నిజమైన name పై నిజమైన certificate ఉంచడం మొదటి విధానం. ఈ guide లో ఇదే విధానాన్ని ఉపయోగిస్తాము. లేదా ACTUAL_HTTPS_KEY మరియు ACTUAL_HTTPS_CERT తో server కు self-signed certificate ఇవ్వవచ్చు. ఈ విధానాన్ని project documentation లో వివరించింది. అయితే ప్రతి device లో browser warning ను అంగీకరించాలి. Let's Encrypt నుంచి ఉచిత certificate పొందడానికి ఐదు నిమిషాలు మాత్రమే పడుతుంది. కాబట్టి మొదటి విధానాన్ని ఎంచుకోండి.
Docker Compose తో Actual Budget ఇన్స్టాల్ చేయడం
సర్వర్ కొత్తదైతే ముందుగా Docker ను ఇన్స్టాల్ చేయండి. Compose file syntax మీకు కొత్తగా ఉంటే, దిగువన ఉపయోగించిన fields గురించి VPS కోసం Docker Compose ప్రాథమికాలు గైడ్లో వివరించబడింది.
sudo install -d -m 755 /opt/actual
sudo install -d -m 700 /opt/actual/data/opt/actual/docker-compose.yml ను రాయండి:
services:
actual:
image: actualbudget/actual-server:latest
container_name: actual
restart: unless-stopped
ports:
- '127.0.0.1:5006:5006'
volumes:
- ./data:/dataఆ file లోని మూడు వివరాలు ముఖ్యమైనవి.
Image actualbudget/actual-server:latest. దీన్ని project Docker Hub లో publish చేసింది. ఇది ghcr.io/actualbudget/actual వద్ద mirror చేయబడింది. తక్కువ power ఉన్న machines కోసం latest-alpine tag ఉంది.
Container మొత్తం డేటాను /data కింద రాస్తుంది. దాని లోపల server-files ఉంటుంది. ఇందులో మీ login మరియు session tokens ఉన్న account.sqlite ఉంటుంది. అలాగే budget files ఉన్న user-files ఉంటుంది. Container ను replace చేసినా మీ budget నిలిచి ఉండేందుకు ఆ path ను mount చేయండి. ACTUAL_DATA_DIR తో దాన్ని మార్చవచ్చు. అయితే default సరిపోతుంది.
Port 127.0.0.1 పై మాత్రమే publish అవుతుంది. సాధారణ 5006:5006 అన్ని interfaces పై publish చేస్తుంది. Docker తన rules ను ufw కంటే ముందు రాస్తుంది. అందువల్ల deny-all firewall ఉన్నా app internet కు తెరవబడుతుంది. ఆ అనూహ్య ప్రవర్తన గురించి Docker published ports ufw ను ఎందుకు దాటుతాయి లో వివరించబడింది. Loopback కు bind చేయడం వల్ల అదే server లోని reverse proxy మాత్రమే దాన్ని చేరుకోగలదు.
దాన్ని ప్రారంభించండి:
cd /opt/actual
docker compose up --detach
docker compose logs -f actualServer port 5006 పై listening చేస్తున్నట్లు నివేదించిన తర్వాత log స్థిరపడుతుంది. DNS ను మార్చే ముందు స్థానికంగా తనిఖీ చేయండి:
curl -fsS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:5006/200 అంటే app requests ను serve చేస్తోంది. curl: (7) Failed to connect అంటే 127.0.0.1:5006 పై connection ను స్వీకరించినది ఏదీ లేదని అర్థం. docker compose ps --all ను run చేయండి. ఎందుకంటే plain docker compose ps ప్రస్తుతం running లో ఉన్న containers ను మాత్రమే list చేస్తుంది. Container exited గా కనిపిస్తే, సాధారణ కారణం mounted volume పై permission problem. ఇది log లో EACCES line గా కనిపిస్తుంది.
సర్టిఫికేట్ మరియు నిజమైన hostname ను ముందు ఉంచండి
VPS కు A record ను సూచించండి, budget.example.com, అది resolve అయ్యే వరకు వేచి ఉండండి. తరువాత nginx ను install చేసి certificate ను జారీ చేయండి. Ubuntu 24.04లో nginxతో Certbot guide లో certificate జారీ మరియు renewal timer గురించి పూర్తి వివరాలు ఉన్నాయి.
Proxy block:
server {
listen 443 ssl;
http2 on;
server_name budget.example.com;
ssl_certificate /etc/letsencrypt/live/budget.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/budget.example.com/privkey.pem;
client_max_body_size 100m;
location / {
proxy_pass http://127.0.0.1:5006;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}client_max_body_size అనేది తరచుగా మర్చిపోయే line. రోజువారీ sync లో మీ మార్పులు మాత్రమే పంపబడతాయి. కానీ మీరు మొదటిసారి serverతో budget ను register చేసినప్పుడు, అలాగే sync ను reset చేసిన ప్రతిసారి, మొత్తం budget file upload అవుతుంది. Nginx యొక్క default request body పరిమితి 1 MB. అందువల్ల file పరిమాణం దాన్ని మించినప్పుడు, ఆ పూర్తి uploads విఫలమవుతాయి. Nginx access logలో 413 Request Entity Too Large కనిపిస్తుంది, అయితే app సాధారణ sync error మాత్రమే చూపిస్తుంది. Serverకు స్వంత పరిమితులు కూడా ఉన్నాయి: ACTUAL_UPLOAD_FILE_SYNC_SIZE_LIMIT_MB యొక్క default విలువ 20, ACTUAL_UPLOAD_SYNC_ENCRYPTED_FILE_SYNC_SIZE_LIMIT_MB యొక్క default విలువ 50. కాబట్టి మీకు వర్తించే పరిమితి కంటే nginx పరిమితిని ఎక్కువగా సెట్ చేయండి.
Reload చేసి పరీక్షించండి:
sudo nginx -t && sudo systemctl reload nginx
curl -fsS -o /dev/null -w '%{http_code}\n' https://budget.example.com/మొదటి ప్రారంభం: పాస్వర్డ్ మరియు మీ మొదటి budget file
బ్రౌజర్లో https://budget.example.com ను తెరవండి. మొదటి screen లో server password సెట్ చేయమని అడుగుతుంది. ఆ ఒక్క password మొత్తం server ను రక్షిస్తుంది. అందువల్ల పొడవైన random password ను రూపొందించి, మళ్లీ కనుగొనగలిగే సురక్షిత ప్రదేశంలో భద్రపరచండి. ఉదాహరణకు, self-hosted Vaultwarden password manager లో ఉంచవచ్చు. ప్రారంభంగా user accounts సృష్టించాల్సిన అవసరం ఉండదు. ఈ server లో ఒకే password ఉంటుంది. కాబట్టి budget ను పంచుకోవడం అంటే ఆ password ను పంచుకోవడమే. OpenID provider ను అనుసంధానించినప్పుడు మాత్రమే ప్రత్యేక logins సాధ్యమవుతాయి. Actual multi-user setups కోసం దీనికి మద్దతు ఇస్తుంది.
తర్వాత ఒక budget file ను సృష్టించండి. Settings తెరిచి, Encryption section లో Enable encryption పై click చేయండి. దాన్ని enable చేసిన తర్వాత, మీ budget data కోసం ciphertext మాత్రమే server లో నిల్వ ఉంటుంది. అద్దెకు తీసుకున్న machine లో financial data కోసం ఇది సరైన విధానం. అయితే దీనికి నిజమైన ప్రమాదం ఉంది. Encryption password server కు ఎప్పుడూ పంపబడదు. కాబట్టి దాన్ని కోల్పోయి, budget యొక్క local copy కూడా లేకపోతే file పూర్తిగా పోతుంది. Local copy మిగిలి ఉంటే, encryption key ను reset చేసి మళ్లీ sync చేయవచ్చు. ఆ screen ను దాటి వెళ్లే ముందు password ను రాసి భద్రపరచండి.
సంవత్సరాల చరిత్రను import చేయకుండా, మీ bank లో ప్రస్తుతం కనిపిస్తున్న figures ఆధారంగా starting balances సెట్ చేయండి. Envelope budgeting ప్రస్తుతం మీ వద్ద ఉన్న డబ్బు నుంచి ముందుకు లెక్కిస్తుంది. అందువల్ల చరిత్ర ఖాళీగా ఉండటం వల్ల మీకు నష్టం ఉండదు.
లావాదేవీలను దిగుమతి చేసుకోవడం
ఇక్కడ ఉత్సాహం కంటే నిజాయితీ ముఖ్యం. Self-hosted budgeting ను చాలామంది వదిలివేయడానికి ప్రధాన కారణం import విధానం ఎలా పనిచేస్తుందన్నదే.
Manual entry ప్రాథమిక విధానం, ఇది ఎల్లప్పుడూ పనిచేస్తుంది. Envelope method లో ఇది అసలు ఉద్దేశమే కావచ్చు, ఎందుకంటే కొనుగోలును టైప్ చేయడం వల్ల దానిని మీరు గమనిస్తారు.
File import ద్వారా ఎక్కువ లావాదేవీలను నిర్వహించవచ్చు. Actual CSV, QIF, OFX, QFX మరియు CAMT ఫైళ్లను చదవగలదు. Account screen నుంచి ప్రతి account కు విడిగా import చేయండి. File CSV అయితే columns ను map చేయండి.
Automatic bank sync అందుబాటులో ఉంది. అయితే server స్వయంగా banks తో మాట్లాడలేడు కాబట్టి third-party service అవసరం. North American banks కోసం Actual SimpleFIN Bridge కు, Europe కోసం Enable Banking కు, New Zealand కోసం Akahu కు, Brazil కోసం Pluggy.ai కు మద్దతు ఇస్తుంది. GoCardless కు ఇంకా మద్దతు ఉంది, కానీ కొత్త accounts ను స్వీకరించడం లేదు. మీరు provider వద్ద స్వయంగా sign up చేసి, credentials ను generate చేసి, వాటిని server కు జోడించాలి. October 2026 నాటికి SimpleFIN Bridge, గరిష్ఠంగా 25 institutions కోసం, tax తో పాటు సంవత్సరానికి 15 US dollars వసూలు చేస్తుంది. ఇతర providers ధరలను వేరుగా నిర్ణయిస్తాయి.
దీనిపై ఆధారపడే ముందు రెండు పరిమితులను అంగీకరించాలి. API credentials server లోనే ఉంటాయి. అవి end-to-end encryption పరిధిలోకి రావు, ఎందుకంటే server వాటిని ఉపయోగించాలి. అలాగే Actual మూసివేసి ఉన్నప్పుడు ఏదీ sync కాదు. Automatic syncing default గా off లో ఉంటుంది. దాన్ని on చేసిన తర్వాత కూడా app తెరిచి ఉన్నప్పుడే అది నడుస్తుంది. అందువల్ల server స్వయంగా మీ banks ను poll చేయదు.
Backups, because it is only files
మీరు శ్రద్ధ వహించే మొత్తం డేటా /opt/actual/data కింద ఉంటుంది. ప్రత్యేకంగా export చేయాల్సిన దశ లేదు. Script చేయాల్సిన database dump కూడా లేదు.
ఇక్కడ ప్రధానంగా జాగ్రత్త పడాల్సింది SQLite విషయంలో. Server దానికి రాస్తున్న సమయంలో account.sqlite ను copy చేస్తే, పూర్తికాని transaction అందులో చేరవచ్చు. Restore చేయడానికి ప్రయత్నించే వరకు ఈ విషయం మీకు తెలియకపోవచ్చు. Copy పూర్తయ్యే కొద్ది సెకన్ల పాటు container ను stop చేయండి:
cd /opt/actual
docker compose stop
restic -r sftp:backup@backup.example.com:/srv/restic backup /opt/actual/data
docker compose startదీన్ని VPSలో restic backups విధానంతో schedule చేయండి. ఆ విధానం repository setup, retention మరియు restore drill ను వివరిస్తుంది. Restore drill ను తప్పనిసరిగా అమలు చేయండి. ఎప్పుడూ restore చేయని backup ఒక ఊహ మాత్రమే.
Actual యొక్క automatic backups వేరే విధానం. వాటి గురించి తెలుసుకోవడం ఉపయోగకరం. అయితే అవి desktop app లో మాత్రమే అందుబాటులో ఉంటాయి. Budget file యొక్క ఇటీవలి 10 copies వరకు ఇది ఉంచుతుంది. వాటిని File > Load Backup ద్వారా పొందవచ్చు. అందువల్ల server ను తాకకుండా "పొరపాటున category ను తొలగించాను" వంటి సమస్యను పరిష్కరించవచ్చు. Browser లోని web app ఇలాంటి copies ఏవీ ఉంచదు. కాబట్టి ఇంట్లో అందరూ browser ను ఉపయోగిస్తే, పైన పేర్కొన్న server backup ను schedule చేయండి. Settings > Export data ద్వారా manual budget backup ను కూడా save చేయవచ్చు.
సర్వర్ను నవీకరించడం
cd /opt/actual
docker compose pull
docker compose up --detachCompose కొత్త image నుంచి container ను మళ్లీ సృష్టించి, అదే volume ను తిరిగి జత చేస్తుంది. అందువల్ల data అలాగే ఉంటుంది. Clients ను కూడా నవీకరించండి. అందుకునే data కంటే పాత client మార్పులను వర్తింపజేయడం ఆపి, Update Required సందేశాన్ని చూపిస్తుంది. నవీకరించే ముందు backup తీసుకోండి. ఎందుకంటే కొత్త version లో తెరిచిన budget, పాత client తో అనుకూలంగా ఉండకపోవచ్చు. Actual floating latest tag ను సిఫారసు చేస్తుంది. అయితే ఇది ఇప్పటికీ SQLite databases ను ఉపయోగిస్తుంది. Chatwoot ను self-host చేయడంలో pinned tags మరియు ఆ విధానం కోరే pre-upgrade dump గురించి దశలవారీగా వివరించబడింది.
ఏవి విఫలమవుతాయి, మీరు ఏమి చూస్తారు
అప్లికేషన్ లోడ్ అవుతుంది, కానీ sync ఎప్పటికీ పూర్తికాదు. nginx access log లో 413 కోసం చూడండి. అంటే client_max_body_size విలువ చాలా తక్కువగా ఉంది. 502 కనిపిస్తే, nginx కు upstream నుంచి ఉపయోగించగల response అందలేదని అర్థం. సాధారణంగా container ఆగిపోయి ఉంటుంది లేదా 5006 పై listening చేయడం లేదు. అందువల్ల మరేదైనా పరిశీలించే ముందు docker compose ps --all మరియు container log ను తనిఖీ చేయండి.
మరొక device లో అప్లికేషన్ లోడ్ కాదు, లేదా SharedArrayBuffer లేదని చూపిస్తుంది. పేజీ HTTPS ఉపయోగిస్తోందా, Actual నుంచి cross-origin isolation headers అందుకుంటోందా తనిఖీ చేయండి. address bar లో IP address లేదా localhost కాని hostname తో http:// కనిపిస్తే, workaround చేయకుండా certificate ను సరిచేయండి.
బడ్జెట్ file ఈ version కు అనుకూలంగా లేదని message కనిపిస్తుంది. మీరు ప్రస్తుతం ఉపయోగిస్తున్న client కంటే కొత్త Actual version లో file తెరవబడింది. client ను కనీసం ఆ version కు update చేయండి. లేదా కొత్త version file ను మార్చే ముందు తీసిన backup ను restore చేసి, తరువాత reload చేయండి.
container loop లో restart అవుతుంది. docker compose logs actual చదవండి. /data పై permission error కనిపిస్తే, mounted directory container user కు writable గా లేదు. address-in-use error కనిపిస్తే, loopback పై 5006 ను ఇప్పటికే మరేదో ఉపయోగిస్తోంది.
మొదటి load నెమ్మదిగా అనిపిస్తుంది. device లో మొదటిసారి తెరిచినప్పుడు మొత్తం budget file browser కు download అవుతుంది. ఇది ఒక పెద్ద transfer, ఆ తరువాత local reads జరుగుతాయి. ఇది server sizing సమస్య కాదు. RAM పెంచినా వేగం మారదు.
FAQ
Actual Budget పనిచేయడానికి HTTPS అవసరమా?
అవును, ఆచరణలో అవసరం. Actual పనిచేయడానికి browser యొక్క SharedArrayBuffer ఫీచర్ అవసరం. Browsers ఈ ఫీచర్ను secure context లో మాత్రమే enable చేస్తాయి. అంటే https:// లేదా http://localhost అవసరం. మరొక machine నుంచి plain HTTP ఉపయోగిస్తే app load కాదు. అధికారిక iOS app ప్రస్తుతం beta testing లో ఉంది. అధికారిక Android app ఇంకా లేదు. అందువల్ల చాలా phones ఇదే web app ను ఉపయోగిస్తాయి మరియు ఇదే నియమానికి లోబడి ఉంటాయి. (FAQ) నిజమైన hostname పై Let's Encrypt certificate ఉపయోగించండి. ప్రతి device లో certificate warning ను అంగీకరించగలిగితే ACTUAL_HTTPS_KEY మరియు ACTUAL_HTTPS_CERT తో self-signed certificate కూడా ఉపయోగించవచ్చు.
Actual నా bank transactions ను స్వయంచాలకంగా import చేయగలదా?
మీరు స్వయంగా sign up చేసే third-party service ద్వారా మాత్రమే చేయగలదు: North America లో SimpleFIN Bridge, Europe లో Enable Banking, New Zealand లో Akahu లేదా Brazil లో Pluggy.ai. GoCardless కు support ఉంది. అయితే అది కొత్త accounts ను అంగీకరించడం లేదు. ఆ API credentials మీ server లోనే ఉంటాయి. వాటికి end-to-end encryption వర్తించదు. Automatic syncing default గా off లో ఉంటుంది. Enable చేసిన తర్వాత Actual open గా ఉన్న సమయంలో మాత్రమే అది నడుస్తుంది. అందువల్ల server పై background లో ఏదీ polling చేయదు. CSV, QIF, OFX, QFX మరియు CAMT import కు ఎలాంటి third party అవసరం లేదు.
నేను ఖచ్చితంగా ఏవాటిని backup చేయాలి?
ఈ guide లో /opt/actual/data గా పేర్కొన్న mounted data directory ను backup చేయాలి. ఇందులో logins మరియు sessions ఉన్న server-files/account.sqlite, budget files ఉన్న user-files ఉంటాయి. Copy చేయడానికి ముందు container ను stop చేయండి. Live SQLite database ను copy చేస్తే partial write capture కావచ్చు. Server లో మరే ఇతర state ఉండదు.
Encryption password పోతే ఏమవుతుంది?
Budget యొక్క local copy ఇంకా మీ వద్ద ఉంటే encryption key ను reset చేసి మళ్లీ sync చేయవచ్చు. Password మరియు అన్ని local copies రెండూ పోయినట్లయితే encrypted file ను recover చేయలేరు. File ను సృష్టించిన వెంటనే దాని password ను password manager లో store చేయండి. ఇదే server పై ఆధారపడని వేరే ప్రదేశంలో ఒక copy ఉంచండి.
Actual Budget కు ఎంత server అవసరం?
చాలా తక్కువ. Container static assets మరియు files ను serve చేస్తుంది. Budget calculations browser లో జరుగుతాయి. Disk pressure మీ backups మరియు ఇతర containers వల్ల వస్తుంది. Actual వల్ల కాదు. Actual తో పాటు ఎక్కువ resources అవసరమైన మరొక software నడపాల్సిన server ను size చేస్తుంటే, సాధారణంగా photo server అవసరాలను బట్టి కనీస సామర్థ్యం నిర్ణయించబడుతుంది. అందువల్ల plan ఎంచుకునే ముందు PhotoPrism మరియు Immich కు వాస్తవంగా ఎంత RAM అవసరమో చూడండి. Media stack కు కూడా ఇదే విధానం వర్తిస్తుంది. Plan ను transcoding నిర్ణయిస్తుంది. అదే సమయంలో Jellyfin library ను 90s నాటి నడిచి చూడగలిగే video store గా మార్చే Halcyon వంటి browser front end కు Actual కు అవసరమైనంత తక్కువ resources సరిపోతాయి.