CLI Reference
CLI Reference
Complete reference for all ephemerd commands.
The ephemerd binary uses serve as its default command. All commands accept the global --data-dir flag to override the data directory (default: /var/lib/ephemerd on Linux/macOS, C:\ProgramData\ephemerd on Windows). The EPHEMERD_DATA_DIR environment variable can also set this.
| Command | Description |
|---|---|
| serve | Start the ephemerd daemon (default command) |
| run | Run a GitHub Actions workflow locally |
| start | Start the ephemerd system service |
| stop | Stop the ephemerd system service |
| restart | Restart the ephemerd system service |
| logs | Tail the ephemerd system service logs |
| status | Show running jobs and daemon health |
| drain | Gracefully drain the running daemon |
| jobs | List and manage running jobs |
| config | Validate configuration file |
| doctor | Check system readiness and clean up stale state |
| install | Install ephemerd as a system service |
| uninstall | Remove ephemerd binary, service, and data |
| crictl | Passthrough to containerd’s CRI interface (in-process crictl) |