# Noite

> The app platform you own. A tiny self-hostable PaaS: one command installs it, git push deploys.

## Docs

- [Introduction](https://noite.run/introduction): Noite is a tiny self-hostable PaaS for celld — accounts, apps, subdomains, deploy logs.
- [Quickstart](https://noite.run/quickstart): Install Noite on a fresh server with one command, then deploy your first app with git push.
- [How it works](https://noite.run/how-it-works): The runner supervises Caddy, the control UI, and one celld fleet per app over a single S3 bucket.

## Apps

- [Apps](https://noite.run/apps): What an account holder can do with an app — deploy it, configure it, observe it.
- [Deploy](https://noite.run/apps/deploy): Create an app and ship it — push over Git, deploy from CI, and what each push triggers.
- [Build](https://noite.run/apps/build): How the runner builds a push — Vite, Rsbuild, static sites, frameworks, custom build commands — and which config it deploys.
- [Configure](https://noite.run/apps/configure): Env vars, custom domains, rate limits, collaborators, source edits, and storage for one app.
- [Observe](https://noite.run/apps/observe): Logs, metrics with spans, errors, product-analytics events, and idle sleep for one app.

## Self-hosting

- [Self-hosting](https://noite.run/self-hosting): Run Noite on your own server with Docker Compose — install, storage, tenancy, platforms, and operations.
- [Install](https://noite.run/self-hosting/install): Install Noite on a fresh server with one command, or by hand with Docker Compose — bundled RustFS or your own S3 bucket.
- [Storage](https://noite.run/self-hosting/storage): Object-store backends, volumes, snapshots, and the telemetry pipeline behind a Noite install.
- [Tenancy](https://noite.run/self-hosting/tenancy): NOITE_TENANCY decides whether other people may push code — multi runs tenant code sandboxed, single is just you.
- [Known limits](https://noite.run/self-hosting/known-limits): What Noite's alpha does not do yet — tenant isolation depth, custom domain ownership, resource containment, and the restart cost of an upgrade.
- [Platforms](https://noite.run/self-hosting/platforms): Run Noite on Coolify or Railway — env, domains, downtime model, and platform-specific settings.
- [Edge protection](https://noite.run/self-hosting/protection): Rate limits at the edge, per-app ceilings, and putting Cloudflare in front of Noite to absorb floods.
- [Operations](https://noite.run/self-hosting/operations): Update Noite, back up and restore its volumes, and troubleshoot ready gates and boot failures.
- [Accounts](https://noite.run/self-hosting/accounts): Invite-only registration on a Noite install — bootstrap admin, single-use codes, and admin panels.

## Reference

- [API](https://noite.run/reference/api): Runner HTTP API reference — auth, per-resource routes, statuses, and the JSON-RPC mirror.
- [Environment variables](https://noite.run/reference/environment-variables): Every runner env var with its default, effect, and owner.
- [Limits](https://noite.run/reference/limits): Quotas, fleet bounds, rate limits, and the scale-to-zero sleep mechanism.
- [CLI](https://noite.run/reference/cli): Deploy prebuilt dist directories over Git smart-HTTP with @noitenow/cli.

## Agent resources

- [llms-full.txt](https://noite.run/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://noite.run/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://noite.run/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://noite.run/openapi.json.
- [Agent skills](https://noite.run/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://noite.run/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://noite.run/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://noite.run/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://noite.run/sitemap.xml): Every indexable page URL with its last-modified date.