Skip to content
usine

Run usine

Start and maintain a local instance or a hosted orchestrator.

Start an instance on your machine, a Linux server, or an always-on Mac, then maintain its access, version, and stored state. For a first agent pull request, follow the quickstart.

Start an instance

Section titled “Start an instance”
  1. Run usine locally
  2. Host usine on a Linux server
  3. Host usine on a Mac
  4. Keep the orchestrator running

Connect to the instance

Section titled “Connect to the instance”
  1. Expose an instance over HTTPS
  2. Open the web UI

Maintain the instance

Section titled “Maintain the instance”
  1. Upgrade an instance
  2. Back up instance state
  3. Restore instance state
  4. Move an instance to another machine

Advanced Hetzner setup

Section titled “Advanced Hetzner setup”
  1. Run the orchestrator in a Hetzner gateway network
Get startedRun usineGuidesReferenceGitHub

Get started

OverviewQuickstartConcepts

Guides

Overview
Run usine
OverviewRun usine locallyHost usine on a Linux serverHost usine on a MacKeep the orchestrator runningExpose an instance over HTTPSOpen the web UIUpgrade an instanceBack up instance stateRestore instance stateMove an instance to another machineRun the orchestrator in a Hetzner gateway network
Workers
OverviewAdd a local workerAdd an SSH workerAdd a Boat workerAdd a boxd workerAdd a Hetzner workerRun attempts in Cloudflare sandboxesConfigure a gatewayConnect Boat to a gatewayRun worker preflightPause a workerRemove a worker
Loops and agents
OverviewWrite an issue loopWrite a schedule loopWrite an agentConnect review and fix loopsChange the configurationRevert a configuration revisionPause a loop
Work with runs
OverviewApprove a runFollow a runMessage a running agentAnswer an agent question or blockerCancel a runRetry a failed runRun completed work againExport a runMove a task on the boardRead instance statistics
Access
OverviewSign in to an instanceGrant member accessCreate a device tokenConnect an MCP client

Reference

CLI
Configuration
SettingsProjects and registryWorkersLoopsAgentsExpressionsConfiguration revisionsImport and export format
AccessOperator HTTP API