Skip to content

Static apps

A static app is a bundle of static files (HTML/CSS/JS). The runner serves the bundle directly. The app requires no container. You reach it at <slug>.althostproxy.com.

Deploying

  1. Create the app (Static apps → New). It gets an auto-generated, immutable slug.
  2. Upload a .zip of your build (POST /v1/static-apps/:id/upload). If the zip has a single top-level folder, the runner serves that folder as the root.
  3. The runner downloads the build. It serves the build from an in-process HTTP server. It advertises the build. The app flips to active with a URL.

Routing rules

You can attach routing rules (portal, or a routing.yaml inside the bundle):

- path: /*
  serve: index.html   # SPA fallback
  cacheTtl: 0
- path: /assets/*
  cacheTtl: 86400

Rules control which file a path serves and its Cache-Control. Unknown extensionless routes fall back to the configured serve file (SPA-friendly). The runner rejects path traversal outside the bundle.