Docs/Web Services

Web Services

Deploy any HTTP app or API with auto-deploys, TLS and zero-downtime rollouts.

A Web Service is any process that listens for HTTP requests. Runko builds it, runs it, and puts it behind a fast global edge with automatic TLS.

Configuration

Define a web service in runko.yaml, or let runko init generate it for you.

yaml

services:
  - type: web
    name: api
    env: node
    build: npm ci && npm run build
    start: npm run start
    plan: hobby        # $1/mo
    healthCheckPath: /healthz

Listening on the right port

Runko injects a PORT environment variable. Bind your server to it — don't hardcode a port.

app.listen(process.env.PORT || 3000);

Auto-deploys

Every push to your production branch triggers a build and zero-downtime deploy.
Open a pull request to get an isolated preview environment with its own URL.
Roll back to any previous deploy instantly from the dashboard or `runko rollback`.

← Previous

The Runko CLI

Docker Compose