Quickstart

Deploy your first DR plan in 15 minutes. Go to failzero.io and create a free account.

2. Create Agent Token

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

gcloud compute instances create failzero-agent \
  --service-account=failzero-agent@your-project.iam.gserviceaccount.com \
  --scopes=cloud-platform \
  --metadata=FAILZERO_AGENT_TOKEN=fzat_your_token

The agent uses your local IAM credentials. No keys shared with FailZero.

4. Install CLI

npm install -g @failzero/cli

5. Authenticate

fz auth login

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

Agent Deployment

Detailed agent setup for GCP, AWS, Kubernetes

Example Plans

Real-world DR configurations

CLI Reference

All CLI commands

Multi-Cloud

Fail over between GCP and AWS

​Quickstart

​1. Sign Up

​2. Create Agent Token

​3. Deploy Agent

​4. Install CLI

​5. Authenticate

​6. Create DR Plan

​7. Deploy

​8. Test Failover

​Next Steps

Agent Deployment

Example Plans

CLI Reference

Multi-Cloud

Quickstart

1. Sign Up

2. Create Agent Token

3. Deploy Agent

4. Install CLI

5. Authenticate

6. Create DR Plan

7. Deploy

8. Test Failover

Next Steps