devmachine
Guides
Real setups, step by step.
Each guide says what you need. Then it shows the commands two ways: by hand, and as one request to your coding agent.
- Get started Start here
Your first devmachine, explained
Install devmachine, connect a server and open your first workspace, one command at a time.
Beginner
- Get started
Try it on your own computer first
Try devmachine on a virtual machine on your own computer before you pay for a server.
Beginner
- Get started
An old Mac as a machine
Turn an old Mac mini or MacBook, Intel or Apple Silicon, into a machine for your workspaces. No VPS to rent.
Beginner
- Web apps
Express site with TLS
Run an Express app in a workspace and serve it at your own domain, with HTTPS.
Beginner
- Web apps
Docker site on 8080
Run a site in a Docker container and serve it at your own domain, with HTTPS.
Beginner
- Web apps
Next.js app at your own domain
Build a Next.js app in a workspace, run its production server, and serve it at your own domain with HTTPS.
Beginner
- Web apps
FastAPI app at your own domain
Run a FastAPI app in a workspace with uv and serve it at your own domain, with HTTPS and its API docs.
Beginner
- Web apps
LibreChat, your own AI chat ecosystem
Run LibreChat with Docker Compose on your server: one chat app for many AI providers, agents and your files.
Intermediate
- Web apps
Open WebUI on your own server
Run Open WebUI in Docker on your server, at your own domain, with you as its only admin.
Beginner
- Web apps
Expose a home server to the internet without port forwarding
Give an old laptop, a mini PC or a homelab box a public HTTPS subdomain through your VPS. No port forwarding, works behind CGNAT, no tunnel service.
Intermediate
- Web apps
Share an app on your computer with friends
Let a friend open an app that runs in a VM on your computer, at your own domain or at a Tailscale Funnel address.
Intermediate
- Agents
Claude Code, controlled from your phone
Start Claude Code on your server and drive the same session from the Claude app on your phone.
Beginner
- Agents
Start Claude from your phone
Keep a Claude Code session waiting on your server, so your phone can open it with no SSH step.
Intermediate
- Agents
OpenClaw, in its own sandbox
Run the OpenClaw agent around the clock in a workspace of its own, away from your laptop.
Beginner
- Workspaces
Keep your sessions running
Close the laptop, and Claude Code keeps working on the server inside tmux.
Beginner
- Workspaces
Share a session
Let someone watch, or type into, one of your tmux sessions for an hour, then they are out.
Beginner
- Agents
A Claude that never sleeps
Turn on Remote Control with /rc and reach a running Claude Code session from your phone or Claude Desktop.
Beginner
- Workspaces
One consultant, three startups
One server, one sandbox per client: separate stacks, logins and agents that never mix.
Intermediate
- Agents
Hermes Agent, in its own sandbox
Run Nous Research's Hermes Agent always on, in a sandbox of its own.
Beginner
- Agents
Agno AgentOS with a control plane
Serve Agno AgentOS and its control plane dashboard, each at its own subdomain with HTTPS.
Advanced
- Web apps
wuzapi, as your own package
Write a WhatsApp API once as your own package, then run it on two machines.
Advanced
- Security
Log in with your 1Password SSH key
Keep devmachine's SSH key in 1Password and approve each use with Touch ID.
Intermediate
- Agents
Pi as your coding agent
Install the Pi coding agent in a workspace and use it for everyday work on your server.
Beginner
- Agents
opencode as your coding agent
Install opencode in a workspace, try it on its free models, then connect your own provider.
Beginner
- Agents
Antigravity CLI as your coding agent
Install Google's Antigravity CLI in a workspace and sign in once, from your own terminal.
Beginner
- Agents
Kimi Code as your coding agent
Install Moonshot AI's Kimi Code CLI in a workspace and sign in with a device code.
Beginner
- Agents
Cline as your coding agent
Install the Cline CLI in a workspace and connect it to your Cline account or your own API key.
Beginner
- Networking
SSH or mosh?
When to use ssh and when to use mosh, and the one firewall setting mosh needs.
Beginner
- Agents
Claude 24/7 in Telegram
Message Claude Code from Telegram while it runs on your server around the clock.
Intermediate
- Agents
Send work to a Claude session from a POST/Telegram/WhatsApp using Channels
Send work to a running Claude Code session from a webhook, Telegram or WhatsApp, and get an answer back.
Intermediate
- Agents
A simple agent with LangChain and OpenAI
Build a small LangChain agent with two tools in a workspace, with its OpenAI key delivered by devmachine.
Beginner
- Security
Logins and secrets
See what a workspace is missing, then sign in and hand over tokens with credentials, login and secrets.
Beginner
- Networking
Point your domain with Cloudflare
Give devmachine a scoped Cloudflare token, and expose add points your domain names for you.
Beginner
- Workspaces
Contribute to a Ruby on Rails project
Fork an open source Rails project into a workspace, run its tests and view its dev server privately.
Intermediate
- Networking
Your own Tailscale with Headscale
Run your own Tailscale control server with Headscale and put your devmachine on it.
Advanced
- Workspaces
One set of skills for every workspace
Write an agent skill once as a package, and every workspace gets it on the next sync.
Intermediate
Every guide is also plain Markdown in the CLI repository (opens in a new tab). Hand one to your agent, or add your own.