Edge Compute Quick Start

Deploy serverless functions on Telnyx Edge Compute in under 5 minutes.

Tutorial Objectives

This tutorial covers:

Deploying a function that responds globally in under 50ms.
Learning the basic Edge Compute development workflow.
Testing functions from anywhere in the world.
Understanding edge computing in practice.

Prerequisites

A Telnyx account with API access - Sign up here if needed.
Command line familiarity - Requires Terminal (macOS/Linux) or Command Prompt (Windows).
Time requirement - This guide takes approximately 5 minutes to complete.

Install the CLI

Download Binary

Download the latest release for your platform from the GitHub releases page. Extract the archive and add the binary to your PATH: Example for Linux/macOS:

# Download and extract
tar -xzf telnyx-edge-*.tar.gz

# Install to system PATH
sudo mv telnyx-edge /usr/local/bin/

# Verify installation
telnyx-edge --help

Authenticate

Option 1: OAuth (Recommended)

Authenticate using OAuth with your Telnyx account:

telnyx-edge auth login

This will open your browser to complete authentication.

Option 2: API Key

Alternatively, authenticate with a Telnyx API key:

telnyx-edge auth api-key set YOUR_API_KEY

Verify Authentication

Check your authentication status:

telnyx-edge auth status

Create a Function

Create a simple “Hello World” function. Choose your preferred language:

Go
Python

telnyx-edge new-func --language=go --name=hello-world

This creates a new directory with the function:

hello-world/
├── handler.go   # Your function code
├── go.mod       # Go dependencies
└── func.toml    # Function configuration

Function Code

The generated handler.go contains a basic HTTP handler:

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

type Response struct {
    Message string `json:"message"`
    Status  string `json:"status"`
}

func handler(w http.ResponseWriter, r *http.Request) {
    response := Response{
        Message: "Hello from Telnyx Edge Compute!",
        Status:  "success",
    }

    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(response)
}

func main() {
    http.HandleFunc("/", handler)

    port := os.Getenv("PORT")
    if port == "" {
        port = "8080"
    }

    fmt.Printf("Server starting on port %s\n", port)
    http.ListenAndServe(":"+port, nil)
}

telnyx-edge new-func --language=python --name=hello-world

This creates a new directory with the function:

hello-world/
├── app.py            # Your function code
├── requirements.txt  # Python dependencies
└── func.toml         # Function configuration

Function Code

The generated app.py contains a basic HTTP handler:

import json
import os
from http.server import HTTPServer, BaseHTTPRequestHandler

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        response = {
            "message": "Hello from Telnyx Edge Compute!",
            "status": "success"
        }
        
        self.send_response(200)
        self.send_header("Content-Type", "application/json")
        self.end_headers()
        self.wfile.write(json.dumps(response).encode())

    def do_POST(self):
        content_length = int(self.headers.get('Content-Length', 0))
        body = self.rfile.read(content_length)
        data = json.loads(body) if body else {}
        
        response = {
            "message": "Hello from Telnyx Edge Compute!",
            "received": data,
            "status": "success"
        }
        
        self.send_response(200)
        self.send_header("Content-Type", "application/json")
        self.end_headers()
        self.wfile.write(json.dumps(response).encode())

if __name__ == "__main__":
    port = int(os.environ.get("PORT", 8080))
    server = HTTPServer(("", port), Handler)
    print(f"Server starting on port {port}")
    server.serve_forever()

Deploy the Function

Navigate to the function directory and deploy:

cd hello-world
telnyx-edge ship

The CLI will:

Validate your function structure.
Check authentication.
Package your function files.
Upload to Telnyx Edge infrastructure.
Deploy across edge locations.

You’ll see output like:

Deploying function 'hello-world'...
✓ Function validated successfully
✓ Authentication verified
✓ Files packaged (2.3 KB)
✓ Upload complete
✓ Function deployed successfully

Function ID: func-abc123def456
Status: Active

Test the Function

Your function is now deployed and accessible via HTTP. Functions are accessible at URLs following this pattern: https://{funcName}-{orgId}.telnyxcompute.com Test your deployed function:

curl https://hello-world-abc123.telnyxcompute.com \
  -H "Content-Type: application/json" \
  -d '{"test": "data"}'

Response:

{
  "message": "Hello from Telnyx Edge Compute!",
  "status": "success"
}

Success! The Function is Live

Your function is now running and ready to handle HTTP requests. Functions automatically scale based on demand.

Building on the Basics

Common implementation patterns include:

Handle Different HTTP Methods

Go
Python

func handler(w http.ResponseWriter, r *http.Request) {
    var response Response

    switch r.Method {
    case "GET":
        response = Response{Message: "Hello from GET request!", Status: "success"}
    case "POST":
        response = Response{Message: "Data received via POST!", Status: "success"}
    default:
        response = Response{Message: "Method not supported", Status: "error"}
        w.WriteHeader(http.StatusMethodNotAllowed)
    }

    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(response)
}

def do_GET(self):
    response = {"message": "Hello from GET request!", "status": "success"}
    self.send_response(200)
    self.send_header("Content-Type", "application/json")
    self.end_headers()
    self.wfile.write(json.dumps(response).encode())

def do_POST(self):
    response = {"message": "Data received via POST!", "status": "success"}
    self.send_response(200)
    self.send_header("Content-Type", "application/json")
    self.end_headers()
    self.wfile.write(json.dumps(response).encode())

Use Environment Variables

Go
Python

func handler(w http.ResponseWriter, r *http.Request) {
    greeting := os.Getenv("GREETING")
    if greeting == "" {
        greeting = "Hello"
    }

    response := Response{
        Message: fmt.Sprintf("%s from Telnyx Edge Compute!", greeting),
        Status:  "success",
    }

    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(response)
}

import os

def do_GET(self):
    greeting = os.environ.get("GREETING", "Hello")
    
    response = {
        "message": f"{greeting} from Telnyx Edge Compute!",
        "status": "success"
    }
    
    self.send_response(200)
    self.send_header("Content-Type", "application/json")
    self.end_headers()
    self.wfile.write(json.dumps(response).encode())

Parse Query Parameters

Go
Python

func handler(w http.ResponseWriter, r *http.Request) {
    name := r.URL.Query().Get("name")
    if name == "" {
        name = "World"
    }

    response := Response{
        Message: fmt.Sprintf("Hello %s from Telnyx Edge Compute!", name),
        Status:  "success",
    }

    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(response)
}

from urllib.parse import urlparse, parse_qs

def do_GET(self):
    query = parse_qs(urlparse(self.path).query)
    name = query.get("name", ["World"])[0]
    
    response = {
        "message": f"Hello {name} from Telnyx Edge Compute!",
        "status": "success"
    }
    
    self.send_response(200)
    self.send_header("Content-Type", "application/json")
    self.end_headers()
    self.wfile.write(json.dumps(response).encode())

Next Steps

The edge function has been successfully deployed. Explore these topics next:

Explore More Languages

Try creating functions in different languages:

# Go
telnyx-edge new-func --language=go --name=my-go-function

# Python
telnyx-edge new-func --language=python --name=my-python-function

# Java (Quarkus)
telnyx-edge new-func --language=quarkus --name=my-java-function

Learn Core Concepts

Function Fundamentals - Understanding function lifecycle and configuration.
Environment Variables - Managing secrets and configuration.

Integrate with Telnyx Services

Voice, Messaging & AI Examples - Process calls, SMS, and AI requests at the edge.

Common Commands

Here are the most frequently used CLI commands:

# Authentication
telnyx-edge auth login                    # Login with OAuth
telnyx-edge auth status                   # Check auth status
telnyx-edge auth logout                   # Logout
telnyx-edge auth api-key set KEY          # Set API key
telnyx-edge auth api-key clear            # Clear API key

# Function management
telnyx-edge new-func -l=go -n=my-func     # Create new function
telnyx-edge ship                          # Deploy function from current directory
telnyx-edge delete-func my-func           # Delete a function

# Secrets management
telnyx-edge secrets add API_KEY "value"   # Add a secret
telnyx-edge secrets list                  # List secrets
telnyx-edge secrets delete API_KEY        # Delete a secret

# Bindings (automatic Telnyx API key injection)
telnyx-edge bindings create               # Create binding for your org
telnyx-edge bindings get                  # View current binding
telnyx-edge bindings validate             # Test binding works
telnyx-edge bindings update               # Regenerate tokens
telnyx-edge bindings delete               # Remove binding

# System
telnyx-edge status                        # Check CLI status
telnyx-edge help                          # Show help

Getting Help

Need help? Here are your options:

Community Discord - Connect with other developers.
Support Portal - Get technical support.

Identity

Storage & Data

Edge Compute

Account & Billing

Video

Fax

SETI

OAuth

Edge Compute Quick Start

Edge Compute Quick Start

Tutorial Objectives

Prerequisites

Install the CLI

Download Binary

Authenticate

Option 1: OAuth (Recommended)

Option 2: API Key

Verify Authentication

Create a Function

Function Code

Function Code

Deploy the Function

Test the Function

Success! The Function is Live

Building on the Basics

Handle Different HTTP Methods

Use Environment Variables

Parse Query Parameters

Next Steps

Explore More Languages

Learn Core Concepts

Integrate with Telnyx Services

Common Commands

Getting Help

Identity

Storage & Data

Edge Compute

Account & Billing

Video

Fax

SETI

OAuth

​Edge Compute Quick Start

​Tutorial Objectives

​Prerequisites

​Install the CLI

​Download Binary

​Authenticate

​Option 1: OAuth (Recommended)

​Option 2: API Key

​Verify Authentication

​Create a Function

​Function Code

​Function Code

​Deploy the Function

​Test the Function

​Success! The Function is Live

​Building on the Basics

​Handle Different HTTP Methods

​Use Environment Variables

​Parse Query Parameters

​Next Steps

​Explore More Languages

​Learn Core Concepts

​Integrate with Telnyx Services

​Common Commands

​Getting Help

Edge Compute Quick Start

Tutorial Objectives

Prerequisites

Install the CLI

Download Binary

Authenticate

Option 1: OAuth (Recommended)

Option 2: API Key

Verify Authentication

Create a Function

Function Code

Function Code

Deploy the Function

Test the Function

Success! The Function is Live

Building on the Basics

Handle Different HTTP Methods

Use Environment Variables

Parse Query Parameters

Next Steps

Explore More Languages

Learn Core Concepts

Integrate with Telnyx Services

Common Commands

Getting Help