Axon Networks Docs

Quickstart

Deploy your first edge route on Axon Fabric in under five minutes. You'll need an Axon account (free) and the Axon CLI.

1. Install the CLI

# macOS / Linux
curl -fsSL https://install.axon.network/cli | bash

# Or via npm
npm install -g @axon/cli

# Verify
axon --version
# axon v3.4.1

2. Authenticate

axon auth login
# Opens browser to complete OAuth2 flow
# ✓ Logged in as you@example.com

3. Create a project and deploy a route

axon projects create my-first-project
axon init   # generates axon.fabric.yml
axon deploy # deploys to all regions

# Output:
# ✓ Route deployed: https://my-first-project.axon.network
# ✓ Propagated to 180 PoPs in 8.2s

Core Concepts

Understanding these concepts will help you get the most out of Axon Fabric.

Projects

A project is the top-level organizational unit. Each project has its own set of routes, gateway rules, and observability data. Projects map to a single billing account but can have multiple team members.

Routes

A route defines how traffic is distributed across your origins. Routes are declared in axon.fabric.yml and can use latency-based, weighted, or geo-aware strategies.

PoPs (Points of Presence)

Axon operates 180+ PoPs globally. When a user makes a request to your route endpoint, it's answered by the geographically nearest PoP — which then proxies to your optimal origin based on your routing policy.

Authentication

All API requests require authentication via a Bearer token. Tokens are scoped to a project and can be created in the dashboard or via the CLI.

curl https://api.axon.network/v1/routes \
  -H "Authorization: Bearer axn_live_k8xm2n9p..." \
  -H "Content-Type: application/json"

Tokens beginning with axn_live_ are production tokens. axn_test_ tokens use a sandboxed environment that doesn't affect real traffic or billing.

REST API Reference

The Axon REST API follows OpenAPI 3.1. The base URL for all API requests is https://api.axon.network/v1.

Routes

Gateway Rules

Metrics

SDKs

Official SDKs are available for the most common languages. All SDKs are open-source and published to their respective package registries.

Examples

Regions

See the infrastructure page for a full list of regions and PoP locations. All regions are available to all plans; Enterprise customers can request dedicated PoP access.

Terraform Provider

terraform {
  required_providers {
    axon = {
      source  = "axon-networks/axon"
      version = "~> 3.4"
    }
  }
}

provider "axon" {
  token = var.axon_token
}

resource "axon_route" "api" {
  name    = "api-prod"
  routing = "latency"

  origin {
    id      = "us-east"
    address = "api.us.example.com"
    region  = "us-east-1"
    weight  = 60
  }
}