Actual Budget कसे होस्ट करावे: संपूर्ण मार्गदर्शक
Actual Budget ला Docker Compose वापरून VPS वर कसे होस्ट करावे हे शिका. HTTPS सेटअप, डेटा व्हॉल्यूम कॉन्फिगरेशन, बँक इम्पोर्ट आणि सुरक्षित बॅकअप घेण्याच्या पद्धतींची सविस्तर माहिती.
तुम्ही काय तयार करणार आहात
Actual Budget हे self-hosted envelope budgeting अॅप आहे. स्वतः host करता येणाऱ्या YNAB पर्यायाचा शोध घेताना हेच अॅप सर्वसाधारणपणे निवडले जाते. सर्व्हरमध्ये एक container, एक data volume आणि एक HTTPS नाव असते. सर्व्हर प्रामुख्याने फाइल्स साठवतो आणि त्यांचे sync करतो.
काहीही टाइप करण्यापूर्वी या architecture ची रचना समजून घेणे उपयुक्त ठरते. Budget स्वतः SQLite database असतो. तो तुमच्या browser मध्ये आणि प्रत्येक mobile app मध्ये असतो. तुम्ही आता install करणार असलेला सर्व्हर हा sync endpoint आहे. तो account list, budget files आणि change log साठवतो. या change log मुळे फोन आणि laptop मधील माहिती समान ठेवता येते. म्हणून सर्व्हर down असतानाही अॅप कार्यरत राहते. तसेच, किमान एका client कडे budget ची प्रत असल्यास सर्व्हर गमावला तरी तुमचा budget गमावत नाही.
सर्व्हरला HTTPS का आवश्यक आहे
Actual ला HTTPS आवश्यक आहे. ही केवळ औपचारिकता नाही. Actual ला SharedArrayBuffer नावाचे browser feature कार्यान्वित होण्यासाठी आवश्यक आहे. Browsers हे feature तेव्हाच enable करतात, जेव्हा page specification मध्ये secure context म्हटलेल्या cross-origin isolated स्थितीत असते. Secure context म्हणजे https:// किंवा http://localhost. दुसऱ्या मशीनवरील 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 वापरता. ती Progressive Web App म्हणून home screen वर install करता येते. त्यावरही तोच secure-context नियम लागू होतो.
म्हणून दोन व्यवहार्य मांडण्या आहेत. Container समोर खऱ्या नावासाठी real certificate configure करा. हीच पद्धत या मार्गदर्शकात वापरली आहे. किंवा ACTUAL_HTTPS_KEY आणि ACTUAL_HTTPS_CERT वापरून server ला self-signed certificate द्या. ही पद्धत project च्या documentation मध्ये दिली आहे. मात्र प्रत्येक device वर browser warning स्वीकारावी लागेल. Let's Encrypt कडून free certificate मिळवण्यासाठी पाच मिनिटे पुरेशी आहेत. त्यामुळे पहिला पर्याय वापरा.
Docker Compose वापरून Actual Budget इंस्टॉल करा
सिस्टम नवीन असेल, तर आधी Docker इंस्टॉल करा. Compose file syntax तुमच्यासाठी नवीन असल्यास, VPS साठी Docker Compose ची मूलतत्त्वे या मार्गदर्शिकेत खाली वापरलेल्या fields चे स्पष्टीकरण आहे.
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 केली आहे. कमी क्षमतेच्या machines साठी latest-alpine tag उपलब्ध आहे.
container सर्व डेटा /data अंतर्गत लिहितो. त्यामध्ये server-files मिळते. त्यात तुमचे login आणि session tokens असलेले account.sqlite असते. तसेच user-files असते. त्यात budget files असतात. container बदलला तरी तुमचे budget टिकून राहण्यासाठी तो path mount करा. ACTUAL_DATA_DIR वापरून तो path बदलता येतो; परंतु default योग्य आहे.
port केवळ 127.0.0.1 वर publish केला आहे. साधा 5006:5006 वापरल्यास port प्रत्येक interface वर publish होतो. Docker स्वतःचे rules ufw च्या आधी लागू करतो. त्यामुळे deny-all firewall असतानाही अॅप internet वर उघडे राहू शकते. हा अनपेक्षित परिणाम Docker चे published ports ufw ला का bypass करतात येथे स्पष्ट केला आहे. loopback वर bind केल्यामुळे त्याच box वरील 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 म्हणजे अॅप requests serve करत आहे. curl: (7) Failed to connect म्हणजे 127.0.0.1:5006 वर कोणत्याही process ने connection स्वीकारले नाही. docker compose ps --all चालवा, कारण साधा docker compose ps फक्त चालू containers दाखवतो. container exited स्थितीत दिसत असल्यास, mounted volume वरील permission problem हे नेहमीचे कारण असते. log मधील EACCES line मध्ये ते दिसते.
समोर प्रमाणपत्र आणि वास्तविक नाव जोडा
VPS कडे A record निर्देशित करा, budget.example.com, आणि तो resolve होईपर्यंत प्रतीक्षा करा. त्यानंतर nginx install करा आणि प्रमाणपत्र issue करा. Ubuntu 24.04 वर nginx सह Certbot या मार्गदर्शकात issuance आणि 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 ही ओळ अनेकदा विसरली जाते. दैनंदिन sync मध्ये फक्त तुमचे बदल पाठवले जातात. परंतु तुम्ही server वर एखादा budget प्रथम register करता तेव्हा आणि sync reset करता तेव्हा संपूर्ण budget file upload केली जाते. Nginx मध्ये request body ची default मर्यादा 1 MB असते. त्यामुळे file या मर्यादेपेक्षा मोठी झाल्यावर हे पूर्ण uploads अयशस्वी होतात. nginx access log मध्ये 413 Request Entity Too Large दिसते, तर app मध्ये फक्त generic 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/पहिल्यांदा चालू करणे: पासवर्ड आणि तुमची पहिली बजेट फाइल
ब्राउझरमध्ये https://budget.example.com उघडा. पहिल्या स्क्रीनवर सर्व्हरचा पासवर्ड सेट करण्यास सांगितले जाईल. हा एकच पासवर्ड संपूर्ण सर्व्हरचे संरक्षण करतो. त्यामुळे मोठा, यादृच्छिक पासवर्ड तयार करा आणि तो पुन्हा सापडेल अशा सुरक्षित ठिकाणी जतन करा, उदाहरणार्थ self-hosted Vaultwarden पासवर्ड व्यवस्थापकात. सुरुवातीला तयार करण्यासाठी कोणतीही user accounts नसतात. सर्व्हरसाठी एकच पासवर्ड असल्यामुळे बजेट share करण्याचा अर्थ तो पासवर्ड share करणे असा होतो. OpenID provider जोडल्यावरच वेगवेगळे logins वापरता येतात. Multi-user setups साठी Actual याला समर्थन देते.
यानंतर budget file तयार करा. Settings उघडा आणि Encryption विभागात Enable encryption वर क्लिक करा. Encryption सक्षम केल्यावर सर्व्हर तुमच्या बजेट डेटासाठी केवळ ciphertext साठवतो. भाड्याने घेतलेल्या मशीनवरील financial data साठी हा योग्य पर्याय आहे. मात्र त्याची वास्तविक किंमत आहे: encryption password सर्व्हरपर्यंत कधीही पोहोचत नाही. त्यामुळे तो हरवला आणि budget ची कोणतीही local copy उपलब्ध नसेल, तर फाइल कायमची गमावली जाईल. Local copy उपलब्ध असल्यास encryption key reset करून पुन्हा sync करता येते. त्या स्क्रीनमधून पुढे जाण्यापूर्वी तो लिहून ठेवा.
तुमच्या bank च्या सध्याच्या आकडेवारीनुसार starting balances सेट करा. अनेक वर्षांचा इतिहास import करण्याची गरज नाही. Envelope budgeting तुमच्याकडे सध्या असलेल्या पैशांपासून पुढे काम करते. त्यामुळे जुना इतिहास नसल्याने तुमचे काहीही नुकसान होत नाही.
व्यवहार नोंदवणे
येथे उत्साहापेक्षा प्रामाणिकपणा अधिक महत्त्वाचा आहे. Self-hosted budgeting पासून लोक दूर जाण्याचे मुख्य कारण म्हणजे import प्रक्रिया.
हाताने नोंद करणे हा मूलभूत पर्याय आहे आणि तो नेहमी कार्य करतो. Envelope पद्धतीसाठी हा पर्यायच मुख्य उद्देश आहे असे म्हणता येईल, कारण खरेदीची नोंद टाइप केल्यामुळे ती तुमच्या लक्षात येते.
File import मोठ्या प्रमाणातील नोंदी हाताळतो. Actual CSV, QIF, OFX, QFX आणि CAMT फाइल्स वाचतो. Account screen मधून प्रत्येक account साठी import करा. फाइल CSV असल्यास columns चे mapping करा.
Automatic bank sync उपलब्ध आहे. यासाठी third-party service आवश्यक आहे, कारण server स्वतःहून banks शी संवाद साधू शकत नाही. Actual उत्तर अमेरिकेतील banks साठी SimpleFIN Bridge, युरोपसाठी Enable Banking, New Zealand साठी Akahu आणि Brazil साठी Pluggy.ai समर्थित करतो. GoCardless अजूनही समर्थित आहे, परंतु तो नवीन accounts स्वीकारत नाही. Provider कडे स्वतः sign up करा, credentials तयार करा आणि ती server मध्ये जोडा. October 2026 पर्यंत SimpleFIN Bridge 25 institutions पर्यंतच्या वापरासाठी tax व्यतिरिक्त दरवर्षी 15 US dollars आकारतो. इतर services ची किंमत वेगळी आहे.
यावर अवलंबून राहण्यापूर्वी दोन मर्यादा लक्षात घ्या. API credentials server वर साठवले जातात आणि end-to-end encryption अंतर्गत संरक्षित नसतात, कारण server ला त्यांचा वापर करावा लागतो. तसेच Actual बंद असताना काहीही sync होत नाही. Automatic syncing default ने बंद असते. ती सुरू केल्यानंतरही ती फक्त app उघडे असतानाच चालते. त्यामुळे server स्वतःहून तुमच्या banks ला poll करत नाही.
बॅकअप, कारण येथे फक्त फाइल्स आहेत
तुमच्यासाठी महत्त्वाची प्रत्येक गोष्ट /opt/actual/data अंतर्गत आहे. कोणताही export टप्पा नाही आणि script करण्यासाठी database dump देखील नाही.
एक महत्त्वाचा अपवाद SQLite आहे. सर्व्हर त्यात लिहित असताना account.sqlite कॉपी केल्यास अर्धवट पूर्ण झालेला transaction कॉपीमध्ये येऊ शकतो. Restore करण्याचा प्रयत्न करेपर्यंत हे लक्षात येणार नाही. कॉपी पूर्ण होण्यासाठी लागणाऱ्या काही सेकंदांसाठी container थांबवा:
cd /opt/actual
docker compose stop
restic -r sftp:backup@backup.example.com:/srv/restic backup /opt/actual/data
docker compose startVPS वरील restic बॅकअप मधील पद्धत वापरून हे schedule वर चालवा. त्या पद्धतीत repository setup, retention आणि restore drill समाविष्ट आहेत. Restore drill प्रत्यक्ष चालवा. ज्या बॅकअपमधून तुम्ही कधीही restore केलेले नाही, तो केवळ अंदाज असतो.
Actual चे automatic backups ही वेगळी सुविधा आहे आणि तिची माहिती असणे उपयुक्त आहे. मात्र ती फक्त desktop app मध्ये उपलब्ध आहे. ती budget file च्या अलीकडील जास्तीत जास्त 10 प्रती ठेवते. त्या File > Load Backup मधून उघडता येतात. त्यामुळे सर्व्हरला हात न लावता “चुकून एखादी category हटवली” ही समस्या सोडवता येते. Browser मधील web app अशा प्रती ठेवत नाही. त्यामुळे घरातील प्रत्येकजण browser वापरत असल्यास, वर दिलेला server backup schedule वर चालवा. Settings > Export data मधून तुम्ही budget ची manual backup प्रत देखील जतन करू शकता.
सर्व्हर अपडेट करणे
cd /opt/actual
docker compose pull
docker compose up --detachCompose नवीन image मधून container पुन्हा तयार करते आणि तोच volume पुन्हा जोडते. त्यामुळे डेटा सुरक्षित राहतो. Clients देखील अपडेट करा. प्राप्त होणाऱ्या डेटापेक्षा जुना client बदल लागू करणे थांबवतो आणि Update Required संदेश दाखवतो. अपडेट करण्यापूर्वी backup घ्या, कारण नवीन आवृत्तीत उघडलेले budget जुन्या client शी सुसंगत नसू शकते. Actual floating latest tag वापरण्याची शिफारस करते. मात्र, ते अजूनही SQLite databases वापरते. Chatwoot चे self-hosting या पद्धतीनुसार pinned tags आणि update करण्यापूर्वीचा dump यांची माहिती देते.
काय बिघडते आणि तुम्हाला काय दिसेल
अॅप लोड होते, पण sync कधीही पूर्ण होत नाही. `413 साठी nginx access log तपासा. याचा अर्थ 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://` दिसत असल्यास त्यावर तात्पुरता उपाय करण्याऐवजी certificate दुरुस्त करा.
budget file या version शी compatible नसल्याचा संदेश दिसतो. तुम्ही सध्या वापरत असलेल्या client पेक्षा Actual च्या नवीन version मध्ये ही file उघडली गेली आहे. client किमान त्या version वर update करा किंवा नवीन version ने file मध्ये बदल करण्यापूर्वी घेतलेला backup restore करा. त्यानंतर पुन्हा load करा.
container सतत restart होत राहतो. `docker compose logs actual वाचा. /data` वर permission error असल्यास mounted directory container च्या user साठी writable नाही. address-in-use error असल्यास loopback वर 5006 पोर्ट दुसरी कोणतीतरी प्रक्रिया आधीच वापरत आहे.
पहिल्यांदा load होण्यास वेळ लागतो. device वर budget file पहिल्यांदा उघडल्यावर संपूर्ण file browser मध्ये download केली जाते. हा एक मोठा transfer असतो आणि त्यानंतर local reads होतात. ही server sizing ची समस्या नाही; RAM वाढवल्याने यामध्ये बदल होणार नाही.
FAQ
Actual कार्य करण्यासाठी HTTPS आवश्यक आहे का?
होय, प्रत्यक्ष वापरात आवश्यक आहे. Actual ला चालण्यासाठी ब्राउझरचे SharedArrayBuffer वैशिष्ट्य आवश्यक असते आणि ब्राउझर हे वैशिष्ट्य फक्त सुरक्षित संदर्भातच सक्षम करतात, म्हणजे https:// किंवा http://localhost. दुसऱ्या मशीनवरून साध्या HTTP द्वारे अॅप लोड होणार नाही. अधिकृत iOS अॅप beta testing मध्ये आहे आणि अद्याप अधिकृत Android अॅप उपलब्ध नाही. त्यामुळे बहुतेक फोन तेच web app वापरतात आणि त्याच नियमाला लागू होतात. (FAQ) वास्तविक hostname वर Let's Encrypt प्रमाणपत्र वापरा. प्रत्येक device वर प्रमाणपत्राची warning दिसणे मान्य असल्यास ACTUAL_HTTPS_KEY आणि ACTUAL_HTTPS_CERT सह self-signed प्रमाणपत्र वापरू शकता.
Actual माझ्या bank transactions आपोआप import करू शकते का?
फक्त तुम्ही स्वतः नोंदणी केलेल्या third-party service द्वारे. North America मध्ये SimpleFIN Bridge, Europe मध्ये Enable Banking, New Zealand मध्ये Akahu किंवा Brazil मध्ये Pluggy.ai वापरता येते. GoCardless समर्थित आहे, पण ते नवीन accounts स्वीकारत नाही. या API credentials तुमच्या server वर साठवले जातात आणि end-to-end encryption अंतर्गत संरक्षित नसतात. Automatic syncing default ने बंद असते. ते सक्षम केल्यानंतरही Actual उघडे असतानाच ते चालते. त्यामुळे server वर background मध्ये कोणतीही polling होत नाही. CSV, QIF, OFX, QFX आणि CAMT import साठी कोणत्याही third party ची आवश्यकता नाही.
मला नेमक्या कोणत्या गोष्टींचा backup घ्यावा लागेल?
या मार्गदर्शिकेत mounted data directory म्हणजे /opt/actual/data. त्यात logins आणि sessions असलेले server-files/account.sqlite तसेच budget files असलेले user-files असते. Copy करण्यापूर्वी container थांबवा. Live SQLite database copy केल्यास त्यातील write अंशतः capture होऊ शकतो. Server वरील इतर कोणत्याही ठिकाणी state साठवली जात नाही.
Encryption password हरवल्यास काय होते?
Budget ची local copy अजूनही उपलब्ध असल्यास encryption key reset करून पुन्हा sync करता येते. Password आणि सर्व local copies दोन्ही हरवल्यास encrypted file recover करता येत नाही. File तयार करताच ती password manager मध्ये साठवा. तसेच याच server वर अवलंबून नसलेल्या ठिकाणी तिची एक copy ठेवा.
Actual Budget साठी किती server resources आवश्यक आहेत?
अत्यल्प. Container static assets आणि files serve करतो. Budget calculations ब्राउझरमध्ये होतात. Disk वरील भार तुमच्या backups आणि इतर containers मुळे येतो, Actual मुळे नाही. Actual सोबत अधिक resources वापरणारी सेवा चालवणारा server निवडत असल्यास, photo server सहसा किमान आवश्यक resources ठरवतो. त्यामुळे plan निवडण्यापूर्वी PhotoPrism आणि Immich ला प्रत्यक्षात किती RAM आवश्यक आहे हे तपासा. Media stack साठीही हेच तत्त्व लागू होते. Plan ठरवताना transcoding महत्त्वाचे असते. Jellyfin library ला 90s च्या प्रत्यक्षात फिरता येणाऱ्या video store मध्ये रूपांतरित करणारे Halcyon यांसारख्या browser front end साठी Actual इतक्याच कमी resources पुरतात.