Koyeb Has a Free API That Deploys Docker Containers Globally With Zero Config

#koyeb #deployment #docker #serverless

Koyeb is the serverless platform that deploys your code to the edge. Git push, Docker image, or CLI — your app runs globally in seconds.

What Is Koyeb?

Koyeb is a developer-friendly serverless platform. Deploy apps, APIs, and workers from Git or Docker with automatic HTTPS, scaling, and global distribution.

The API

Authentication

export KOYEB_TOKEN="your-api-token"

# List apps
curl -s 'https://app.koyeb.com/v1/apps' \
  -H "Authorization: Bearer $KOYEB_TOKEN" | jq '.apps[].name'

Deploy from Docker

curl -s -X POST 'https://app.koyeb.com/v1/services' \
  -H "Authorization: Bearer $KOYEB_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "app-uuid",
    "definition": {
      "name": "my-api",
      "type": "WEB",
      "docker": {"image": "myuser/myapp:latest"},
      "instance_types": [{"type": "nano"}],
      "regions": ["fra", "was"],
      "env": [{"key": "DATABASE_URL", "value": "postgresql://..."}],
      "ports": [{"port": 8000, "protocol": "http"}],
      "scaling": {"min": 1, "max": 3}
    }
  }'

Deploy from Git

curl -s -X POST 'https://app.koyeb.com/v1/services' \
  -H "Authorization: Bearer $KOYEB_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "app-uuid",
    "definition": {
      "name": "web-app",
      "type": "WEB",
      "git": {
        "repository": "github.com/user/repo",
        "branch": "main",
        "buildpack": {"build_command": "npm run build", "run_command": "npm start"}
      },
      "instance_types": [{"type": "nano"}],
      "regions": ["fra"]
    }
  }'

Get Service Status

curl -s 'https://app.koyeb.com/v1/services/SERVICE_ID' \
  -H "Authorization: Bearer $KOYEB_TOKEN" | jq '{name: .name, status: .status, url: .active_deployment.definition.routes[0].path}'

CLI

# Install
curl -fsSL https://www.koyeb.com/install.sh | bash

# Deploy
koyeb app create my-app
koyeb service create my-api --app my-app --docker myuser/myapp:latest --port 8000:http --region fra

# View logs
koyeb service logs my-api --app my-app

Free Tier

Feature	Free	Starter ($5.56/mo)
Nano instances	1	3
Memory	256 MB	512 MB
Bandwidth	100 GB	1 TB
Custom domains	1	Unlimited
Auto-scaling	Yes	Yes

Koyeb vs Alternatives

Feature	Koyeb	Railway	Fly.io
Free tier	Always free	$5 credit	$5 credit
Global deploy	Yes	1 region	30+ regions
Docker support	Yes	Yes	Yes
Git deploy	Yes	Yes	CLI only
GPU support	Yes	No	No

Need to deploy scraping workers globally? Scrapfly handles distributed scraping. Email spinov001@gmail.com for global data extraction.

DEV Community