SMLL Docs

Services

Deploy containerized applications as web services, background workers, or cron jobs.

Services are the core compute unit in SMLL. You deploy Docker containers as services, and SMLL handles networking, scaling, and lifecycle management.

Service types

TypeDescription
WebReceives HTTP traffic via a public URL. Default port 8080, health check at /healthz.
WorkerBackground process with no inbound traffic. Ideal for queue consumers, data pipelines.
CronScheduled job using standard cron syntax (e.g. 0 * * * * for hourly).

Deployment modes

ModeDescription
Always onService runs continuously with the configured number of replicas. Supports HPA autoscaling.
On demandScales to zero when idle. Wakes automatically on incoming traffic (web) or schedule (cron).

On-demand services use KEDA for scale-to-zero. See Scaling for details.

Instance sizes

PlanCPUMemory
smll.nano0.25 cores512 MiB
smll.small0.5 cores1 GiB
smll.medium1 core2 GiB
smll.large2 cores4 GiB
smll.xlarge4 cores8 GiB

Creating a service

  1. Navigate to your VPC
  2. Click Create Service
  3. Configure:
    • Name — alphanumeric and hyphens
    • Type — web, worker, or cron
    • Image — from your VPC's private registry
    • Instance size — choose a plan
    • Deployment mode — always on or on demand
    • Replicas — min and max replica count
  4. Click Create

Service status

Services transition through these states:

creatingrunning / stopped / errordeployingrunning / error / crashed

Persistent storage

You can attach a persistent disk to any service:

  • Size: configurable in GB
  • Mount path: defaults to /data

The disk persists across restarts and redeployments.

On this page