SSD Nodes Learn Hosting plans →

VPS-ல் Rakazo-வை நீங்களே ஹோஸ்ட் செய்வது எப்படி?

Node 22, pnpm, Postgres மற்றும் Docker Compose பயன்படுத்தி Rakazo-வை உங்கள் VPS-ல் நிறுவுவதற்கான முழுமையான வழிகாட்டி. Sandbox தேர்வு, API கீ மேலாண்மை மற்றும் சர்வர் தேவைகள் பற்றி அறிக.

Rakazo self-hosting-ல் உண்மையில் இயங்குபவை

Rakazo-வை self-host செய்வது என்பது ஒரு Linux server-ல் ஐந்து விஷயங்களை இயக்குவதாகும்: PostgreSQL, ஒரு Graphile Worker process, API, web app, மற்றும் bot-களின் கணினியாகச் செயல்படும் ஒரு sandbox container. Rakazo என்பது Grok Bot-க்கு மாற்றாக elie222 என்பவரால் Apache 2.0 உரிமத்தின் கீழ் வெளியிடப்பட்ட ஒரு open-source மென்பொருளாகும். ஒவ்வொரு bot-க்கும் தனித்தனி உரையாடல்கள், நினைவகம் (memory), நடைமுறைகள் (routines) மற்றும் வரலாறு இருக்கும். ஒரு bot-க்கு Private Computer வழங்கப்படாத வரை, அது workspace-ல் உள்ள மற்ற bot-களுடன் ஒரு Team Computer-ஐப் பகிர்ந்து கொள்ளும்; மேலும் அது சக bot-களை அல்லது குறுகிய கால subagent-களை உருவாக்க முடியும். அந்த வாக்கியத்தில் உள்ள memory, subagent மற்றும் tool call போன்ற சொற்கள் உங்களுக்குப் புதியதாக இருந்தால், agents எவ்வாறு செயல்படுகின்றன என்பதற்கான படிப்படியான விளக்கம் என்பதை முதலில் படிப்பது நல்லது. ஏனெனில், கீழே உள்ள பெரும்பாலான அமைப்புகள், ஒரு bot இயங்கும்போது என்ன செய்கிறது என்பதைப் புரிந்துகொண்டால் மட்டுமே அர்த்தமுள்ளதாக இருக்கும்.

இந்தக் கடைசி காரணத்தினால்தான், இதை ஒரு desktop-ல் இயக்காமல் VPS (virtual private server)-ல் இயக்க வேண்டும். நினைவகத்தை வைத்திருக்கும் மற்றும் திட்டமிடப்பட்ட பணிகளைச் செய்யும் ஒரு bot, நீங்கள் தூங்கும்போது கூட அணுகக்கூடியதாக இருக்க வேண்டும். suspend நிலைக்குச் செல்லும் ஒரு laptop, queue-வை நிறுத்திவிடும்.

Rakazo அக்டோபர் 2026 நிலவரப்படி stable-numbered releases-களை வெளியிட்டாலும், அது இன்னும் beta நிலையிலேயே இருப்பதாகக் குறிப்பிடுகிறது. எனவே, இதை ஒரு முழுமையான தயாரிப்பாகக் கருதாமல், ஒரு செயல்பாட்டு அமைப்பாகக் கருதுங்கள். இதன் stack முழுவதும் TypeScript-ல் உள்ளது: web app-க்கு React 19 மற்றும் Vite, API-க்கு Hono, தரவுத்தளத்திற்கு Prisma-வுடன் கூடிய Postgres, கணக்குகளுக்கு Better Auth, மற்றும் பின்னணிப் பணிகளுக்கு Graphile Worker. Graphile Worker தனது queue-வை Postgres-க்குள்ளேயே சேமிப்பதால், Redis அல்லது இரண்டாவது தரவுத்தளம் எதையும் இயக்க வேண்டிய அவசியமில்லை. .env.example என்பது WAKEUP_DRIVER=graphile-ஐ அமைக்கிறது, அதாவது ஒரு bot விழித்தெழுவது என்பது Postgres-ஆல் ஆதரிக்கப்படும் ஒரு பணியாகும். Postgres-ஐ நிறுத்தினால், திட்டமிடப்பட்ட அனைத்து bot செயல்பாடுகளும் நின்றுவிடும். மற்றவர்களின் தயாரிப்பை இயக்குவதற்குப் பதிலாக, பாகங்களிலிருந்து ஒரு agent-ஐ நீங்களே உருவாக்க விரும்பினால், கூறுகளைக் கொண்டு உங்கள் சொந்த agent-ஐ உருவாக்குதல் என்பது மற்றொரு வழியாகும்.

1 GB திட்டம் ஏன் இதற்குப் போதாது

செயல்முறைகளை (processes) எண்ணிப் பாருங்கள். Postgres ஒன்று. API ஒரு Node செயல்முறை. Worker இரண்டாவது. Web app மூன்றாவது. Sandbox supervisor நான்காவது. அடுத்து பாட்களின் (bots) கணினி வருகிறது: இயல்பாக, ஒரு பகிரப்பட்ட Team Computer container-ல் ஒரு graphical Linux desktop இருக்கும். இதில் இயங்கும் ஒவ்வொரு பாட்டிற்கும் தனித்தனி X display மற்றும் Chrome செயல்முறை இருக்கும்.

இந்தத் திட்டத்தின் self-host ஆவணத்தில் இப்போது host அளவு குறிப்பிடப்படவில்லை. v0.3.5-ல் உள்ள ஆவணம், 27 அக்டோபர் 2026 அன்று சரிபார்க்கப்பட்டபோது, மென்பொருள் தேவைகளை மட்டுமே பட்டியலிட்டது. அது குறிப்பிடுவது ஒரு கணினிக்குமான உச்ச வரம்பு (ceiling) மட்டுமே: Docker sandboxes-உடன், RAKAZO_COMPUTER_MEMORY இயல்பாக 2g என்றும், RAKAZO_COMPUTER_CPUS என்பது 2 என்றும் அமையும். இந்த உச்ச வரம்பு ஒவ்வொரு பாட்டிற்கும் அல்ல, ஒவ்வொரு கணினிக்கும் பொருந்தும். ஒவ்வொரு workspace-க்கும் இயல்பாக ஒரு Team Computer கிடைக்கும். அனைத்து active Team பாட்களும் தங்களின் desktop மற்றும் browser-ஐ அதற்குள்ளேயே இயக்குவதால், அவை அனைத்தும் அந்த 2 GB மற்றும் இரண்டு cores-ஐப் பகிர்ந்து கொள்கின்றன. ஒரு பாட் Private Computer-க்கு மாற்றப்பட்டால் மட்டுமே, அதற்குத் தனி container மற்றும் உச்ச வரம்பு கிடைக்கும். SANDBOX_PROVIDER=docker-ஐ அமைத்தால், அந்த desktop-கள் உங்கள் VPS-ல், control plane-க்கு மேலாக இயங்கும். எனவே, 4 GB என்பது இலக்கல்ல, அதுவே குறைந்தபட்சத் தேவை. ஒன்றுக்கும் மேற்பட்ட பாட்களை இயக்கத் திட்டமிட்டால் 8 GB-ல் தொடங்குங்கள். பகிரப்பட்ட கணினி அந்த நினைவகத்தைப் பயன்படுத்தும் வகையில் RAKAZO_COMPUTER_MEMORY-ஐ உயர்த்துங்கள். பாட்கள் இயங்கும்போது docker stats மூலம் உண்மையான அளவீட்டைச் சரிபாருங்கள். Sandbox-க்குள் இருக்கும் browser-தான் நினைவகப் பயன்பாட்டை மாற்றும், எனவே விவரக்குறிப்புத் தாள் (spec sheet) உங்களுக்குத் துல்லியமான தகவலைத் தராது. ஒரு சிறிய பெட்டியில் ஒரே நேரத்தில் அதிகப்படியான browser-கள் இயங்குவதைத் தடுக்க, நேர்மறையான SANDBOX_TEAM_SCREEN_LIMIT மதிப்பை அமைக்கவும்; இது Docker Team Computer-ல் இயங்கும் desktop-களின் எண்ணிக்கையைக் கட்டுப்படுத்தும். வழங்கப்பட்ட 0-ல் எந்தக் கட்டுப்பாடும் இல்லை. நினைவகம் குறைவாக இருந்தால், RAKAZO_COMPUTER_MEMORY-க்கு 1536m போன்ற சிறிய மதிப்பையும் பயன்படுத்தலாம். ஏஜென்ட் பணிக்கான VPS அளவைத் தீர்மானிக்கும் பொதுவான முறைக்கு, ஒரு ஏஜென்ட் VPS-க்கு உண்மையில் எவ்வளவு RAM மற்றும் CPU தேவை என்பதை விரிவாகப் பார்க்கவும்.

ஒரு அமைப்பு, நிலைமை மோசமடைவதைத் தடுக்கிறது. .env.example-ல் SANDBOX_IDLE_MS=600000 வழங்கப்படுகிறது. அதன் குறிப்பின்படி, குறிப்பிட்ட மில்லி விநாடிகள் செயலற்ற நிலையில் (idle) இருந்தால் கணினிகள் இடைநிறுத்தப்படும் அல்லது நிறுத்தப்படும். பத்து நிமிடங்கள் செயலற்ற நிலையில் இருந்தால் கணினி நீக்கப்படும். ஏற்றுக்கொள்ளப்பட்ட குறைந்தபட்ச மதிப்பு 30000 ஆகும்; 0 என அமைத்தால் idle sleep முடக்கப்படும். Docker self-host-களில் செயலற்ற கணினியால் செலவு இல்லை என்பதால், நீண்ட நேரம் இயங்கும் செயலிகள் மற்றும் அமர்வுகள் (sessions) அப்படியே இருக்க 0 என அமைக்க அதே குறிப்பு பரிந்துரைக்கிறது. இது பணத்திற்கு மட்டுமே பொருந்தும், நினைவகத்திற்கு அல்ல. சிறிய VPS-ல், இந்த டைமரைச் செயல்பாட்டில் வைத்திருங்கள். இல்லையெனில், நீங்கள் தொடங்கிய ஒவ்வொரு கணினியும், அதற்குள் இருக்கும் ஒவ்வொரு browser-ம் தொடர்ந்து இயங்கிக்கொண்டே இருக்கும்.

வட்டு (disk) அளவும் முக்கியம். Sandbox image, Node modules மற்றும் Postgres volume ஆகியவை ஒரே வட்டைப் பகிர்ந்துகொள்வதால், 40 GB என்பது தொடங்குவதற்குச் சரியான அளவாகும்.

Clone செய்வதற்கு முன் ஒரு பதிப்பை (version) உறுதிப்படுத்தவும்

Rakazo மிக வேகமாக மேம்படுத்தப்படுகிறது, மேலும் main என்பது ஒரு release அல்ல. 9 நவம்பர் 2026 நிலவரப்படி, 4 நவம்பர் 2026 அன்று வெளியிடப்பட்ட v0.8.0, Latest என்று குறிக்கப்பட்டுள்ளது. இந்த வழிகாட்டி 25 அக்டோபர் 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 சுட்டிக்காட்டுகிறது. ஒரு branch அல்லது tag-ஐப் பயன்படுத்துவதற்குப் பதிலாக, commit-ஐ உறுதிப்படுத்தவும் (pin). அடுத்த git pull-ன் போது ஒரு branch மாறக்கூடும்; அதேபோல், ஒரு maintainer எப்போது வேண்டுமானாலும் ஒரு tag-ஐ மாற்றியமைக்கலாம். எனவே, இவை இரண்டுமே நீங்கள் மீண்டும் திரும்ப வரக்கூடிய ஒரு நிலையான நிலையை உறுதிப்படுத்தாது. ஒரு commit identifier மாறாது. உங்கள் server-ன் பிற விவரங்களுடன் இதையும் குறித்து வைத்துக்கொள்ளுங்கள். ஏனெனில், ஒரு upgrade தோல்வியடையும் போது, git checkout <old commit> செய்து மீண்டும் கட்டமைப்பதே எளிதான தீர்வாகும். எந்த commit சரியாக வேலை செய்தது என்பது தெரிந்தால் மட்டுமே இது சாத்தியம். Rakazo-வின் README கோப்பு இதை beta என்று குறிப்பிடுவதால், இந்த பதிப்பைத் துல்லியமாக உறுதிப்படுத்துவது அவசியமானது. முறையான release வரலாற்றைக் கொண்ட திட்டங்களுக்கு, openGym போன்ற சிறிய self-hosted stack செய்வது போல, ஒரு குறிப்பிட்ட tag-ஐப் பயன்படுத்தலாம்.

தேவைகள்: Node 22, pnpm 9, மற்றும் Docker

node -v
pnpm -v
docker --version

package.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 மற்றும் அதற்கு மேற்பட்ட பதிப்பையும் காட்ட வேண்டும். v22 பதிப்பு 22.22.2-க்கு முந்தையதாக இருந்தால் அது இந்த வரம்பிற்குள் வராது. மேலும், Node.js 23.x மற்றும் 25.x பதிப்புகளுக்கு ஆதரவு இல்லை என்று README கோப்பில் தெளிவாகக் குறிப்பிடப்பட்டுள்ளது. NodeSource அல்லது nvm மூலம் ஆதரிக்கப்படும் Node பதிப்பை நிறுவவும். Corepack ஆனது Node 22 மற்றும் 24 உடன் வருகிறது; Node 26 மற்றும் அதற்கு மேற்பட்ட பதிப்புகளில், முதலில் அதை npm install -g corepack மூலம் நிறுவவும். பிறகு pnpm-ஐ இயக்கவும்:

corepack enable
corepack prepare pnpm@9.15.0 --activate

Docker Engine மற்றும் அதனுடன் கூடிய compose plugin ஆகியவை மீதமுள்ள தேவைகளைப் பூர்த்தி செய்கின்றன. Bot home volume subpaths-க்காக, Docker Engine 26 அல்லது அதற்குப் புதிய பதிப்பும், API 1.45 அல்லது அதற்குப் புதிய பதிப்பும், அத்துடன் curl மற்றும் OpenSSL ஆகியவையும் தேவை என்று self-host ஆவணங்கள் குறிப்பிடுகின்றன. உங்கள் பயனர் கணக்கு Docker daemon-ஐ அணுகும் திறன் கொண்டிருக்க வேண்டும். docker ps கட்டளை permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock என்று பதிலளித்தால், உங்கள் பயனரை docker குழுவில் சேர்த்துவிட்டு, புதிய login shell-ஐத் தொடங்கவும். இது எத்தகைய அதிகாரத்தை வழங்குகிறது என்பதை முதலில் புரிந்துகொள்ளுங்கள்: docker குழுவில் உறுப்பினராக இருப்பது, அந்த கணினியில் root பயனராக இருப்பதற்குச் சமம். ஏனெனில், அக்குழுவில் உள்ள எவரும் 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 ஆகியவற்றை காலியாக விடுகிறது. அந்த இடங்கள் அனைத்தும் களஞ்சியத்தில் (repository) பகிரங்கமாக இருப்பதால், அவற்றை மாற்றாமல் அப்படியே பயன்படுத்தினால், எவரும் அறியக்கூடிய ரகசியங்களைக் கொண்டு சேவை இயங்கும். ஒவ்வொன்றிற்கும் தனித்துவமான சீரற்ற (random) மதிப்பை வழங்கவும். ENCRYPTION_KEY என்பது 64 சீரற்ற hex எழுத்துக்களாக இருக்க வேண்டும், இதைத்தான் openssl rand -hex 32 அச்சிடுகிறது. மற்ற ரகசியங்களுக்கு 32 அல்லது அதற்கு மேற்பட்ட எழுத்துக்கள் தேவை, எனவே ஒவ்வொரு ரகசியத்திற்கும் base64 வரியை ஒருமுறை இயக்கவும். Postgres கடவுச்சொற்கள் இரண்டிற்கும் URL-safe மதிப்புகளை சுய-வழங்கி (self-host) ஆவணங்கள் கோருகின்றன, இதை கடைசி வரி வழங்குகிறது, எனவே இதையும் ஒவ்வொன்றிற்கும் ஒருமுறை இயக்கவும். தரவுத்தளத்தில் இரண்டு உள்நுழைவுகள் உள்ளன. DATABASE_MIGRATION_URL ஆனது postgres://rakazo:REPLACE_WITH_POSTGRES_PASSWORD@127.0.0.1:5433/rakazo ஆக வருகிறது, இது migration-களை இயக்கும் உரிமையாளர்; DATABASE_URL ஆனது postgres://rakazo_app:REPLACE_WITH_POSTGRES_APP_PASSWORD@127.0.0.1:5433/rakazo ஆக வருகிறது, இது செயலியின் சொந்த உள்நுழைவு, இதற்கு superuser உரிமைகள் இல்லை மற்றும் இது row-level security-க்கு உட்பட்டது. ஒவ்வொரு கடவுச்சொல்லையும் அதன் சொந்த URL-ல் உள்ளிடவும். pnpm db:migrate ஆனது நீங்கள் அமைத்த கடவுச்சொல்லுடன் rakazo_app உள்நுழைவை உருவாக்குகிறது.

openssl rand -base64 48
openssl rand -hex 32
openssl rand -hex 24

பின்னர் தரவுத்தளத்தை மட்டும் தனியாகத் தொடங்கி, migration-களை இயக்கவும்.

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

pnpm sandbox:build ஆனது bot கணினி பிம்பத்தை (image) உருவாக்குகிறது, இது package.json-ல் docker build -t rakazo/computer:local infra/sandboxes/computer என வரையறுக்கப்பட்டுள்ளது. இது ஒரு வரைகலை (graphical) பிம்பம் என்பதால், முதல் முறை உருவாக்கும்போது பல கோப்புகளைப் பதிவிறக்கம் செய்யும், எனவே இதற்கு நேரம் எடுக்கும். docker image ls rakazo/computer மூலம் அது பதிவிறக்கம் செய்யப்பட்டதை உறுதிப்படுத்தவும், இது ஒரு வரி வெளியீட்டைக் காட்ட வேண்டும்.

அடிப்படை compose கோப்பு எந்தவொரு Postgres port-ஐயும் பொதுவெளியில் திறக்காது. அந்த கட்டளையில் உள்ள docker-compose.postgres-host.yml மேலடுக்கு (overlay), அதை 127.0.0.1:5433 ஆக வெளியிடுகிறது, இது loopback-க்கு மட்டுமே உரியது, எனவே pnpm db:migrate மற்றும் pnpm dev போன்ற host-side கருவிகள் அதை அணுக முடியும். அதை அப்படியே விடவும். .env-ல் POSTGRES_PASSWORD இல்லாமல் Postgres-ஐத் தொடங்க Compose மறுத்துவிடும், ஆனால் இணையத்திலிருந்து அணுகக்கூடிய Postgres port கடவுச்சொல் தாக்குதல்களை (password attacks) அழைக்கும். தயாரிப்பு (production) compose கோப்பு அதே மாறியைப் படிக்கிறது மற்றும் எந்தவொரு தரவுத்தள port-ஐயும் பொதுவெளியில் திறப்பதில்லை.

முதல் இயக்கம் (First run)

pnpm dev

இது நான்கு விஷயங்களைத் தொடங்குகிறது: port 3100-ல் API, Graphile Worker, 5173-ல் Vite web app, மற்றும் இயல்பாக 7091-ல் sandbox supervisor. அந்த ports ஏற்கனவே பயன்பாட்டில் இருந்தால், pnpm dev மற்றொரு காலியான தொகுப்பைத் தேர்ந்தெடுத்து URL-களைக் காட்டும். இயல்புநிலை ports-ல், app http://127.0.0.1:5173-ல் இருக்கும்; அங்கு நீங்கள் sign-in பக்கத்தைப் பார்க்கலாம்.

ஒரு VPS-ல் நீங்கள் நேரடியாக அந்த இயந்திரத்தின் முன் அமரவில்லை என்பதால், அதை அணுக 5173-ஐ public-ஆக வெளியிடக்கூடாது. அதற்குப் பதிலாக, உங்கள் சொந்த இயந்திரத்திலிருந்து 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, Vite-ஐ host-ல் உள்ளூரில் இயக்கும். Development compose கோப்பின் web service, 127.0.0.1:5173:5173-ஐயும், அதன் api service 127.0.0.1:3100:3100-ஐயும் வெளியிடும்; இவை இரண்டும் loopback-க்கு மட்டுமே என்பதால், அதே tunnel இதற்கும் வேலை செய்யும். Production கோப்பில், web app எந்த host port-ஐயும் வெளியிடுவதில்லை; அது தனது சொந்த network-ல் உள்ள containers-க்கு மட்டுமே 5173-ஐத் திறக்கிறது. Caddy மட்டுமே 80 மற்றும் 443 ports-ஐ வெளியிடுகிறது. எனவே, நீங்கள் தொடர்ந்து இயக்கும் எதற்கும் production கோப்பையும் அதன் reverse proxy-யையும் பயன்படுத்தவும்.

server-ல் எந்த sandbox provider பாதுகாப்பானது?

இதைச் சரியாக அமைப்பது மிக முக்கியம். SANDBOX_PROVIDER, .env-ல் இயல்பாகவே docker என இருக்கும். self-host ஆவணத்தில் குறிப்பிடப்பட்டுள்ள பிற provider-களுடன் சேர்த்து, pinned checkout-ம் Railway-ஐ ஆதரிக்கிறது.

  • docker இயல்பான அமைப்பாகும். Bot கணினிகள் உங்கள் இயந்திரத்தில் containers-ஆக இயங்குகின்றன. இவை pnpm sandbox:build image-லிருந்து உருவாக்கப்பட்டு, ஒரு supervisor-ன் கீழ் இயங்குகின்றன. ஒரு workspace-ல் உள்ள அனைத்து bot-களும் இயல்பாக ஒரே Team Computer-ஐப் பகிர்ந்து கொள்கின்றன. ஒரு bot-க்குத் தனி container வேண்டுமெனில், அது Private Computer-ல் மட்டுமே கிடைக்கும். இதற்கு E2B கணக்கு தேவையில்லை.
  • e2b, bot கணினிகளை E2B-ல் இயக்குகிறது; இதற்கு E2B_API_KEY தேவை. v0.3.5-ல், key வழங்கப்பட்டால், production-ல் எந்த NODE_ENV கட்டுப்பாடும் இன்றி இது செயல்படும். பொது அல்லது பல பயனர்கள் கொண்ட production சூழலுக்கு இது ஏற்றது என்று self-host ஆவணம் கூறுகிறது. ஏனெனில், இது உங்கள் API மற்றும் database இயங்கும் host-லிருந்து bot கணினிகளைத் தனிமைப்படுத்துகிறது.
  • daytona, createos மற்றும் boat ஆகியவை பிற remote provider-கள். ஒவ்வொன்றிற்கும் தனித்தனி key தேவை: DAYTONA_API_KEY, CREATEOS_SANDBOX_API_KEY அல்லது BOAT_API_KEY.
  • railway, Railway-ல் கணினிகளை இயக்குகிறது. இதற்கு RAILWAY_API_TOKEN மற்றும் API/worker-ல் பிரத்யேகமாகத் தேர்ந்தெடுக்கப்பட்ட RAILWAY_ENVIRONMENT_ID தேவை. Sandbox-களுக்கென தனி Railway project அல்லது environment-ஐப் பயன்படுத்தவும்.
  • desktop, bot-ன் கட்டளைகளை நேரடியாக API மற்றும் worker host-ல் இயக்குகிறது. v0.3.5-ல், NODE_ENV என்பது development அல்லது test என இல்லாவிட்டால், API மற்றும் worker இதை நிராகரிக்கும். ஆனால், .env.example ஆனது NODE_ENV=development-ஐக் கொண்டிருப்பதால், pnpm dev இயங்கும் server இதை அனுமதிக்கும். பொது அல்லது பகிரப்பட்ட சேவைகளில் இதை இயக்க வேண்டாம்.
  • fake என்பது சரிபார்ப்பிற்கான ஒரு emulator மட்டுமே. இது runtime அல்ல.
  • none, எந்தவொரு கணினி host-ம் இன்றி தயாரிப்பைத் தொடங்குகிறது.

இதை அப்படியே எடுத்துக்கொள்ளுங்கள். desktop mode-ல் எந்தவொரு தனிமைப்படுத்தும் எல்லையும் (isolation boundary) இல்லை. எனவே, API process-ஐ இயக்கும் பயனரின் உரிமைகளுடன் bot shell கட்டளைகளை இயக்கும். அந்த பயனரின் home directory, SSH keys, cloud credentials மற்றும் .env ஆகிய அனைத்தும் bot-க்குக் கிடைக்கும். bot படிக்கும் இணையப் பக்கத்தில் உள்ள உரை, உங்கள் server-ல் ஒரு கட்டளையாக மாறும். server-ல் desktop mode-ஐப் பயன்படுத்தினால், உங்கள் credentials bot-ன் கைக்குச் செல்ல வாய்ப்புள்ளது. நீங்கள் அமர்ந்து வேலை செய்யும் இயந்திரத்தில் மட்டும் இதைப் பயன்படுத்தவும், அல்லது பயன்படுத்தவே வேண்டாம். provider-களை மாற்றுவது அந்த இணையப் பக்கப் பாதையை ஒரு container-க்குள் வைக்குமே தவிர, அதை மூடிவிடாது. bot-க்குத் தனி SearXNG search backend வழங்குவது தேடல் பக்கத்திலிருந்தும் இத்தகைய ஊடுருவல் அபாயத்தைக் குறைக்கும்.

docker என்பது bot-களுக்கும் உங்கள் host-க்கும் இடையிலான உண்மையான எல்லை. ஆனால், bot-களுக்கு இடையே இது பலவீனமான எல்லையே. இயல்பாக அவை ஒரே Team Computer-ஐப் பகிர்வதால், Team bot-கள் ஒரே OS பயனர், workspace, browser profiles மற்றும் shell/X11 அணுகலைப் பகிர்ந்து கொள்கின்றன என்று கணினி runtime ஆவணம் கூறுகிறது. ஒவ்வொரு bot-க்கும் தனித்தனி கோப்புறைகள் இருந்தாலும், அவை பாதுகாப்பு எல்லைகள் அல்ல. எனவே, ஒரு Team bot மற்றொரு Team bot-ன் கோப்புகளைப் படிக்க முடியும். தனித்தனி பாதுகாப்பு எல்லை தேவைப்படும் bot-களை Private Computer-ல் வைக்க வேண்டும். docker provider இதைத் தனி network-ல் ஒரு sibling container-ஆக இயக்குகிறது. இருப்பினும், அந்த container-களை உருவாக்கும் supervisor /var/run/docker.sock-ஐ mount செய்கிறது. self-host ஆவணம் கூறுவது போல, அந்த socket-க்கான அணுகல் என்பது Docker host-ஐக் கட்டுப்படுத்துவதற்குச் சமம். எனவே, supervisor-ஐப் பாதுகாப்பாக வைத்திருக்கவும். .env.example, SANDBOX_SUPERVISOR_TOKEN-ஐ BETTER_AUTH_SECRET-லிருந்து வேறுபட்ட ஒரு பிரத்யேக credential-ஆகக் கருதுகிறது. Docker sandbox-களுக்கு local development-க்கு வெளியே இது தேவை. GitHub-ல் எவரும் படிக்கக்கூடிய ஒரு placeholder-உடன் இது வருகிறது. இதற்குத் தனித்துவமான, சீரற்ற (random) மதிப்பினை வழங்கவும். இங்குள்ள மிக வலுவான பிரிவினைக்கு e2b-ஐப் பயன்படுத்தவும், அல்லது Rakazo-விற்கு வேறு எந்தப் பணியும் இல்லாத ஒரு தனி இயந்திரத்தை வழங்கவும். coding agents-ஐ disposable VM-ல் இயக்குவது என்பதன் பின்னணியிலும் இதே தர்க்கம்தான் உள்ளது: ஒரு agent தவறு செய்தால், அதைச் சமாளிக்க மிக மலிவான வழி, அந்த இயந்திரத்தில் மதிப்புமிக்க தரவுகள் ஏதும் இல்லாமல் இருப்பதே ஆகும்.

Model API keys எங்கே வைக்கப்பட வேண்டும்?

Stripe secrets இரண்டும் அமைக்கப்படாத வரை, Rakazo-வின் விருப்பத்தேர்வுக்குரிய model-credit billing முடக்கப்பட்டிருக்கும். நீங்கள் உங்கள் சொந்த key-ஐ வழங்க வேண்டும். .env.example ஆனது PI_DEFAULT_PROVIDER=openrouter-ஐ அமைக்கிறது, எனவே OPENROUTER_API_KEY என்பதே வழக்கமான இடமாகும்; provider keys-ம் அதே அமைப்பின் மூலமே செயல்படுகின்றன.

Key-ஐ .env-ல் வைத்திருங்கள்; git-ல் commit செய்யும் எந்தக் கோப்பிலும் அதைச் சேர்க்க வேண்டாம். களஞ்சியத்தில் (repository) உள்ள இரண்டு compose கட்டளைகளும் --env-file .env-ஐப் பயன்படுத்துகின்றன, எனவே git கண்காணிக்கும் YAML கோப்பில் எழுதப்படாமலேயே மதிப்புகள் containers-க்குச் சென்றடையும். நீங்கள் OPENROUTER_API_KEY-ஐ காலியாக விட்டுவிட்டு, signup செய்த பிறகு app-ல் ஒரு model-ஐ இணைக்கலாம். இதனால்தான் ENCRYPTION_KEY-க்கு வழங்கப்பட்ட placeholder-க்கு பதிலாக ஒரு உண்மையான random மதிப்பை அமைப்பது அவசியமாகிறது.

Bot பயன்படுத்துவதற்கு முன்பே, provider தளத்தில் அந்த key-க்கு ஒரு spending limit-ஐ நிர்ணயித்துவிடுங்கள். ஒரு bot loop-ல் சிக்கினால், அது பணத்தைச் செலவழிக்கும். Rakazo MAX_TOOL_CALLS_PER_TURN-ஐயும் வழங்குகிறது: ஒரு turn-ன் tool-call வரம்பை மீறும்போது, அதை soft-stop செய்ய ஒரு positive integer-ஐ அமைக்கவும்; இது இறுதி assistant message-ஐ உருவாக்குவதை நிறுத்தாது. இது அமைக்கப்படாவிட்டாலோ, காலியாக இருந்தாலோ அல்லது 0 ஆக இருந்தாலோ, வரம்பு இல்லாமல் இருக்கும். இது பணத்தை அல்ல, tool calls-ஐ மட்டுமே கணக்கிடுகிறது, எனவே இது provider-ன் spending limit-க்கு மாற்றாகாது. இந்த key-க்குத் தனிப் பெயர் கொடுங்கள், அப்போதுதான் தேவைப்பட்டால் அதை மட்டும் தனியாக revoke செய்ய முடியும். உங்களுக்காக அல்லாமல் ஒரு குழுவிற்காக இதை அமைக்கிறீர்கள் என்றால், OneCLI's one gateway in front of everyone's agent என்பது இதற்கான மாற்றுத் தீர்வாகும்; ஏனெனில் இது provider keys-ஐ ஒவ்வொரு நபருக்கும் தனித்தனியாக வைக்காமல், ஒரே இடத்தில் பாதுகாப்பாக வைத்திருக்கும்.

Development mode-லிருந்து நிரந்தர இயக்கத்திற்கு மாறுதல்

இந்த repository-ல் production compose file ஒன்று உள்ளது. இது Postgres, API, worker, web app மற்றும் தானாகவே TLS (transport layer security) certificates-ஐப் பெறும் Caddy ஆகியவற்றை இயக்குகிறது. இதில் Caddy மட்டுமே ports-ஐ வெளியுலகிற்குத் திறக்கிறது. இது bot computers-க்காக இயல்பாகவே E2B-ஐப் பயன்படுத்துகிறது. infra/compose/docker-compose.prod.docker.yml என்ற விருப்பத்தேர்வு overlay, local Docker computers-ஐ அதே stack-ல் இயக்குகிறது. இது சேர்க்கும் supervisor, host-ல் root-க்கு இணையான அதிகாரத்தைக் கொண்டிருக்கும் என்று ஆவணங்கள் எச்சரிக்கின்றன.

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

script-ஐ இயக்குவதற்கு முன்பு, key-only deploy account ஒன்றை உருவாக்கி, அதில் login செய்ய முடிகிறதா என்பதை உறுதிப்படுத்தவும். harden-host.sh, SSH password மற்றும் root login-ஐ முடக்குகிறது, SSH rate-limit செய்கிறது, UFW (uncomplicated firewall) மூலம் SSH, HTTP மற்றும் HTTPS ஆகியவற்றுக்கு அனுமதி அளிக்கிறது (ஏற்கனவே உள்ள private-network விதிகளைப் பாதுகாத்து), மேலும் fail2ban, unattended security updates, AppArmor மற்றும் audit விதிகளைச் செயல்படுத்துகிறது. SSH_CONNECTION இல்லாமல் இது இயங்காது, அதனால்தான் கட்டளை அதை sudo வழியாக அனுப்புகிறது. மூன்று நிமிடங்களுக்குள் புதிய SSH session மூலம் நீங்கள் உறுதிப்படுத்தாவிட்டால், இது firewall மாற்றங்களை மீண்டும் பழைய நிலைக்குக் கொண்டு வந்துவிடும். இதை இயக்குவதற்கு முன் படித்துப் பார்க்கவும், ஏனெனில் இது உங்கள் login முறையை மாற்றி SSH-ஐ reload செய்கிறது. புதிய SSH login வெற்றிகரமாக முடியும் வரை உங்கள் provider-ன் console-ஐத் திறந்து வைத்திருக்கவும்.

Production .env-க்கு development-ஐ விட அதிகத் தேவைப்படுகிறது. self-host ஆவணத்தில் இதற்கான குறைந்தபட்சத் தேவைகள் மற்றும் secrets பட்டியலிடப்பட்டுள்ளன.

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-ஐ point செய்யவும். RAKAZO_HOST-ல் உள்ள பெயருக்காக Caddy certificate கோருகிறது; அந்தப் பெயர் இந்த server-ஐச் சென்றடைய வேண்டும். HTTP validation-க்கு port 80 அல்லது TLS-ALPN validation-க்கு port 443 ஆகியவற்றுள் ஏதேனும் ஒன்று வெளியிலிருந்து அணுகக்கூடியதாக இருக்க வேண்டும். இரண்டு சவால்களும் (challenges) இயல்பாகவே செயல்படுத்தப்பட்டிருக்கும், எனவே port 80-ஐ மட்டும் மூடுவது port 443 வழியாக certificate கிடைப்பதைத் தடுக்காது.

தொடக்கத்திலிருந்தே SIGNUP_ALLOWLIST-ஐ உங்கள் சொந்த முகவரிக்கு அமைத்துக்கொள்ளவும். .env.example, SIGNUPS_ENABLED=true-ஐக் கொண்டுள்ளது. API தொடங்கும் ஒவ்வொரு முறையும் இந்த இரண்டு அமைப்புகளும் environment-லிருந்து வாசிக்கப்படும். எனவே, public name-ல் இயங்கும் ஒரு instance-ல் signups ஆன் செய்யப்பட்டு, allowlist இல்லாமல் இருந்தால், அதைக் கண்டறியும் எவரும் பதிவு செய்யலாம். ஒவ்வொரு முறை தொடங்கும்போதும், காலியாக இல்லாத allowlist பயன்படுத்தப்பட்டு, சேமிக்கப்பட்ட பட்டியல் மாற்றப்படும். Allowlisted signup-க்கு mailbox சரிபார்ப்பு அவசியம், முதல் account-ம் இதில் அடங்கும். எனவே, பதிவு செய்வதற்கு முன் email delivery-ஐ அமைக்கவும். Email இல்லையென்றால், SIGNUPS_ENABLED=false-ல் தொடங்கி, அது வழங்கும் server-side bootstrap கட்டளை மூலம் உங்கள் account-ஐ உருவாக்கலாம். இது server உரிமைகள் இல்லாத சாதாரண சரிபார்க்கப்பட்ட account-ஐ உருவாக்கும். முதலில் allowlist-ஐ அமைக்கவும். தேவைப்பட்டால் பிறகு அதைத் தளர்த்திக்கொள்ளலாம். ஒரே server-ல் பல சேவைகளை இயக்கும்போது, ஒவ்வொரு app-க்கும் தனித்தனி allowlist-க்கு பதிலாக, Authentik instance-ஐ முன்னால் வைப்பது அந்த முடிவை proxy-க்கு மாற்றும். இருப்பினும், இது Rakazo-வின் சொந்த Better Auth account-களுக்கு முன்னால் இருக்குமே தவிர, அவற்றை மாற்றாது.

Repository-ல் உள்ள docs/self-host.md-ஐ production அமைப்புகளுக்கான அதிகாரப்பூர்வ ஆதாரமாகக் கருதவும், ஏனெனில் code மாறும்போது அதுவும் மாறும், இந்த வழிகாட்டி மாறாது. Compose வேலையைச் செய்வதால், சாதாரண விதிகள் பொருந்தும். Docker Compose basics for a VPS-ல், ஒரு stack-ஐ மாதக்கணக்கில் இயக்கும்போது ஏன் --env-file மற்றும் named volumes முக்கியம் என்பது விளக்கப்பட்டுள்ளது.

காப்புப்பிரதிகள் (Backups)

இந்த அமைப்பில் Postgres மற்றும் data/ கோப்பகம் ஆகியவை instance-ன் தரவுகளைக் கொண்டுள்ளன; மீட்பு நடவடிக்கைக்கு ENCRYPTION_KEY மற்றும் உள்ளமைக்கப்பட்ட content master keys ஆகியவையும் தேவைப்படும், எனவே இவற்றின் பிரதிகளை server-க்கு வெளியே பாதுகாப்பாக வைத்திருக்கவும்.

./scripts/backup.sh
./scripts/restore.sh backups/BACKUP_TIMESTAMP

backup.sh ஆனது Postgres-ஐ dump செய்து data/-ஐ காப்பகப்படுத்துகிறது (archive). restore.sh என்பது development Compose stack-ல், application services நிறுத்தப்பட்ட நிலையில், காலியான database-ல் இயங்கக்கூடியது; இது production backup கோப்புகளை வாசிப்பதில்லை. நீங்கள் சார்ந்திருக்கும் ஒரு machine-க்கு, repository வழங்கும் timer-ஐப் பயன்படுத்தி infra/compose/backup-prod.sh-ஐ /usr/local/sbin/rakazo-backup ஆக நிறுவவும். இது சரிபார்க்கப்பட்ட dump மற்றும் app-data காப்பகத்தை /var/backups/rakazo-ல் எழுதுகிறது. RAKAZO_BACKUP_KEEP மூலம் நிர்ணயிக்கப்பட்டபடி, இயல்பாக மூன்று சரிபார்க்கப்பட்ட snapshots-களை இது வைத்திருக்கும். RAKAZO_BACKUP_MAX_GB மூலம் 50 GiB அளவு வரம்பு அமைக்கப்பட்டுள்ளது. ஒவ்வொரு முறை இயங்குவதற்கு முன்பும், முழுமையற்ற snapshots மற்றும் கூடுதல் வரலாற்றை இது நீக்கிவிடும், எனவே rotation தானாகவே நடக்கும். /etc/rakazo/backup.env-ல் நீங்கள் குறிப்பிடும் public recipients-க்கு, age மூலம் ஒவ்வொரு backup-ஐயும் இது encrypt செய்ய முடியும்; இதனால் server-ஆல் வாசிக்க முடியாதவாறு backups எழுதப்படும். அந்த key pair-ஐ உங்கள் கட்டுப்பாட்டில் உள்ள ஒரு machine-ல் உருவாக்கி, private key-ஐ server-க்கு வெளியே வைத்திருக்கவும். recipients இல்லையெனில், backup plaintext-ஆகவே இருக்கும் மற்றும் ஒரு எச்சரிக்கை பதிவு செய்யப்படும். ஆனால், முதல்முறை encrypted backup செய்த பிறகு, recipients இல்லாமல் இயக்கும்போது, RAKAZO_BACKUP_ALLOW_PLAINTEXT=1 மூலம் plaintext-ஐ நீங்கள் வெளிப்படையாக அனுமதித்தால் ஒழிய, அந்த செயல்முறை தோல்வியடையும். database இருக்கும் அதே disk-ல் இருக்கும் backup ஒரு உண்மையான backup அல்ல, எனவே அதை server-லிருந்து வெளியே நகலெடுக்கவும். பின்னர், தேவைப்படுவதற்கு முன்பே, ஒரு spare server-ல் அதை ஒருமுறை restore செய்து சோதிக்கவும்.

இது ஏன் தோல்வியடைகிறது மற்றும் நீங்கள் எதைக் காண்பீர்கள்

pnpm db:migrate தரவுத்தளத்தை அடைய முடியவில்லை. தரவுத்தள சேவையகத்தை 127.0.0.1:5433 முகவரியில் அணுக முடியவில்லை என்று இடம்பெயர்வு (migration) தெரிவிக்கிறது. Postgres container இயங்காமல் இருக்கலாம், அல்லது அது இயங்கினாலும் இன்னும் தயாராகாமல் இருக்கலாம், அல்லது docker-compose.postgres-host.yml overlay இல்லாமல் அது தொடங்கப்பட்டிருக்கலாம்; இதுதான் 5433 port-ஐ host-க்கு வெளியிடுகிறது. docker compose --env-file .env -f infra/compose/docker-compose.yml ps கட்டளையை இயக்கவும், postgres சேவை 'healthy' என்று காட்டுகிறதா என்று பார்க்கவும். ஏனெனில், compose கோப்பில் ஒவ்வொரு மூன்று வினாடிக்கும் இயங்கும் health check உள்ளது. container மீண்டும் மீண்டும் restart ஆனால், அதன் பதிவுகளை (logs) படிக்கவும்: Postgres 18-க்கு இடம்பெயரும் வரை, பழைய Postgres 16 volume-ல் இந்த Compose stack தொடங்க மறுக்கும். docker compose ... down -v அதை நீக்கும், அதனுடன் தரவுகளும் அழிந்துவிடும்.

port ஏற்கனவே பயன்பாட்டில் உள்ளது. 5433 port-ஐ வேறொரு சேவை பயன்படுத்தும்போது, Postgres-ஐத் தொடங்க முயன்றால் bind: address already in use பிழை ஏற்படும். பெரும்பாலும் நீங்கள் நிறுத்த மறந்துவிட்ட பழைய Rakazo stack-ஆக இது இருக்கலாம். sudo ss -lntp | grep 5433 அந்த process-ன் பெயரைத் தெரிவிக்கும். இந்த overlay, POSTGRES_HOST_PORT கோப்பிலிருந்து host port-ஐ வாசிக்கிறது. எனவே, DATABASE_URL மற்றும் DATABASE_MIGRATION_URL ஆகியவற்றை அதற்கேற்ப மாற்றினால், நீங்களும் port-ஐ மாற்றிக்கொள்ளலாம்.

bot-க்கு கணினி கிடைக்கவில்லை. SANDBOX_PROVIDER=docker மற்றும் rakazo/computer:local image இல்லாதபோது, தொடங்குவதற்கு எதுவும் இருக்காது. docker image ls rakazo/computer இதற்கு ஒரே வரியில் பதிலளிக்கும், pnpm sandbox:build அதைச் சரிசெய்யும். supervisor-ஆல் Docker socket-ஐ அடைய முடியாவிட்டால், அதால் container-களை உருவாக்க முடியாது; அந்தச் செய்தி இந்த பாதையைக் குறிப்பிடும்: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

நீண்ட கட்டளை பாதியிலேயே நின்றுவிடுகிறது. .env.example, SANDBOX_COMMAND_TIMEOUT_MS=300000-ஐ அமைக்கிறது. எனவே, bot-ன் கணினிக்குள் இருக்கும் ஒரு கட்டளை ஐந்து நிமிடங்களுக்குப் பிறகு துண்டிக்கப்படும். sandbox செயலிழந்துவிட்டதாகக் கருதாமல், மெதுவான build-களுக்கு இந்த நேரத்தை அதிகரிக்கவும்.

pnpm install குழப்பமான வழிகளில் செயலிழக்கிறது. மற்ற எதையும் சரிபார்க்கும் முன் node -v-ஐச் சரிபார்க்கவும். workspace ^22.22.2 || ^24.0.0 || >=26.0.0-ஐ அறிவிக்கிறது, எனவே 23.x, 25.x மற்றும் 22.22.2-க்கு முந்தைய எந்தவொரு 22.x பதிப்பும் இதற்குள் வராது. நிலையான .npmrc, engine-strict=true-ஐ அமைக்கிறது. எனவே, application dependency code இயங்குவதற்கு முன்பே, ஆதரிக்கப்படாத Node பதிப்பை pnpm install ஒரு engine/version பிழையுடன் நிராகரிக்கும்.

உள்ளூர் கணினியில் sign-in வேலை செய்கிறது, ஆனால் domain வழியாக வேலை செய்யவில்லை. BETTER_AUTH_URL, WEB_ORIGIN மற்றும் API_URL ஆகிய மூன்றிலும், முகவரிப் பட்டியில் (address bar) உள்ள அதே public origin இருக்க வேண்டும் (scheme உட்பட). session நிலைக்காமல் இருப்பதற்கு, இவற்றில் ஏதேனும் ஒன்றில் பழைய http://127.0.0.1:5173 இருப்பதுதான் பொதுவான காரணம்.

Pinned checkout-ஐ மேம்படுத்துதல்

உங்கள் checkout-லிருந்து உருவாக்கப்பட்ட production Compose stack-க்கான upgrade வழிமுறை எளிதானது: புதிய source-ஐ pull செய்யவும், பின் API, worker மற்றும் web app ஆகியவற்றை rebuild செய்து restart செய்யவும். API தொடங்கும்போதே அதன் start command migration-களைச் செயல்படுத்துவதால், அவை தானாகவே இயங்கும்.

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 எடுக்கவும். Migration-கள் முன்னோக்கி மட்டுமே செல்லும்; beta பதிப்பில் நீங்கள் நம்பகமான reverse path-ஐப் பெற முடியாது. உங்கள் checkout 30 August 2026-க்கு முந்தையது என்றால் (அதாவது v0.1.0-beta commit-ஐ உள்ளடக்கியது), மேம்படுத்துவதற்கு முன் 20260830200000_space_scope_names_and_user_credentials migration குறித்த ஆவணக் குறிப்பை வாசிக்கவும். இது ஒரு ஒருங்கிணைந்த cutover என்பதால், பழைய API மற்றும் worker-ஐ முதலில் நிறுத்திவிட்டு, ஆவணத்தில் கொடுக்கப்பட்டுள்ள Space privacy-boundary சோதனையை இயக்கவும். தனித்தனி app login வசதிக்கு முந்தைய checkout-லிருந்து மேம்படுத்தும்போது, rebuild செய்வதற்கு முன் .env-ல் POSTGRES_APP_PASSWORD-ஐ அமைக்கவும்; இல்லையெனில் production compose file இயங்காது. Source-checkout மற்றும் production Compose files ஆகிய இரண்டும் Postgres 18-ஐ இயக்குகின்றன: ஏற்கனவே உள்ள Postgres 16 installation புதிய அமைப்பில் இயங்க, ஆவணத்தில் உள்ள infra/compose/upgrade-postgres.sh செயல்முறையை மேற்கொள்ள வேண்டும். உங்கள் தற்போதைய pinned SHA மற்றும் புதிய SHA-க்கு இடைப்பட்ட commit-களை மேம்படுத்தும் முன் வாசிக்கவும்; ஏனெனில் இத்தகைய புதிய திட்டங்களில் environment variables அறிவிப்பின்றி மாற்றப்படலாம். விடுபட்ட variable இருந்தால், service தொடங்கி உடனே நின்றுவிடும். Rakazo-வை இயக்குவது சரியான முடிவா என்று நீங்கள் இன்னும் தீர்மானிக்கவில்லை என்றால், self-hosted AI agents-ன் தொகுப்பு இந்த வகையில் உள்ள பிற மென்பொருட்கள் மற்றும் அவற்றைப் பராமரிப்பதற்கான செலவுகள் குறித்து விளக்குகிறது.

FAQ

1 GB VPS-ல் Rakazo-வை இயக்க முடியுமா?

முடியாது. Postgres, API, worker, sandbox supervisor மற்றும் web app ஆகிய அனைத்தும் ஒரே நேரத்தில் இயங்குகின்றன. மேலும், SANDBOX_PROVIDER=docker-உடன், bots-ன் கணினி ஒரு graphical desktop-ஐக் கொண்ட container-ஐச் சேர்க்கிறது. ஒவ்வொரு active bot-க்கும் தனித்தனி X display மற்றும் Chrome process இயங்கும். இவை அனைத்தும் 2 GB memory மற்றும் இரண்டு CPUs என்ற இயல்புநிலை வரம்பிற்குள் இருக்க வேண்டும். v0.3.5-ல் உள்ள self-host ஆவணத்தில் host அளவு குறிப்பிடப்படவில்லை. Control plane-க்கு 4 GB-ஐ குறைந்தபட்ச அளவாகக் கருதுங்கள்; desktops உங்கள் இயந்திரத்தில் இயங்கும்போது இன்னும் அதிகத் தேவைப்படும்.

Desktop sandbox provider server-ல் பாதுகாப்பானதா?

இல்லை. desktop நேரடியாக API மற்றும் worker host-ல் கட்டளைகளை இயக்குவதாக self-host ஆவணம் கூறுகிறது. எனவே, அந்த process-ஐ இயக்கும் பயனராகவே bot செயல்படும்; அந்தப் பயனரின் கோப்புகள் மற்றும் credentials-ஐ அணுக முடியும். v0.3.5-ல், development மற்றும் test mode தவிர மற்ற நேரங்களில் API மற்றும் worker இதை அனுமதிப்பதில்லை. ஆனால், pnpm dev-ல் இயங்கும் ஒரு server, development mode-ல் இருப்பதால் அதை அனுமதிக்கும். இதை எந்தவொரு public அல்லது shared server-லும் பயன்படுத்த வேண்டாம். ஒரு bot-க்கு workspace-ன் பிற bots-உடன் கோப்புகளைப் பகிரக்கூடாது என்றால் docker-ஐப் பயன்படுத்தவும், அல்லது ஒன்றுக்கு மேற்பட்டவர்கள் sign-in செய்யும்போது e2b-ஐப் பயன்படுத்தவும்.

Rakazo-வின் எந்தப் பதிப்பை நான் நிறுவ வேண்டும்?

9 நவம்பர் 2026 நிலவரப்படி, புதிய release v0.8.0 ஆகும்; இது 4 நவம்பர் 2026 அன்று வெளியிடப்பட்டு Latest என்று குறிக்கப்பட்டுள்ளது. இந்த வழிகாட்டியைப் பின்பற்ற, main அல்லது ஆகஸ்ட் மாத v0.1.0-beta prerelease-ஐப் பின்தொடர்வதற்குப் பதிலாக, உறுதிப்படுத்தப்பட்ட v0.3.5 commit-ஆன f31e3c0699f086d663637c4107858c238a086fb3-ஐப் பயன்படுத்தவும். ஒரு branch மாறக்கூடும், tag-ஐ மாற்றியமைக்கலாம்; எனவே இவை இரண்டும் நீங்கள் மீண்டும் திரும்ப வரக்கூடிய ஒரு நிலையான நிலையை உறுதிப்படுத்தாது. Commit-ஐக் குறித்து வைத்துக்கொள்ளுங்கள், ஏனெனில் எது சரியாக வேலை செய்தது என்று தெரிந்தால் மட்டுமே rollback செய்ய முடியும்.

எனது OpenRouter API key-ஐ எங்கே வைக்க வேண்டும்?

.env-ல் OPENROUTER_API_KEY-ஆக வைக்கவும்; நீங்கள் commit செய்யும் compose கோப்பில் ஒருபோதும் வைக்க வேண்டாம். Repository-ல் உள்ள இரண்டு compose கட்டளைகளும் --env-file .env-ஐ அனுப்புகின்றன, எனவே YAML-ல் எழுதப்படாமலேயே அந்த மதிப்பு containers-க்குச் சென்றடையும். நீங்கள் அதை காலியாக விட்டுவிட்டு, signup செய்த பிறகு app-ல் ஒரு model-ஐ இணைக்கலாம். அந்த key-க்கு ஒரு spending limit-ஐ நிர்ணயம் செய்யுங்கள், ஏனெனில் ஒரு bot loop-ல் சிக்கினால், ஏதேனும் ஒன்று அதைத் தடுக்கும் வரை model-ஐத் தொடர்ந்து அழைத்துக்கொண்டே இருக்கும்.

எனக்கு domain name மற்றும் TLS தேவையா?

முதல் சோதனைக்கு அப்பால் எதற்கும், ஆம். Production compose கோப்பு Caddy-ஐ இயக்கி தானாகவே certificates-ஐப் பெறுகிறது; RAKAZO_HOST-ஐ public hostname-ஆகவும், BETTER_AUTH_URL, WEB_ORIGIN மற்றும் API_URL ஆகியவற்றை அதே public HTTPS origin-ஆகவும் அமைக்கவும். முதல் முறை பார்க்கும்போது domain-ஐத் தவிர்க்கலாம்: pnpm dev-ஐ இயக்கி, port 5173-ஐ வெளியிடுவதற்குப் பதிலாக SSH மூலம் forward செய்யவும்.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?