selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Cloudroom core logo

Self-host Cloudroom core

core-v0.1.82

Rust runtime for AI coding agents in isolated sandboxes

BetaOpen SourceApache-2.0
Updated11 hours ago
LanguageRust
Setup difficultyAdvanced
Stars
1 049
Port
9840 (HTTP API)
Requires
Node.js, Rust
Install with Linux

What is Cloudroom core?

Cloudroom core is a Rust service that runs AI coding agents in isolated Linux sandboxes on your own hardware. Each agent gets a separate sandbox with full admin rights inside but no access to other sandboxes or the host. The core manages agent execution, durable request queues, session history, and exposes an HTTP API for remote control. It runs as a systemd service on Ubuntu 24.04 (x86_64 or arm64), uses a Bearer token for authentication, and listens on localhost by default with Tailscale recommended for remote access. Agents use your own model subscriptions and credentials. The software is pre-release (pre-1.0) and licensed under Apache-2.0.

Should you self-host Cloudroom core?

Cloudroom core scores 50/100 on selfhost.directory (how scoring works) and ranks #96 of 209 in AI Agents. It has 1 049 GitHub stars.

It shipped 10 stable releases in the past year. The latest, core-v0.1.82, came out on 28 October 2026. New versions land roughly every 1 days.

Setup is advanced: plan for several services and some ongoing maintenance. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is Orca (91/100, 108 642 stars). It scores higher overall, so compare the two before you pick. See Cloudroom core vs Orca side by side.

Features

  • Child threads / subagents
  • Command Guard
  • Desktop app integration
  • Disk safety and pause/resume
  • HTTP API with Bearer token auth
  • In-place upgrades
  • Isolated agent sandboxes
  • Multiple AI agent support
  • Session history and replay
  • Tailscale remote access

Cloudroom core README

How to install Cloudroom core

Install Cloudroom core with Linux

Environment variables
CLOUDROOM_TOKEN, CLOUDROOM_LISTEN, CLOUDROOM_STORE, CLOUDROOM_LOCAL_HISTORY, CLOUDROOM_STATE_DIR, CLOUDROOM_ACCOUNT_HOME, CLOUDROOM_REPOSITORY, CLOUDROOM_CODEX_BINARY, CLOUDROOM_CODEX_HOME, CLOUDROOM_CODEX_MODEL, CLOUDROOM_HARNESS, CLOUDROOM_PI_BINARY, CLOUDROOM_PI_HOME, CLOUDROOM_PI_MODEL, CLOUDROOM_PI_PROVIDER, CLOUDROOM_MODEL, CLOUDROOM_STORAGE_POLICY, CLOUDROOM_ALLOW_NON_LOOPBACK_HTTP

One-script install on x86_64 or arm64 VPS, home server, or laptop. Creates service accounts, generates token, starts systemd service.

How to configure Cloudroom core

  • CLOUDROOM_ACCOUNT_HOME/home/cloudroom-agentHome directory for the agent user

    Home directory for the agent user

  • CLOUDROOM_ALLOW_NON_LOOPBACK_HTTPAllow non-loopback HTTP listeners (1 = enabled)

    Allow non-loopback HTTP listeners (1 = enabled)

    values: 1

  • CLOUDROOM_CODEX_BINARY/usr/local/bin/codexPath to Codex CLI binary

    Path to Codex CLI binary

  • CLOUDROOM_CODEX_HOME/home/cloudroom-agent/.codexCodex home directory for the agent user

    Codex home directory for the agent user

  • CLOUDROOM_CODEX_MODELCodex model to use

    Codex model to use

  • CLOUDROOM_HARNESScodexDefault harness (codex, claude-code, pi, cursor, opencode, hermes, devin, openclaw)

    Default harness (codex, claude-code, pi, cursor, opencode, hermes, devin, openclaw)

    values: codex, claude-code, pi, cursor, opencode, hermes, devin, openclaw

  • CLOUDROOM_LISTEN127.0.0.1:9840Address and port the HTTP API listens on

    Address and port the HTTP API listens on

  • CLOUDROOM_LOCAL_HISTORY1Enable local history storage (1 = enabled)

    Enable local history storage (1 = enabled)

    values: 1

  • CLOUDROOM_MODELFallback model when adapter-specific model is omitted

    Fallback model when adapter-specific model is omitted

  • CLOUDROOM_PI_BINARY/usr/local/bin/piPath to Pi CLI binary

    Path to Pi CLI binary

  • CLOUDROOM_PI_HOME/home/cloudroom-agent/.pi/agentPi home directory

    Pi home directory

  • CLOUDROOM_PI_MODELPi model to use

    Pi model to use

  • CLOUDROOM_PI_PROVIDERPi provider (e.g., openai-codex)

    Pi provider (e.g., openai-codex)

  • CLOUDROOM_REPOSITORY/code/exampleDefault workspace repository path

    Default workspace repository path

  • CLOUDROOM_STATE_DIR/var/lib/cloudroom/historyDirectory for session history journal

    Directory for session history journal

  • CLOUDROOM_STORAGE_POLICY/etc/cloudroom/storage.jsonPath to storage policy JSON file

    Path to storage policy JSON file

  • CLOUDROOM_STOREself-hostedStorage backend mode

    Storage backend mode

    values: self-hosted

  • CLOUDROOM_TOKENSecret bearer token for API authentication

    Secret bearer token for API authentication

Cloudroom core releases & version history

FAQ

How does Cloudroom keep my code and keys safe?

Each agent runs in its own isolated sandbox with full admin rights inside but no access to other users or sandboxes. Agents call model providers directly. API keys shared go through a secure form and never appear in chat.

Can I self-host Cloudroom?

The Rust core is designed to run independently on a Linux VM with PostgreSQL and supported harness credentials. Managed hosting is optional. Public release packaging and a polished self-hosting setup are still being prepared.

Will my agents work when my laptop is closed?

Yes, on Cloud threads. Once a task reaches the cloud, the agent keeps working and its history is saved. Local threads stop when your Mac sleeps.

Do I need to change my model subscription?

No, Cloudroom works with your own model accounts and coding subscriptions. Agents connect to model providers directly.

Which AI coding agents does it support?

Local threads run 9 harnesses: Claude Code, Codex, Pi Agent, Cursor, OpenCode, Grok, fx, Hermes, and Devin. Cloud threads run Claude Code, Codex, Pi Agent, OpenCode, fx, Hermes, and Devin.

Is Cloudroom free?

Yes, the Free plan includes 100 cloud agents every 30 days, and local agents are free forever. Paid plans (Pro $50/mo, Super $150/mo, Ultra $500/mo) give more capacity.

Can I use Cloudroom today?

Yes, you can create an account and download the app. Ultra teams get an onboarding call.

What is Cloudroom?

Cloudroom is a platform for running AI coding agents in the cloud, each in its own sandbox. It manages agent execution and session history while you use your own tools and model accounts.

More in AI Agents

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…