Rakazo Persistent AI Teammates

Deploys Rakazo v0.8.0, an open-source self-hosted AI agent for persistent teammates (bots with their own chats, memory, routines and optional computers), as separate web, API and worker services with Postgres and a Railway Bucket. Your account exists before the app goes online and sign-up is closed.

What you get

  • Rakazo web (the only public service), API and worker, from the official image pinned by digest
  • Postgres 18 on a volume holding data and the job queue, and a Railway Bucket for bot computer homes and files, encrypted before upload
  • An owner account created from OWNER_EMAIL and a generated OWNER_PASSWORD; SIGNUPS_ENABLED=false
  • The API and worker connect as a restricted database role under row-level security; content encryption on
  • Optional bot computers through Railway sandboxes, E2B, Daytona or Boat; chat works without one

Good for

  • A personal assistant that keeps context and runs routines, such as a weekday inbox summary
  • Bots that browse, research and edit files on their own Linux computer with live screen and takeover
  • Coding and operations helpers that run commands in an isolated sandbox instead of your laptop
  • Agents working in Gmail, Slack or GitHub through Composio, if you add a key

Services in this template

  • API · from baranberkay96/rakazo-railway
  • Worker · from baranberkay96/rakazo-railway
  • Postgres · image ghcr.io/railwayapp-templates/postgres-ssl:18
  • Web · image ghcr.io/elie222/rakazo/app:v0.8.0@sha256:908045c3b393f4d948ea6bed9cd86ab77fd32d467d2fdfa042805b34c5b851ea

Questions people ask

How do I log in?

Enter your email in OWNER_EMAIL when deploying. When Web and API are healthy, open the Web domain and sign in with that email and OWNER_PASSWORD from the API service's Variables tab, then change the password in account settings. Connect a model in Settings, Models; model usage is billed by that provider.

What should I back up?

Postgres and ENCRYPTION_KEY, which must be kept outside Railway: without it the data cannot be read, and changing it breaks stored data. Bucket objects are encrypted with keys derived from it.

How do bot computers work, and what do they cost?

Railway cannot run Docker computers, so they use Railway sandboxes in a separate sbx environment of your project, or E2B, Daytona or Boat. The Railway option needs a workspace token set as RAILWAY_API_TOKEN, which has full API access to every project in that workspace; use a workspace holding only this project. Railway bills sandboxes at $50 per GB-month of memory held and $50 per vCPU-month used. Use Hobby or Pro.

How do I invite people or upgrade?

Set up email (EMAIL_PROVIDER, EMAIL_API_KEY, EMAIL_FROM), add SIGNUP_ALLOWLIST and set SIGNUPS_ENABLED=true on the API. To upgrade, read upstream's changelog, back up Postgres and ENCRYPTION_KEY, change the tag and digest in both places and redeploy; migrations run before the new version starts.

What are the risks?

Bots act with your accounts, keys and connected apps, so review Settings, Approvals before giving them sensitive access. Rakazo is Apache-2.0; this is a community template, not affiliated with the Rakazo project. The author's idle cost figure (about 0.9 GB RAM across web, API, worker and Postgres) is an estimate, not a measurement.

Full template README

Deploy and Host Rakazo with Railway

Rakazo is an open-source, self-hosted AI agent for persistent teammates: bots with their own chats, memory, routines and computers, on the model you choose. This community template runs Rakazo v0.8.0 from the official images as separate web, API and worker services with Postgres and a Railway Bucket, private from the first minute.

About Hosting Rakazo

Rakazo is a long-running app, not a static site. The API runs chat turns, the worker runs routines and background jobs, the web server serves the app and forwards API calls, and Postgres holds everything plus the job queue. Bots can also get a computer (Linux desktop, browser, terminal, files) from a sandbox provider. Railway cannot run Docker computers, so this template uses upstream's remote providers: Railway sandboxes in your own project, or E2B, Daytona or Boat. Without one, Rakazo still boots and chat works. Your account exists before the app goes online, public sign-up is closed, and only the web service is public.

Common Use Cases

  • A personal assistant that remembers context and runs routines, such as a weekday morning inbox summary
  • Bots that browse, research and edit files on their own Linux computer, with live screen and takeover
  • Coding and operations helpers that run commands in an isolated sandbox instead of on your laptop
  • Agents working in Gmail, Slack, GitHub and other apps through Composio
  • One server for Rakazo's web, desktop and mobile apps

Dependencies for Rakazo Hosting

  • A model: after signing in, connect a ChatGPT or Claude subscription or an API key in Settings → Models, or set OPENROUTER_API_KEY / ANTHROPIC_API_KEY on the API service. Model usage is billed by that provider.
  • Optional, for bot computers: a Railway workspace token (computers run as Railway sandboxes in this project, billed to your Railway usage), or an E2B, Daytona or Boat key (billed by them).
  • Optional: a Composio key for connected apps, a Resend key for password-reset email.

Deployment Dependencies

Implementation Details

Service Source Role
Web ghcr.io/elie222/rakazo/app:v0.8.0 (digest-pinned) Public web app; forwards /api and /rpc to the API over the private network. Healthcheck /
API same image + a small start wrapper Sign-in, chat runs, computers. Private only. Pre-deploy: migrations and owner account. Healthcheck /ready
Worker same image + wrapper Routines, wake-ups, background runs, cleanup. Private, waits for the API
Postgres Railway Postgres 18 Data and job queue, volume
Bucket Railway Bucket Bot computer homes and files, encrypted before upload

The API and worker have no volume: what they share lives in Postgres and the Bucket, so the worker can scale out.

First login

  1. Enter your email in OWNER_EMAIL and deploy. The first build takes a few minutes.
  2. When Web and API are healthy, open the Web domain.
  3. Sign in with that email and OWNER_PASSWORD from the API service's Variables tab. Change the password in account settings; editing the variable later does not reset it.
  4. Connect a model in Settings → Models and message your first bot.

Nobody else can register (SIGNUPS_ENABLED=false). To invite people, set up email (EMAIL_PROVIDER=resend, EMAIL_API_KEY, EMAIL_FROM) then add SIGNUP_ALLOWLIST (emails or @domain) and set SIGNUPS_ENABLED=true on the API.

Bot computers on Railway (optional)

  1. Create a workspace token at https://railway.com/account/tokens, ideally for a workspace that holds only this project.
  2. Set it as RAILWAY_API_TOKEN on the API service (SANDBOX_PROVIDER is already railway) and deploy the staged changes for API and Worker.
  3. On start, the API finds or creates one empty environment named sbx-... in this project and runs every computer there, never in the app's environment, so a computer cannot reach Postgres or the API. Open a bot's computer to start one.

What the token can do: a workspace token has full API access to every project in that workspace. It can read all their variables, create, change or delete services, environments and volumes, and start resources billed to the workspace. Rakazo uses it only to find or create the sbx- environment and to create, inspect, run commands in, copy files to and from, and delete sandboxes there. It is kept on the API and Worker, never given to the Web service or to the computers. Anyone with access to this Railway project can read it. Account tokens reach all your workspaces, so avoid them. Project tokens do not work. Revoke the token when you remove the project, and check the sbx- environment for leftover computers.

Cost: Railway bills sandboxes at virtual machine rates, $50 per GB-month of memory held and $50 per vCPU-month used, per second. A desktop with Chromium at about 2.5 GB and 0.5 vCPU costs roughly $0.21 per hour while running, about $18 a month at 4 hours per workday. Computers stop after 10 idle minutes (SANDBOX_IDLE_MS) and after 2 hours of continuous running unless in use (COMPUTER_MAX_ACTIVE_MS). Each user may have 3 (SANDBOX_MAX_COMPUTERS_PER_USER). Use Hobby or Pro: Trial sandboxes have a 1 to 5 minute idle timeout that can end a computer before its files are saved.

Other providers: set SANDBOX_PROVIDER to e2b, daytona or boat and the matching key on the API. The worker follows the API's settings.

Security

  • Only Web is public. The API, worker and Postgres are private. Bucket objects are encrypted with keys derived from ENCRYPTION_KEY.
  • The API and worker connect as rakazo_app, a login under row-level security. The database owner URL is used only in the pre-deploy step and removed before the API starts. Both run as the image's unprivileged user.
  • Content is encrypted at rest (CONTENT_ENCRYPTION=on). Back up ENCRYPTION_KEY outside Railway: without it the data cannot be read, and changing it breaks stored data.
  • Bots act with your accounts, keys and connected apps. Review Settings → Approvals before giving them sensitive access.

Custom domain: attach it to Web, set RAKAZO_HOST on Web to the hostname and RAKAZO_PUBLIC_ORIGIN on the API to https://{your-domain}, then redeploy Web, API and Worker. Passkeys follow the domain.

Scaling: give API and Worker more memory for many parallel chats and routines (chat runs execute in the API, routines in the worker). The worker can run several replicas. Keep one API replica unless you have tested more.

Pinning and upgrades: Web and the API/worker Dockerfile pin v0.8.0 by digest. To upgrade, read upstream's changelog, back up Postgres and ENCRYPTION_KEY, change the tag and digest in both places, and redeploy. Migrations run in the API's pre-deploy step before the new version starts, and the worker gets up to 45 minutes to finish running jobs.

Costs (estimate): Web, API, worker and Postgres idle at about 0.9 GB RAM (about $10 a month) and typically use 1.5 to 2 GB (about $20 to $25) at Railway's usage prices. The Bucket costs $0.015 per GB-month. Computers and models are extra, as above. Hobby plan or higher.

Why Deploy Rakazo on Railway?

Bots that run routines and keep memory need an always-on server, a database and HTTPS. On Railway that is one deploy with private networking, logs and restarts, and with a workspace token the bots' computers run in the same project and on the same bill, without a Docker host or another sandbox account.

View Rakazo Persistent AI Teammates on railway.com

Similar templates

TemplateCategoryDeploymentsDeploys
9Router
Self-hosted AI router for Claude, Gemini, Cursor & OpenAI tools.
AI/ML9,734
flowise-railway
Flowise - low-code LLM apps builder
AI/ML8,512
LibreChat
Open-source ChatGPT clone: multi-model, agents, search, multi-user auth
AI/ML6,762
Hermes Agent by Nous Research
Template for Hermes Agent by Nous Research
AI/ML6,413
OpenClaw
[Homebrew support] The AI that actually does things
AI/ML5,167
Hermes Agent
Self Host Hermes Agent. Autonomous AI agent w/ self-improving, tools & more
AI/ML4,092