Developer Docs

Introduction

Welcome to the Utopia Labs developer documentation. This guide covers everything from initial setup to advanced deployment patterns across our global edge network.

Utopia provides a distributed computing platform with 14,800+ edge nodes across 62 countries, offering sub-millisecond routing and quantum-resistant encryption out of the box.

Quick Start

Install the Utopia CLI to get started:

$ curl -fsSL https://get.utopia.dev | sh
$ utopia auth login
$ utopia init my-project
$ utopia deploy

That’s it. Your application is now running on our global edge network with automatic TLS, health checks, and geo-routing.

Authentication

All API requests require a valid API key. Generate one from your dashboard or via CLI:

$ utopia auth token create --name "production"
Token: utp_live_a8f2k9x...

Include the token in your request headers:

Authorization: Bearer utp_live_a8f2k9x...

Deployment Configuration

Create a utopia.yaml in your project root:

name: my-app
runtime: node-20
regions:
  - ap-northeast-1
  - eu-west-1
  - us-east-1
scaling:
  min: 2
  max: 50
  target_cpu: 70
env:
  DATABASE_URL: "@secret/db-url"
  API_KEY: "@secret/api-key"

Deploy with utopia deploy and the platform handles the rest: provisioning, TLS certificates, DNS routing, and health monitoring.

Rate Limits

API rate limits vary by plan:

Starter:    100 req/min
Pro:        5,000 req/min
Enterprise: Custom (typically 50,000+ req/min)

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.