//gateway

Quick Start Guide

Get started with DigitalFrontier Gateway in minutes

Docs are being migrated. These are the getting-started guides. Product names have been updated to DigitalFrontier, but the SDK, CLI and config identifiers in code samples still reference their current names — we publish the surface that actually exists rather than a renamed one. The full API reference is being moved to its own documentation site.

Get your first DigitalFrontier Gateway instance up and running in minutes.

Prerequisites

Before you begin, ensure you have:

A DigitalFrontier Core account with active subscription
DigitalFrontier CLI installed (npm install -g @blazing/cli)
Basic understanding of VoIP or edge networking concepts
A SIP trunk provider (optional, for PSTN connectivity)

Installation

Install DigitalFrontier CLI

npm install -g @blazing/cli

Authenticate

blazing login

Follow the prompts to authenticate with your DigitalFrontier Core account.

Your First Gateway

1. Initialize Gateway Configuration

Create a new gateway configuration file:

blazing gateway init

This creates a gateway.yaml file with default configuration:

version: 1

gateway:
  name: my-first-gateway

  sip:
    port: 5060
    tls_port: 5061
    domain: gateway.example.com

  media:
    rtp_port_range: 10000-20000
    codecs:
      - opus
      - g722
      - pcmu

  regions:
    - us-east-1
    - eu-west-1

  routing:
    strategy: least-cost
    failover: true

2. Deploy Gateway

Deploy your gateway to the edge:

blazing gateway deploy --config gateway.yaml

The CLI will:

Validate your configuration
Provision edge infrastructure
Configure routing and networking
Deploy your gateway instances

3. Verify Deployment

Check gateway status:

blazing gateway status my-first-gateway

You should see output like:

Gateway: my-first-gateway
Status: RUNNING
Regions: us-east-1, eu-west-1
Endpoints:
  - sip.us-east-1.gateway.blazing.run:5060
  - sip.eu-west-1.gateway.blazing.run:5060
Health: OK
Uptime: 2m 34s

Test Your Gateway

Make a Test Call

Use a SIP client to test connectivity:

# Using sipml5 or similar SIP client
sip:test@sip.us-east-1.gateway.blazing.run:5060

Monitor Call Metrics

View real-time metrics:

blazing gateway metrics my-first-gateway --live

Configure Routing

Add SIP Trunk

Connect a SIP trunk for PSTN calling:

# gateway.yaml
routing:
  - match:
      prefix: "+1"  # North America
    route:
      - provider: "twilio"
        trunk_uri: "sip:trunk.twilio.com"
        credentials:
          username: "ACxxxxxx"
          password: "your-auth-token"
        priority: 1

Apply the changes:

blazing gateway update my-first-gateway --config gateway.yaml

Next Steps

Now that you have a basic gateway running:

Troubleshooting

Gateway won't start

Check logs for errors:

blazing gateway logs my-first-gateway --tail 100

Can't connect via SIP

Verify firewall rules allow SIP traffic:

Port 5060 (UDP/TCP) for SIP
Port 5061 (TCP) for SIP over TLS
Ports 10000-20000 (UDP) for RTP media

Poor call quality

Check network metrics:

blazing gateway metrics my-first-gateway --filter network

Look for high jitter or packet loss.

Getting Help

Join our Discord community
Check the Gateway documentation
Contact support at support@blazing.run

DigitalFrontier Gateway