Provisioning and Management
This page covers the minion lifecycle from creation to shutdown and recovery.
Provisioning flow
Section titled “Provisioning flow”- Select “New Minion” from the HQ dashboard
- HQ creates an AWS Lightsail instance (restored from snapshot)
- The minion server (
@geekbeer/minion) starts automatically - A Cloudflare Tunnel is automatically created, making the minion accessible at
{id}.minion-agent.com - A heartbeat is sent to HQ, and the status changes to
online
Minion statuses
Section titled “Minion statuses”| Status | Description |
|---|---|
provisioning | VPS is being created |
online | Running normally |
offline | Heartbeat lost |
stopped | Manually stopped |
expired | Trial period ended (snapshot saved) |
Lifecycle operations
Section titled “Lifecycle operations”Stop a minion from the HQ dashboard or API. A snapshot is created on stop to preserve state.
Resume
Section titled “Resume”A new instance is created from the snapshot, restoring the state from before the stop.
Delete
Section titled “Delete”The snapshot and instance are permanently deleted. This operation cannot be undone.
Monitoring
Section titled “Monitoring”The HQ dashboard provides visibility into:
- Heartbeat — Minion liveness status (30-second intervals)
- Uptime — Cumulative uptime and Stripe metering
- Execution logs — Workflow/routine execution history