Quickstart
Deploy your first DR plan in 15 minutes.
1. Sign Up
Go to failzero.io and create a free account.
2. Create Agent Token
Log in to failzero.io
Click your email in the top right
Create Token
Select Agent type and give it a name
Copy token
Save the fzat_... token (shown only once)
3. Deploy Agent
docker run -d \
--name failzero-agent \
-e FAILZERO_AGENT_TOKEN=fzat_your_token \
-e FAILZERO_API_URL=https://api.failzero.io \
-e PROVIDER_TYPE=gcp \
-e GCP_PROJECT_ID=your-project \
failzero/agent:latest
The agent uses your local IAM credentials. No keys shared with FailZero.
4. Install CLI
npm install -g @failzero/cli
5. Authenticate
Opens browser, logs you in, stores token in keychain.
6. Create DR Plan
Create testing-dr.yaml:
name: "testing-api"
provider:
type: "gcp"
project_id: "your-project"
region: "us-west1"
monitors:
- name: "api-health"
type: "https"
endpoint: "https://api.yourapp.com/health"
interval: "60s"
failure_threshold: 3
failover:
strategy: "manual"
steps:
- name: "promote-db"
type: "database-promote"
resource: "prod-db-replica"
- name: "update-dns"
type: "dns-update"
zone: "your-zone"
record: "api.yourapp.com."
target: "BACKUP_IP"
notifications:
- type: "webhook"
url: "https://your-system.com/webhooks/failzero"
events: ["threshold-reached", "failover-completed"]
7. Deploy
fz deploy testing-dr.yaml
Plan deployed! Agent is now monitoring your infrastructure.
8. Test Failover
fz failover testing-api --reason "Testing"
This executes your DR plan. Test in a non-production environment first.
Next Steps
