Reference
CLI Flags Reference
Complete reference for all gibil CLI flags
| Flag | Description |
|---|
--json | Output as machine-readable JSON |
--version | Show version number |
--help | Show help for a command |
| Flag | Type | Default | Description |
|---|
--name <name> | string | auto-generated | Server name (alphanumeric, hyphens, underscores) |
--repo <url> | string | n/a | GitHub repo URL to clone on the VM |
--ttl <duration> | string | 60 | TTL: 30m, 2h, 7d, 1y, or plain minutes |
--fleet <count> | number | 1 | Number of servers to create in parallel |
--config <path> | string | auto-detected | Path to .gibil.yml config file |
--provider <name> | string | configured default | Cloud provider (hetzner or vultr) |
--size <size> | string | provider default | Provider-agnostic size (small, medium, large) |
--server-type <native> | string | auto-detected | Native SKU; overrides --size (e.g. cax21, vc2-4c-8gb) |
--location <loc> | string | provider default | Datacenter location (fsn1, nrt, sgp, ...) |
-e, --env <KEY=VALUE> | string | n/a | Environment variable (repeatable) |
--dry-run | boolean | false | Print what would be created without calling the provider API |
--json | boolean | false | Output as JSON |
| Flag | Type | Default | Description |
|---|
--json | boolean | false | Output as JSON (stdout, stderr, exit_code) |
--timeout <seconds> | number | 30 | SSH command timeout in seconds |
-b, --background | boolean | false | Run in background, return job ID |
| Subcommand | Flag | Type | Default | Description |
|---|
status <id> | --json | boolean | false | Output as JSON |
list | --json | boolean | false | Output as JSON |
cancel <id> | --json | boolean | false | Output as JSON |
logs <id> | --json | boolean | false | Output as JSON |
logs <id> | -f, --follow | boolean | false | Follow log output (tail -f) |
| Flag | Type | Default | Description |
|---|
--script <path> | string | required | Path to local script to upload and execute |
--json | boolean | false | Output as JSON |
| Flag | Type | Default | Description |
|---|
--json | boolean | false | Output as JSON |
| Flag | Type | Default | Description |
|---|
--ttl <duration> | string | required | New TTL: 30m, 2h, 7d, 1y, or plain minutes |
| Flag | Type | Default | Description |
|---|
--json | boolean | false | Output as JSON |
| Flag | Type | Default | Description |
|---|
--provider <name> | string | interactive prompt | Provider to configure (hetzner or vultr) |
--token <token> | string | interactive prompt | API token for that provider |
--add <name> | string | n/a | Add a second provider to an existing config |
| Flag | Type | Default | Description |
|---|
--all | boolean | false | Destroy all active servers |
--json | boolean | false | Output as JSON |
| Flag | Type | Default | Description |
|---|
--token <token> | string | required | Provider API token |
--provider <name> | string | hetzner | Which provider this token is for (hetzner or vultr) |
| Flag | Type | Default | Description |
|---|
--key <key> | string | required | Gibil API key |
