# Kedge

> A lightweight, globally distributed cloud platform. Deploy static sites, HTML apps with live data, shebang handlers, container services, and databases from a source tree, a Git push, a prebuilt image, or a task for a coding agent in a persistent workspace. Every app includes a replicated SQLite database and file tree, scales to zero, and runs in hardware-isolated VMs.

Every page below is also available as markdown at the same URL.
The complete documentation as one file is at https://kedge.dev/llms-full.txt.
The compact deployment skill is at https://kedge.dev/.well-known/agent-skills/kedge/SKILL.md.
The REST API is described by https://kedge.dev/api/openapi.json.

## Start

- [quickstart](https://kedge.dev/docs/quickstart.md): Publish directly or start with a coding-agent task
- [coding agents & workspaces](https://kedge.dev/docs/agents.md): Start and resume coding-agent sessions in persistent workspaces
- [app model](https://kedge.dev/docs/app-model.md): Sites, services, machines, and global placement
- [deploy workflows](https://kedge.dev/docs/deploy.md): Deploy directories, Git branches, images, and repositories

## Build

- [sites & routing](https://kedge.dev/docs/sites.md): Static file trees, Markdown, clean paths, and fallbacks
- [HTML apps](https://kedge.dev/docs/html-apps.md): Add live data and managed writes to ordinary HTML
- [handlers](https://kedge.dev/docs/handlers.md): Turn shebang files into request handlers
- [builds & images](https://kedge.dev/docs/builds.md): Automatic source builds, Dockerfiles, and prebuilt images
- [app authentication](https://kedge.dev/docs/authentication.md): Protect any app and pass verified identity to HTML, handlers, and services
- [GitHub deploys](https://kedge.dev/docs/github.md): Automatic deploys and pull-request previews

## Data

- [shared data](https://kedge.dev/docs/shared-data.md): SQLite and files built into every app
- [persistent volumes](https://kedge.dev/docs/volumes.md): Private local filesystems for software that needs one

## Run

- [instant sandboxes & scale-out](https://kedge.dev/docs/performance.md): How sandboxes and app instances become ready in milliseconds
- [security & isolation](https://kedge.dev/docs/security.md): VM, network, access, and secret boundaries
- [runtime & scaling](https://kedge.dev/docs/runtime.md): Autoscaling, readiness, snapshots, and cold starts
- [network & domains](https://kedge.dev/docs/network.md): HTTPS, custom domains, private networking, and CDN
- [global coverage](https://kedge.dev/docs/coverage.md): Compute regions and measured network latency
- [sandboxes](https://kedge.dev/docs/sandboxes.md): Disposable VMs for one-shot code and interactive work

## Operate

- [logs & metrics](https://kedge.dev/docs/observability.md): Live logs, metrics queries, events, and webhooks
- [pricing & billing](https://kedge.dev/docs/billing.md): Metered resources, rates, credits, and suspension

## Reference

- [HTML app reference](https://kedge.dev/docs/html-app-reference.md): Bindings, forms, interpolation, identity, and Markdown shorthand
- [configuration](https://kedge.dev/docs/configuration.md): Configuration sources, precedence, and property reference
- [Compose reference](https://kedge.dev/docs/compose.md): Supported Compose fields and x-kedge extensions
- [starters & shared apps](https://kedge.dev/docs/templates.md): Curated starters, deploy links, and repeat deploys
- [GitHub Actions runners](https://kedge.dev/docs/github-runners.md): Disposable VMs for GitHub Actions jobs
- [CLI & SSH reference](https://kedge.dev/docs/cli.md): Install the CLI, deploy and manage apps, or use SSH directly
- [REST API reference](https://kedge.dev/docs/api.md): Authentication, conventions, examples, and generated endpoints

## Blog

- [Long Live Global Heroku](https://kedge.dev/blog/long-live-global-heroku.md): Why agent-made software needs an erosion-resistant platform contract, replicated state, and disposable compute.