GibilGibil

Environment Variables

Environment variables used by the Gibil CLI

CLI environment variables

VariableRequiredDescription
HETZNER_API_TOKENYes*Hetzner Cloud API token for VM operations
GIBIL_API_KEYNoGibil API key for authenticated usage and metering
GIBIL_API_URLNoOverride Supabase Edge Functions URL
GITHUB_TOKENNoGitHub token for private repo access on VMs

* Not required if you've run gibil auth setup --token.

How tokens are resolved

Hetzner token

  1. ~/.gibil/config.json (set via gibil auth setup --token)
  2. HETZNER_API_TOKEN environment variable
  3. .env file in current directory (auto-loaded via dotenv)

Gibil API key

  1. ~/.gibil/config.json (set via gibil auth login --key)
  2. GIBIL_API_KEY environment variable

VM environment variables

Variables defined in .gibil.yml env: section are set on the VM:

env:
  DATABASE_URL: postgres://localhost/myapp
  NODE_ENV: development

These are:

  • Exported in the cloud-init script
  • Persisted in /root/.bashrc
  • Available in all SSH sessions and gibil run commands

.gibil.yml Reference

Complete reference for the .gibil.yml configuration file

JSON Output

Machine-readable JSON output schemas for AI agents

On this page

CLI environment variablesHow tokens are resolvedHetzner tokenGibil API keyVM environment variables