Rakazo स्वतःच्या VPS वर कसे होस्ट करावे?
Rakazo ला तुमच्या VPS वर Node 22, pnpm, Postgres आणि Docker Compose वापरून कसे सेट करावे ते शिका. सँडबॉक्स निवड, की मॅनेजमेंट आणि सर्व्हरच्या योग्य आकाराची सविस्तर माहिती.
Rakazo self-hosting मध्ये नक्की काय चालते
Rakazo self-hosting म्हणजे एका Linux सर्व्हरवर पाच गोष्टी चालवणे: PostgreSQL, एक Graphile Worker प्रक्रिया, API, वेब ॲप आणि बॉट्सचा संगणक म्हणून काम करणारा सँडबॉक्स कंटेनर. Rakazo हा Grok Bot ला एक ओपन-सोर्स पर्याय आहे, जो elie222 द्वारे Apache 2.0 लायसन्स अंतर्गत प्रकाशित केला आहे. प्रत्येक बॉटला स्वतःचे संभाषण, मेमरी, रूटीन आणि इतिहास मिळतो. जोपर्यंत त्याला 'Private Computer' दिले जात नाही, तोपर्यंत तो वर्कस्पेसच्या इतर बॉट्ससोबत एक 'Team Computer' शेअर करतो आणि तो स्वतःचे पीअर्स किंवा अल्पकालीन सब-एजंट्स तयार करू शकतो. जर मेमरी, सब-एजंट आणि टूल कॉल यांसारखे शब्द तुम्हाला नवीन वाटत असतील, तर एजंट्स प्रत्यक्षात कसे काम करतात याचा टप्प्याटप्प्याने प्रवास वाचण्यासाठी एक दुपार खर्च करणे फायदेशीर ठरेल. कारण, खालील बहुतेक सेटिंग्ज तेव्हाच समजतात जेव्हा तुम्हाला बॉट सक्रिय झाल्यावर काय करतो हे समजते.
हा शेवटचा भाग आहे म्हणूनच हे डेस्कटॉपवर न चालवता VPS (virtual private server) वर चालवणे आवश्यक आहे. जो बॉट मेमरी ठेवतो आणि नियोजित कामे करतो, तो तुम्ही झोपलेले असतानाही उपलब्ध असणे गरजेचे आहे. लॅपटॉप स्लीप मोडमध्ये गेल्यावर ही रांग (queue) खंडित होते.
ऑक्टोबर 2026 पर्यंत Rakazo स्वतःला बीटा आवृत्ती म्हणते, जरी आता ते स्थिर क्रमांकित (stable-numbered) रिलीज प्रकाशित करत असले तरीही. त्यामुळे याला एक पूर्ण झालेले उत्पादन न मानता एक कार्यरत सेटअप म्हणून पहा. हा संपूर्ण स्टॅक TypeScript मध्ये आहे: वेब ॲपसाठी React 19 आणि Vite, API साठी Hono, Prisma सह Postgres, अकाउंट्ससाठी Better Auth आणि बॅकग्राउंड जॉब्ससाठी Graphile Worker. Graphile Worker आपली रांग Postgres मध्ये साठवते, त्यामुळे Redis किंवा दुसरा कोणताही डेटा स्टोअर चालवण्याची गरज नाही. .env.example हे WAKEUP_DRIVER=graphile सेट करते, याचा अर्थ असा की बॉट सक्रिय होणे ही एक Postgres-आधारित प्रक्रिया आहे. Postgres थांबवले की प्रत्येक नियोजित बॉट क्रिया देखील थांबते. जर तुम्हाला दुसऱ्याचे उत्पादन चालवण्याऐवजी स्वतःचे एजंट भाग जोडून तयार करायचे असतील, तर घटकांपासून स्वतःचा एजंट तयार करणे हा दुसरा मार्ग आहे.
1 GB प्लॅन हे का पुरेसे ठरणार नाही
प्रोसेस मोजा. Postgres ही एक प्रोसेस आहे. API ही एक Node प्रोसेस आहे. Worker ही दुसरी प्रोसेस आहे. Web app ही तिसरी प्रोसेस आहे. Sandbox supervisor ही चौथी प्रोसेस आहे. त्यानंतर bots चे computer येते: default म्हणून एक shared Team Computer container असतो. त्यात graphical Linux desktop असतो आणि सक्रिय असलेल्या प्रत्येक bot साठी स्वतंत्र X display आणि Chrome प्रोसेस असते.
प्रकल्पाच्या self-host दस्तऐवजात आता host size दिलेला नाही. v0.3.5 येथील दस्तऐवज, 27 October 2026 रोजी तपासले असता, फक्त software requirements देतो. मात्र त्यात प्रत्येक computer साठीची कमाल मर्यादा दिली आहे: Docker sandboxes वापरताना RAKAZO_COMPUTER_MEMORY चे default 2g आणि RAKAZO_COMPUTER_CPUS चे default 2 असते. ही मर्यादा प्रत्येक computer साठी लागू होते, प्रत्येक bot साठी नाही. प्रत्येक workspace ला default म्हणून एक Team Computer मिळतो. प्रत्येक सक्रिय Team bot त्याचा desktop आणि browser त्याच computer मध्ये चालवतो. त्यामुळे ते सर्व 2 GB आणि two cores सामायिक करतात. Private Computer वर हलवलेल्या bot लाच स्वतःचा container आणि स्वतःची मर्यादा मिळते. SANDBOX_PROVIDER=docker सेट केल्यास हे desktops तुमच्या VPS वर हलतात. ते control plane व्यतिरिक्त चालतात. त्यामुळे 4 GB ही किमान गरज ठरते, लक्ष्य नाही. एकापेक्षा जास्त bot सुरू ठेवणार असाल, तर 8 GB पासून सुरुवात करा. Shared computer प्रत्यक्षात ती memory वापरू शकेल यासाठी RAKAZO_COMPUTER_MEMORY वाढवा. Bots काम करत असताना docker stats वापरून वास्तविक वापर मोजा. Memory वापर वाढवणारा मुख्य घटक sandbox मधील browser आहे. त्यामुळे केवळ spec sheet पाहून अचूक अंदाज येणार नाही. लहान VPS वर एकाच वेळी खूप browsers सुरू होऊ नयेत यासाठी positive SANDBOX_TEAM_SCREEN_LIMIT सेट करा. यामुळे Docker Team Computer वरील सक्रिय desktops ची संख्या मर्यादित होते. वितरित केलेले 0 कोणतीही मर्यादा ठेवत नाही. एकूण memory कमी असल्यास RAKAZO_COMPUTER_MEMORY मध्ये 1536m सारखी कमी value देखील स्वीकारली जाते. Agent कामासाठी VPS चा आकार ठरवण्याच्या सर्वसाधारण पद्धतीसाठी agent VPS ला प्रत्यक्षात किती RAM आणि CPU आवश्यक आहे या लेखात measurement सविस्तर दिले आहे.
एक setting ही समस्या वाढू देत नाही. .env.example मध्ये SANDBOX_IDLE_MS=600000 वितरित केलेले असते. त्याच्या comment मध्ये computers त्या idle milliseconds नंतर pause किंवा stop केले जातील असे नमूद केले आहे. Computer दहा मिनिटे idle राहिल्यास तो बंद होतो. स्वीकारली जाणारी किमान value 30000 आहे. 0 दिल्यास idle sleep बंद होते. Docker self-hosts साठी 0 वापरण्याची सूचना त्याच comment मध्ये आहे, कारण idle computer साठी कोणताही खर्च होत नाही. त्यामुळे दीर्घकाळ चालणारे apps आणि sessions सुरू राहतात. ही बाब खर्चासाठी योग्य आहे, memory साठी नाही. लहान VPS वर timer सुरू ठेवा. अन्यथा तुम्ही कधीही सुरू केलेला प्रत्येक computer आणि त्यातील प्रत्येक browser चालूच राहील.
Disk वापराचाही विचार करा. Sandbox image, Node modules आणि Postgres volume हे सर्व एकाच disk वर जागा वापरतात. त्यामुळे 40 GB ही योग्य सुरुवातीची क्षमता आहे.
क्लोन करण्यापूर्वी आवृत्ती निश्चित करा
Rakazo वेगाने बदलत आहे आणि main ही release नाही. 9 November 2026 रोजी v0.8.0 ही 4 November 2026 रोजी प्रकाशित झालेली आणि Latest म्हणून चिन्हांकित केलेली release आहे. हा मार्गदर्शक 25 October 2026 रोजी प्रकाशित झालेल्या v0.3.5 वर निश्चित ठेवला आहे.
git clone https://github.com/elie222/rakazo.git
cd rakazo
git checkout f31e3c0699f086d663637c4107858c238a086fb3
git log -1 --format='%H %ci'हा commit v0.3.5 ज्या commit कडे निर्देश करतो तोच आहे. branch किंवा tag ऐवजी commit निश्चित करा. पुढील git pull वर branch तुमच्या नकळत बदलू शकते. tag हा maintainer पुन्हा दुसऱ्या commit कडे निर्देशित करू शकणारा बदलता label आहे. त्यामुळे यापैकी कोणताही पर्याय पुन्हा उघडता येणारा एकच tree निश्चित करत नाही. Commit identifier बदलू शकत नाही. तुमच्या इतर server facts शेजारी तो लिहून ठेवा. Upgrade मुळे समस्या आल्यास स्वस्त उपाय म्हणजे git checkout <old commit> आणि rebuild करणे. हे तेव्हाच शक्य आहे जेव्हा कोणता commit कार्यरत होता हे तुम्हाला माहीत असेल. निश्चित केलेल्या README मध्ये Rakazo ला beta म्हटले आहे. त्यामुळे ही आवृत्ती अचूकपणे निश्चित करण्यासाठी लागणारा थोडा प्रयत्न योग्य आहे. ज्या project चा नियोजित releases चा दीर्घ इतिहास आहे, त्याला प्रकाशित tag वर ठेवता येते. openGym सारखा लहान self-hosted stack याच पद्धतीने चालतो.
Requirements: Node 22, pnpm 9 आणि Docker
node -v
pnpm -v
docker --versionpackage.json मध्ये "engines": { "node": "^22.22.2 || ^24.0.0 || >=26.0.0" } आणि "packageManager": "pnpm@9.15.0" घोषित केले आहेत. त्यामुळे node -v ने v22.22.2 किंवा त्यानंतरची 22.x आवृत्ती, कोणतेही v24 किंवा v26 आणि त्यानंतरचे मूल्य दाखवले पाहिजे. 22.22.2 पेक्षा जुने v22 या मर्यादेबाहेर आहे. README मध्ये Node.js 23.x आणि 25.x समर्थित नसल्याचे स्पष्टपणे नमूद केले आहे. NodeSource किंवा nvm मधून समर्थित Node आवृत्ती install करा. Node 22 आणि 24 सोबत Corepack उपलब्ध असते. Node 26 आणि त्यानंतरच्या आवृत्त्यांवर ते आधी npm install -g corepack वापरून install करा. त्यानंतर pnpm सक्रिय करा:
corepack enable
corepack prepare pnpm@9.15.0 --activateउर्वरित गरजा Docker Engine आणि compose plugin पूर्ण करतात. self-host दस्तऐवजात bot home volume subpaths साठी Docker Engine 26 किंवा त्यानंतरची आवृत्ती आणि API 1.45 किंवा त्यानंतरची आवृत्ती आवश्यक आहे. त्यासोबत curl आणि OpenSSL देखील आवश्यक आहेत. तुमच्या user ला daemon पर्यंत पोहोचता आले पाहिजे. docker ps चे उत्तर permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock असल्यास, तुमच्या user ला docker group मध्ये जोडा आणि नवीन login shell उघडा. हा अधिकार देण्यापूर्वी त्याचा परिणाम समजून घ्या: docker मधील membership ही मशीनवरील root अधिकारांइतकीच प्रभावी असते, कारण त्या group मधील कोणतीही व्यक्ती host filesystem mount करणारा container सुरू करू शकते.
.env कॉन्फिगर करा आणि नंतर Postgres सुरू करा
cp .env.example .env
chmod 600 .envकाहीही सुरू करण्यापूर्वी अनेक मूल्ये बदलणे आवश्यक आहे. .env.example मध्ये BETTER_AUTH_SECRET=replace-with-32-plus-character-secret, ENCRYPTION_KEY=replace-with-64-random-hex-characters, SCREEN_PROXY_SECRET=replace-with-32-plus-character-screen-proxy-secret आणि SANDBOX_SUPERVISOR_TOKEN=replace-with-32-plus-character-supervisor-token मूल्ये समाविष्ट असतात, तर POSTGRES_PASSWORD आणि POSTGRES_APP_PASSWORD रिक्त ठेवलेले असतात. यातील प्रत्येक placeholder repository मध्ये उपलब्ध असतो. त्यामुळे एखादा placeholder तसाच ठेवून deployment केल्यास, कोणालाही वाचता येणाऱ्या secret वर तो चालतो. प्रत्येकासाठी स्वतंत्र random value द्या. ENCRYPTION_KEY मध्ये 64 random hex characters असणे आवश्यक आहे; openssl rand -hex 32 नेमके तेच प्रदर्शित करते. इतर secrets साठी 32 किंवा अधिक characters आवश्यक आहेत. त्यामुळे base64 ओळ प्रत्येकासाठी एकदा चालवा. दोन Postgres passwords साठी self-host दस्तऐवज URL-safe values मागतो. शेवटची ओळ ही values देते, त्यामुळे ती देखील प्रत्येक password साठी एकदा चालवा. Database मध्ये दोन logins आहेत. DATABASE_MIGRATION_URL मध्ये postgres://rakazo:REPLACE_WITH_POSTGRES_PASSWORD@127.0.0.1:5433/rakazo मूल्य समाविष्ट असते. हा migrations चालवणारा owner आहे. DATABASE_URL मध्ये postgres://rakazo_app:REPLACE_WITH_POSTGRES_APP_PASSWORD@127.0.0.1:5433/rakazo मूल्य असते. हा app चा स्वतंत्र login आहे. त्याला superuser अधिकार नसतात आणि त्याच्यावर row-level security लागू असते. प्रत्येक password त्याच्या स्वतंत्र URL मध्ये ठेवा. pnpm db:migrate तुम्ही सेट केलेल्या password सह rakazo_app login तयार करते.
openssl rand -base64 48
openssl rand -hex 32
openssl rand -hex 24त्यानंतर database स्वतंत्रपणे सुरू करा आणि migrations चालवा.
docker compose --env-file .env -f infra/compose/docker-compose.yml -f infra/compose/docker-compose.postgres-host.yml up postgres -d
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm sandbox:buildpnpm sandbox:build bot computer image तयार करते. ही image package.json मध्ये docker build -t rakazo/computer:local infra/sandboxes/computer म्हणून परिभाषित केली आहे. ही graphical image असल्यामुळे पहिल्या build वेळी मोठ्या प्रमाणावर data download होतो आणि वेळ लागतो. docker image ls rakazo/computer वापरून ती तयार झाल्याची पडताळणी करा. त्याने एक row प्रदर्शित करायला हवा.
मूळ compose file कोणताही Postgres port प्रकाशित करत नाही. त्या command मधील docker-compose.postgres-host.yml overlay तो 127.0.0.1:5433 म्हणून प्रकाशित करतो. हा port केवळ loopback वर उपलब्ध असतो. त्यामुळे pnpm db:migrate आणि pnpm dev सारखी host-side tools त्याच्याशी जोडली जाऊ शकतात. हीच रचना ठेवा. .env मध्ये POSTGRES_PASSWORD नसल्यास Compose Postgres सुरू करण्यास नकार देते. मात्र इंटरनेटवरून उपलब्ध असलेला Postgres port password attacks सुलभ करतो. Production compose file हाच variable वाचते आणि कोणताही database port प्रकाशित करत नाही.
पहिली run
pnpm devयामुळे default पद्धतीने चार गोष्टी सुरू होतात: port 3100 वरील API, Graphile Worker, port 5173 वरील Vite web app आणि port 7091 वरील sandbox supervisor. हे ports आधीच वापरात असल्यास pnpm dev दुसरा मोकळा port block निवडते आणि URLs दाखवते. Default ports वापरल्यास app http://127.0.0.1:5173 येथे उपलब्ध असतो आणि तुम्हाला sign-in page दिसायला हवा.
तुम्ही VPS वर त्या machine समोर बसलेले नसता. त्यामुळे app पर्यंत पोहोचण्यासाठी 5173 publish करू नका. त्याऐवजी तुमच्या स्वतःच्या machine वरून SSH (secure shell) द्वारे ports forward करा.
ssh -L 5173:127.0.0.1:5173 -L 3100:127.0.0.1:3100 you@your-serverहे चालवण्याच्या पद्धतींमधील फरक लक्षात घ्या. pnpm dev host वर Vite चालवते आणि ते locally bind केलेले असते. Development compose file मधील web service 127.0.0.1:5173:5173 publish करते आणि तिची api service 127.0.0.1:3100:3100 publish करते. दोन्ही loopback-only आहेत. त्यामुळे त्यासाठीही तोच tunnel कार्य करतो. Production file मध्ये web app कोणताही host port publish करत नाही. ती स्वतःच्या networks वरील containers साठीच 5173 expose करते. Caddy एकटाच ports 80 आणि 443 publish करते. त्यामुळे कायम चालू ठेवायच्या कोणत्याही setup साठी production file आणि तिचा reverse proxy वापरा.
सर्व्हरवर कोणता sandbox provider सुरक्षित आहे?
ही योग्यरीत्या निश्चित करणे आवश्यक असलेली एकमेव setting आहे. SANDBOX_PROVIDER मधील .env हे default म्हणून docker आहे. Pinned checkout मध्ये self-host doc मध्ये सूचीबद्ध providers सोबत Railway लाही support आहे.
dockerहा default आहे. Bot computers तुमच्या मशीनवर containers म्हणून चालतात. तेpnpm sandbox:buildimage पासून तयार होतात आणि supervisor अंतर्गत चालवले जातात. Default म्हणून एका workspace मधील bots एकच Team Computer share करतात. Private Computer वरच प्रत्येक bot ला स्वतःचा container मिळतो. E2B account आवश्यक नाही.e2bbot computers E2B वर चालवतो आणिE2B_API_KEYआवश्यक आहे.v0.3.5नुसार key दिल्यास factory production मध्ये ते स्वीकारते आणि कोणतेहीNODE_ENVrestriction नाही. self-host doc नुसार हा public किंवा multi-user production साठी योग्य आहे, कारण bot computers तुमचे API आणि database चालवणाऱ्या host पासून वेगळे ठेवले जातात.daytona,createosआणिboatहे आणखी remote providers आहेत. प्रत्येकासाठी स्वतंत्र key आवश्यक आहे:DAYTONA_API_KEY,CREATEOS_SANDBOX_API_KEYकिंवाBOAT_API_KEY.railwayRailway वर computers चालवतो. त्यासाठीRAILWAY_API_TOKENआणि API तसेच worker वर स्पष्टपणे निवडलेलेRAILWAY_ENVIRONMENT_IDआवश्यक आहे. Sandboxes साठी स्वतंत्र Railway project किंवा environment वापरा.desktopdoc मध्ये नमूद केल्याप्रमाणे, bot चे commands थेट API आणि worker host वर चालवतो.v0.3.5मध्येNODE_ENVहेdevelopmentकिंवाtestनसल्यास API आणि worker ते नाकारतात. परंतु.env.exampleहेNODE_ENV=developmentसह ships होते. त्यामुळेpnpm devचालवणारा server ते अद्याप स्वीकारतो. Public किंवा shared service वर ते enable करू नका.fakeहा फक्त verification साठी emulator आहे. तो runtime नाही.noneकोणताही computer host न वापरता product सुरू करतो.
याचा अर्थ शब्दशः घ्या. Desktop mode मध्ये कोणतीही isolation boundary नसते. त्यामुळे bot API process चालवणाऱ्या user म्हणून shell commands चालवतो. त्याला त्या user ची home directory, SSH keys, cloud credentials आणि .env उपलब्ध असतात. Bot वाचत असलेल्या web page मधील मजकूर तुमच्या server वरील command बनतो. Server वर Desktop mode वापरल्यास bot कडे तुमची credentials जाण्याची शक्यता निर्माण होते. ज्या मशीनसमोर तुम्ही प्रत्यक्ष बसता त्यावरच ते वापरा; अन्यथा अजिबात वापरू नका. Providers बदलल्यास त्या web page path भोवती container तयार होते; तो path बंद होत नाही. तसेच bot ला स्वतःचा SearXNG search backend देणे search बाजूने असाच injection surface कव्हर करते.
docker bots आणि तुमच्या host यांच्यामध्ये वास्तविक boundary तयार करतो. मात्र bots एकमेकांपासून कमकुवतपणे वेगळे राहतात. Default म्हणून ते एकच Team Computer share करतात. Computer runtime doc नुसार Team bots समान OS user, workspace, browser profiles तसेच shell आणि X11 access share करतात. Per-bot folders कामाची मांडणी करतात, पण त्या security boundaries नाहीत. त्यामुळे कोणताही Team bot दुसऱ्या Team bot च्या files वाचू शकतो. स्वतःच्या isolation boundaries आवश्यक असलेल्या bot साठी Private Computer वापरा. Docker provider तो स्वतंत्र network वर separate sibling container म्हणून चालवतो. मात्र हे containers तयार करणारा supervisor /var/run/docker.sock mount करतो. self-host doc हे स्पष्टपणे सांगते: त्या socket ला access मिळणे म्हणजे Docker host वर control मिळण्यासारखे आहे. त्यामुळे supervisor private ठेवा. .env.example मध्ये SANDBOX_SUPERVISOR_TOKEN ही dedicated credential मानली जाते. ती BETTER_AUTH_SECRET पेक्षा वेगळी असते आणि local development बाहेर Docker sandboxes साठी आवश्यक असते. ती GitHub वर कोणीही वाचू शकेल अशा placeholder सह ships होते. तिच्यासाठी स्वतंत्र random value द्या. येथे उपलब्ध असलेल्या सर्वात मजबूत separation साठी e2b वापरा किंवा Rakazo साठी इतर कोणतीही माहिती नसलेली स्वतंत्र मशीन द्या. coding agents disposable VM मध्ये चालवण्यामागे हाच तर्क आहे: agent कडून काही चुकीचे घडल्यास त्यातून सुरक्षित राहण्याचा सर्वात स्वस्त मार्ग म्हणजे त्याची मशीन निरुपयोगी असणे.
मॉडेल API keys कुठे ठेवायच्या?
Rakazo चे ऐच्छिक model-credit billing दोन्ही Stripe secrets सेट केल्याशिवाय सुरू होत नाही. Key तुम्ही स्वतः द्यायची आहे. .env.example मध्ये PI_DEFAULT_PROVIDER=openrouter सेट केले जाते, त्यामुळे OPENROUTER_API_KEY हे नेहमीचे ठिकाण आहे आणि provider keys देखील याच setting द्वारे कार्य करतात.
Key .env मध्ये ठेवा आणि commit केलेल्या कोणत्याही file मध्ये ठेवू नका. Repository मधील दोन्ही compose commands --env-file .env पास करतात. त्यामुळे values git track करत असलेल्या YAML मध्ये कधीही लिहिल्या जात नाहीत आणि containers पर्यंत पोहोचतात. तुम्ही OPENROUTER_API_KEY रिकामे ठेवून signup नंतर app मध्ये model जोडू शकता. त्यामुळे ENCRYPTION_KEY साठी shipped placeholder ऐवजी खरोखर random value असणे आणखी महत्त्वाचे ठरते.
Bot ने key वापरण्यापूर्वी provider कडे त्या key साठी spending limit सेट करा. Loop मध्ये अडकलेला bot खर्च करत राहतो. Rakazo MAX_TOOL_CALLS_PER_TURN देखील देते. Positive integer सेट केल्यास tool-call budget पेक्षा जास्त होणारा turn soft-stop होतो आणि तरीही final assistant message तयार होते. 0 unset किंवा रिकामे असल्यास ही मर्यादा लागू होत नाही. यामध्ये tool calls मोजले जातात, पैसे नाहीत. त्यामुळे हे provider च्या spending limit ची जागा घेत नाही. या key ला स्वतंत्र नाव द्या, म्हणजे ती एकटी revoke करता येईल. हे स्वतःसाठी नव्हे तर team साठी सेट करत असल्यास, सर्वांच्या agent समोर OneCLI चे एक gateway हा याच समस्येचा वेगळा उपाय आहे, कारण provider keys प्रत्येक व्यक्तीसाठी स्वतंत्र ठेवण्याऐवजी तो त्या एकाच ठिकाणी ठेवतो.
dev mode मधून सतत चालू ठेवता येईल अशा रचनेकडे जाणे
Repository मध्ये production compose file दिली आहे. ती Postgres, API, worker, web app आणि आपोआप मिळवलेली TLS (transport layer security) certificates हाताळणारे Caddy चालवते. या file मध्ये ports publish करणारी एकमेव service Caddy आहे. Bot computers साठी ती default म्हणून E2B वापरते. ऐच्छिक overlay, infra/compose/docker-compose.prod.docker.yml, त्याच stack वर स्थानिक Docker computers चालवते. या overlay मुळे जोडला जाणारा supervisor host वर root-equivalent अधिकारांसह चालतो, असा doc मध्ये इशारा दिला आहे.
sudo --preserve-env=SSH_CONNECTION DEPLOY_USER=deploy bash infra/compose/harden-host.sh
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
build --build-arg GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
up -d --wait --pull never
curl --fail https://app.example.com/healthकेवळ key वापरणारे deploy account तयार करा. Script चालवण्यापूर्वी त्या account ने login करता येते याची खात्री करा. harden-host.sh SSH password login आणि root login बंद करते. ती SSH वर rate limiting लागू करते. तसेच विद्यमान private-network rules जतन करून UFW (uncomplicated firewall) मधून SSH, HTTP आणि HTTPS साठी परवानगी देते. याशिवाय fail2ban, unattended security updates, AppArmor आणि audit rules सुरू करते. SSH_CONNECTION शिवाय ती चालत नाही. म्हणून command मध्ये ते sudo द्वारे पास केले आहे. नवीन SSH session मधून तीन मिनिटांच्या आत बदलाची पुष्टी न केल्यास firewall मधील बदल पूर्ववत केले जातात. Script चालवण्यापूर्वी ते वाचा, कारण यामुळे login करण्याची पद्धत बदलते आणि SSH reload होते. नवीन SSH login यशस्वी होईपर्यंत provider चा console उघडा ठेवा.
Production .env ला development आवृत्तीपेक्षा अधिक configuration आवश्यक आहे. Self-host doc मध्ये secrets सह ही किमान configuration दिली आहे.
NODE_ENV=production
RAKAZO_HOST=app.example.com
BETTER_AUTH_URL=https://app.example.com
WEB_ORIGIN=https://app.example.com
API_URL=https://app.example.com
SIGNUPS_ENABLED=true
SIGNUP_ALLOWLIST=you@example.com
SANDBOX_PROVIDER=e2b
AGENT_RUNTIME=pi
WAKEUP_DRIVER=graphile
DATA_DIR=/data
RAKAZO_DEPLOY_DIR=/srv/rakazo
RAKAZO_IMAGE_TAG=local
POSTGRES_PASSWORD=<random, URL-safe>
POSTGRES_APP_PASSWORD=<random, URL-safe>
BETTER_AUTH_SECRET=<random>
ENCRYPTION_KEY=<64 random hex characters>
SCREEN_PROXY_SECRET=<random>
E2B_API_KEY=<your key>
OPENROUTER_API_KEY=<your key>पहिला up करण्यापूर्वी server कडे A record निर्देशित करा. Caddy RAKAZO_HOST मधील नावासाठी certificate मागते. हे नाव या server कडे resolve झाले पाहिजे. तसेच HTTP validation साठी port 80 किंवा TLS-ALPN validation साठी port 443 बाहेरून accessible असला पाहिजे. दोन्ही challenges default म्हणून enabled आहेत. त्यामुळे केवळ port 80 बंद केल्याने port 443 द्वारे certificate issuance थांबत नाही.
SIGNUP_ALLOWLIST सुरुवातीपासून तुमच्या स्वतःच्या address वर सेट ठेवा. .env.example मध्ये SIGNUPS_ENABLED=true दिले आहे. दोन्ही settings प्रत्येक API start वेळी environment मधून वाचल्या जातात. त्यामुळे public name वर असलेल्या instance मध्ये signups enabled असतील आणि allowlist नसेल, तर तो पत्ता शोधणारी कोणतीही व्यक्ती registration करू शकते. प्रत्येक start वेळी non-empty allowlist लागू केली जाते आणि stored list ची जागा घेतली जाते. Allowlisted signup साठी mailbox verification आवश्यक आहे. पहिला account देखील याला अपवाद नाही. त्यामुळे register करण्यापूर्वी email delivery सेट करा. Email उपलब्ध नसल्यास doc मध्ये दिलेली पद्धत म्हणजे SIGNUPS_ENABLED=false सह सुरुवात करणे आणि दिलेल्या server-side bootstrap command ने account तयार करणे. यामुळे server privileges नसलेले सामान्य verified account तयार होते. आधी allowlist लागू करा. नंतर आवश्यक असल्यास ती सैल करा. त्याच server वर आधीच अनेक services चालू असतील आणि प्रत्येक app साठी स्वतंत्र allowlist ठेवण्याऐवजी लोकांची एकच list ठेवायची असेल, तर त्यांच्यासमोर Authentik instance ठेवणे हा निर्णय proxy कडे हलवते. मात्र ते Rakazo च्या स्वतःच्या Better Auth accounts च्या पुढे राहते; त्यांची जागा घेत नाही.
Production settings साठी repository मधील docs/self-host.md हा अधिकृत संदर्भ माना, कारण code बदलल्यावर तो बदलतो; हे guide मात्र बदलत नाही. Compose हे काम करत असल्यामुळे नेहमीचे नियम लागू होतात. तसेच VPS साठी Docker Compose ची मूलभूत माहिती मध्ये --env-file आणि named volumes यांचे महत्त्व stack अनेक महिने न छेडता चालू ठेवायचा असल्यास का वाढते, हे स्पष्ट केले आहे.
बॅकअप
या सेटअपमध्ये Postgres आणि data/ directory मध्ये instance चा डेटा असतो. Recovery साठी ENCRYPTION_KEY आणि configured content master keys देखील आवश्यक असतात. त्यामुळे त्यांच्या प्रती server च्या बाहेर ठेवा.
./scripts/backup.sh
./scripts/restore.sh backups/BACKUP_TIMESTAMPbackup.sh Postgres चा dump घेतो आणि data/ चे archive तयार करतो. restore.sh development Compose stack वर कार्य करते. ती रिकाम्या database मध्ये चालवा आणि application services थांबवलेल्या असू द्या. ती production backup files वाचत नाही. ज्या machine वर तुम्ही अवलंबून आहात, तिथे repository पुरवत असलेला timer वापरून infra/compose/backup-prod.sh ला /usr/local/sbin/rakazo-backup म्हणून install करा. ते verified dump आणि app-data archive /var/backups/rakazo मध्ये लिहिते. RAKAZO_BACKUP_KEEP द्वारे ठरवल्याप्रमाणे, ते default ने जास्तीत जास्त तीन verified snapshots ठेवते. RAKAZO_BACKUP_MAX_GB द्वारे 50 GiB ची मर्यादा निश्चित केली जाते. प्रत्येक run पूर्वी ते अपूर्ण snapshots आणि अतिरिक्त जुना इतिहास हटवते. त्यामुळे rotation आपोआप होते. तुम्ही /etc/rakazo/backup.env मध्ये दिलेल्या public recipients साठी age वापरून प्रत्येक backup encrypt करू शकता. त्यामुळे server असे backups लिहितो जे तो स्वतः वाचू शकत नाही. हे key pair तुमच्या नियंत्रणातील machine वर generate करा आणि private key server च्या बाहेर ठेवा. Recipients दिले नसतील, तर backup plaintext स्वरूपात राहतो आणि warning log केली जाते. मात्र पहिला encrypted backup तयार झाल्यानंतर recipients शिवाय केलेला run अपयशी ठरतो, जोपर्यंत RAKAZO_BACKUP_ALLOW_PLAINTEXT=1 वापरून plaintext ला स्पष्टपणे अनुमती दिली जात नाही. Database असलेल्या त्याच disk वर ठेवलेली backup प्रत backup मानली जात नाही. त्यामुळे ती server च्या बाहेर copy करा. गरज पडण्यापूर्वी spare server वर तिचे एकदा restore करून पाहा.
ते का अपयशी ठरते आणि तुम्हाला काय दिसेल
pnpm db:migrate डेटाबेसपर्यंत पोहोचू शकत नाही. Migration मध्ये 127.0.0.1:5433 येथील database server शी संपर्क साधता येत नसल्याचे दिसते. Postgres container सुरू नसू शकतो, सुरू असला तरी अजून ready नसू शकतो किंवा तो docker-compose.postgres-host.yml overlay शिवाय सुरू केला असू शकतो. हा overlay 5433 host वर publish करतो. docker compose --env-file .env -f infra/compose/docker-compose.yml ps चालवा आणि postgres service healthy असल्याचे पाहा. Compose file मध्ये दर तीन सेकंदांनी चालणारा health check दिलेला आहे. Container सतत restart होत असल्यास त्याचे logs वाचा. Pinned Compose stack जुना Postgres 16 volume Postgres 18 मध्ये migrate होईपर्यंत सुरू होण्यास नकार देतो. docker compose ... down -v तो volume साफ करते आणि त्यातील data देखील हटवते.
Port आधीच वापरात आहे. दुसरी प्रक्रिया 5433 वापरत असल्यास Postgres सुरू करताना bind: address already in use त्रुटी येते. तुम्ही थांबवायचे विसरलेला जुना Rakazo stack हे याचे सर्वात सामान्य कारण आहे. sudo ss -lntp | grep 5433 ही प्रक्रिया कोणती आहे ते दाखवते. Overlay host port POSTGRES_HOST_PORT मधून घेते. त्यामुळे DATABASE_URL आणि DATABASE_MIGRATION_URL मध्येही तोच बदल केल्यास port बदलता येतो.
Bot ला computer कधीच मिळत नाही. SANDBOX_PROVIDER=docker असताना आणि rakazo/computer:local image नसताना सुरू करण्यासाठी काहीही उपलब्ध नसते. docker image ls rakazo/computer एका ओळीत ही स्थिती दाखवते आणि pnpm sandbox:build ती दुरुस्त करते. Supervisor ला Docker socket पर्यंत पोहोचता येत नसल्यास तो containers तयार करू शकत नाही. संदेशात path दिलेला असतो: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.
दीर्घ command मध्येच थांबते. .env.example मध्ये SANDBOX_COMMAND_TIMEOUT_MS=300000 सेट केलेले आहे. त्यामुळे bot च्या computer मध्ये चालणारी एकच command पाच मिनिटांनंतर थांबवली जाते. Sandbox crash झाला असे गृहीत धरण्याऐवजी धीम्या builds साठी ही मर्यादा वाढवा.
pnpm install अनपेक्षित पद्धतीने अपयशी ठरते. इतर काही तपासण्यापूर्वी node -v तपासा. Workspace मध्ये ^22.22.2 || ^24.0.0 || >=26.0.0 घोषित केलेले आहे. त्यामुळे 23.x, 25.x आणि 22.22.2 पूर्वीचे कोणतेही 22.x version या मर्यादेबाहेर आहेत. Pinned .npmrc मध्ये engine-strict=true सेट केलेले आहे. त्यामुळे application dependency code चालण्यापूर्वी pnpm install unsupported Node version नाकारते आणि engine/version error देते.
स्थानिक पातळीवर sign-in होते, पण domain द्वारे होत नाही. BETTER_AUTH_URL, WEB_ORIGIN आणि API_URL या तिन्हीमध्ये address bar मधील public origin, scheme सहित, समान असणे आवश्यक आहे. त्यांपैकी एखाद्यामध्ये राहिलेला जुना http://127.0.0.1:5173 हा session टिकून न राहण्याचे नेहमीचे कारण आहे.
पिन केलेले checkout अपडेट करणे
तुमच्या checkout मधून तयार केलेल्या production Compose stack साठी self-host doc मधील upgrade प्रक्रिया लहान आहे: नवीन source pull करा, त्यानंतर API, worker आणि web app पुन्हा build करून restart करा. API सुरू होताना migrations चालतात, कारण सेवा देण्यापूर्वी त्यांचा start command त्या लागू करतो.
sudo /usr/local/sbin/rakazo-backup
git fetch --all --tags
git checkout NEW_COMMIT_SHA
export GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
up -d --wait --pull never --build api worker webसर्वप्रथम backup घ्या. Migrations पुढील आवृत्तीकडे जातात आणि beta मध्ये खात्रीशीर reverse path उपलब्ध नसतो. तुमचा checkout 30 August 2026 पेक्षा जुना असल्यास, आणि त्यात v0.1.0-beta commit समाविष्ट असल्यास, upgrade करण्यापूर्वी doc मधील 20260830200000_space_scope_names_and_user_credentials migration ची सूचना वाचा. हा समन्वयित cutover आहे. त्यामुळे आधी जुना API आणि worker थांबवा आणि doc मध्ये दिलेली Space privacy-boundary तपासणी चालवा. स्वतंत्र app login येण्यापूर्वीच्या checkout वरून upgrade करत असल्यास, पुन्हा build करण्यापूर्वी .env मध्ये POSTGRES_APP_PASSWORD सेट करा; त्याशिवाय production compose file सुरू होण्यास नकार देते. Source-checkout आणि production Compose files दोन्ही Postgres 18 चालवतात. त्यामुळे विद्यमान Postgres 16 installation नवीन layout वर सुरू करण्यापूर्वी doc मधील infra/compose/upgrade-postgres.sh procedure आवश्यक आहे. तुमचा pinned SHA आणि नवीन SHA यांच्या दरम्यानचे commits स्वीकारण्यापूर्वी वाचा, कारण इतक्या नव्या project मध्ये environment variables ची नावे कोणतीही सूचना न देता बदलू शकतात. Missing variable असल्यास सेवा सुरू होऊन लगेच बंद झाल्याचे दिसते. Rakazo चालवणे योग्य आहे की नाही याबाबत अजून निर्णय घेत असाल, तर self-hosted AI agents चा आढावा या श्रेणीतील इतर पर्याय आणि प्रत्येक चालू ठेवण्याचा खर्च स्पष्ट करतो.
FAQ
मी Rakazo 1 GB VPS वर चालवू शकतो का?
नाही. Postgres, API, worker, sandbox supervisor आणि web app एकाच वेळी चालतात. तसेच SANDBOX_PROVIDER=docker वापरल्यास bots' computer मध्ये graphical desktop असलेला container जोडला जातो. प्रत्येक active bot साठी स्वतंत्र X display आणि Chrome process असतो. हे सर्व default 2 GB memory आणि दोन CPUs च्या मर्यादेत चालते. v0.3.5 येथील self-host doc मध्ये host size दिलेला नाही. Control plane साठी 4 GB ही किमान मर्यादा समजा. Desktops तुमच्या machine वर चालत असल्यास त्यापेक्षा जास्त memory वापरा.
Server वर desktop sandbox provider सुरक्षित आहे का?
नाही. Self-host doc नुसार desktop commands थेट API आणि worker host वर चालवते. त्यामुळे bot हा तो process चालवणाऱ्या user प्रमाणे कार्य करतो आणि त्या user च्या files व credentials पर्यंत त्याला प्रवेश असतो. v0.3.5 मध्ये API आणि worker development आणि test mode बाहेर ते नाकारतात. मात्र pnpm dev चालवणारा server development mode मध्ये असतो आणि ते स्वीकारतो. ते कोणत्याही public किंवा shared server वर सुरू ठेवू नका. एखाद्या bot ने workspace मधील इतर bots सोबत files share करू नयेत असे असल्यास docker वापरा. एकापेक्षा जास्त व्यक्ती sign in करत असल्यास e2b वापरा.
मी Rakazo ची कोणती आवृत्ती install करावी?
9 November 2026 रोजी नवीनतम release v0.8.0 आहे. ती 4 November 2026 रोजी प्रकाशित झाली असून Latest म्हणून चिन्हांकित आहे. या मार्गदर्शकाचे अनुसरण करण्यासाठी main किंवा August मधील v0.1.0-beta prerelease track करण्याऐवजी निश्चित केलेला v0.3.5 commit, f31e3c0699f086d663637c4107858c238a086fb3, checkout करा. Branch तुमच्या नकळत बदलू शकते आणि tag पुन्हा दुसऱ्या commit कडे निर्देशित करता येतो. त्यामुळे यापैकी कोणताही पर्याय पुन्हा उघडता येणारा एकच tree निश्चित करत नाही. Commit नोंदवून ठेवा. कोणता commit कार्यरत होता हे माहीत असल्यावरच rollback करता येतो.
माझी OpenRouter API key कुठे ठेवायची?
ती .env मध्ये OPENROUTER_API_KEY म्हणून ठेवा. ती commit केलेल्या compose file मध्ये कधीही ठेवू नका. Repository मधील दोन्ही compose commands --env-file .env pass करतात. त्यामुळे value tracked YAML मध्ये लिहिली जात नाही आणि containers पर्यंत पोहोचते. तुम्ही ती रिकामीही ठेवू शकता आणि signup केल्यानंतर app मध्ये model connect करू शकता. Provider कडे key साठी spending limit सेट करा. कारण एखादा bot loop मध्ये अडकल्यास काहीतरी थांबवणार नाही तोपर्यंत तो model ला calls करत राहतो.
मला domain name आणि TLS आवश्यक आहे का?
पहिल्या test पलीकडे काहीही करायचे असल्यास, होय. Production compose file Caddy चालवते आणि certificates आपोआप मिळवते. RAKAZO_HOST मध्ये public hostname सेट करा आणि BETTER_AUTH_URL, WEB_ORIGIN आणि API_URL मध्ये तोच public HTTPS origin सेट करा. प्रथम पाहणी करण्यासाठी domain वगळू शकता: pnpm dev चालवा आणि तो publish करण्याऐवजी port 5173 SSH द्वारे forward करा.