Self-hosting on a Remote Server

Access CloudCLI UI from any device by running it on a VPS, exposing it on your local network, or using a tunnel.

Remote Access

If you want to access CloudCLI UI from your phone or another device outside your local network, the easiest way is CloudCLI Cloud.

CloudCLI Cloud gives you a fully managed environment with no server to set up, no ports to open, and no machine that needs to stay on. Your agent sessions run in the cloud and are accessible from any browser, IDE, or API from anywhere in the world. It starts at $7/month.

Get started with CloudCLI Cloud →


Self-hosting on a Remote Server

If you have a specific reason to run CloudCLI UI on your own infrastructure — such as compliance requirements, an air-gapped environment, or preference for full control — you can run it on any VPS.

Setup

Spin up a server (Hetzner, DigitalOcean, Linode, or similar), install Node.js v22+, then:

bash
npm install -g @siteboon/claude-code-ui

Then follow the Running as a Background Service guide to keep it running with PM2 and auto-start on reboot.

Access it at http://your-server-ip:3001 from any device.

Security

CloudCLI UI does not include built-in authentication. If you expose it publicly, put it behind a reverse proxy such as Caddy or nginx with an auth layer in front.

bash
# Example: Caddy with basic auth
# In your Caddyfile
your-domain.com {
  basicauth {
    username <hashed-password>
  }
  reverse_proxy localhost:3001
}

Temporary Access via Tunnel

For quick one-off remote access without a server:

bash
# Using cloudflared (free)
cloudflared tunnel --url http://localhost:3001

# Or ngrok
ngrok http 3001

This gives you a temporary public URL. Not recommended for ongoing use.


For team access, audit logs, environment isolation, and everything else that comes with a managed platform, CloudCLI Cloud handles it without any of this setup.

Last updated March 4, 2026