Skip to main content
Complete cloud worktree setup to run builds on a private Linux machine while you keep editing locally.

​
Before you start

Install bead, sign in, and check bead balance. Run these commands from your Git worktree root. Choose a published template with the tools your project needs; devbox is the example below.

​
Configure your project

Create bead.toml:
Use your project’s dependency setup command in prepare.run. For a JavaScript project, that might be npm ci with package-lock.json and package.json as inputs.

​
Bring it up

Keep the printed machine ID. The first up writes a shared project name into bead.toml; commit the configuration through your normal workflow. Preparation runs only when you request it. A stale preparation warning means you should run prepare again. Arguments after -- are literal Linux arguments. Use a shell explicitly for pipelines or compound commands:

​
Finish the branch

Confirm that destruction is acknowledged. See services for dev servers and recovery if a connection ends before you receive the result.