# Nimbus

> A control panel that turns one Linux server into a hosting platform: add a domain, pick a stack, and it serves over HTTPS — with deployments, databases, access control, an HTTP API and an MCP server.

Nimbus runs one box. Every site is a container behind Caddy, which issues its own certificate. The pages below are the site-owner guide (for developers running an app on a Nimbus box) plus the agent guide. Operator documentation — installing and running the platform — lives with the source, not here.

## Start

- [Hosting on one box](https://panel.nimbus-online.net/index.html.md): What Nimbus is: a control panel for a single Linux server, with deployments, databases, access control, an API and an MCP server.
- [Working with Nimbus from an AI agent](https://panel.nimbus-online.net/agents/index.html.md): How an AI agent drives a Nimbus box: the MCP server, the HTTP API, and the AGENTS.md file to drop into a site's repository.

## Site owner guide

- [Start here](https://panel.nimbus-online.net/help/index.html.md): Your app runs in a container and a domain points at it. That sentence is the whole platform.
- [What a site is](https://panel.nimbus-online.net/help/sites.html.md): A domain, an image and a folder, bound together. Creating one gives you a running container.
- [Choosing an image](https://panel.nimbus-online.net/help/images.html.md): The image decides what can run in your container: a static file server, or PHP with a deployment runner.
- [Getting your code on](https://panel.nimbus-online.net/help/deploying.html.md): How your files reach the folder the container serves, and what must survive a deploy.
- [Background work](https://panel.nimbus-online.net/help/background-jobs.html.md): Queue workers and scheduled tasks, declared in your repository and run inside your own container.
- [Databases and Redis](https://panel.nimbus-online.net/help/services.html.md): One MySQL database per site, shared Redis, and how the credentials reach your app.
- [Domains and HTTPS](https://panel.nimbus-online.net/help/domains.html.md): Point DNS at the box and the certificate happens on its own. Extra domains are aliases.
- [When you get a 403](https://panel.nimbus-online.net/help/access.html.md): Locked sites and locked folders answer only to unlocked addresses. How to get yours admitted.
- [Limits and reference](https://panel.nimbus-online.net/help/reference.html.md): Paths, names, versions and the things the platform will not do for you.
- [Deploy on push](https://panel.nimbus-online.net/help/ci.html.md): Turning on the in-container runner, the reference workflows, and why `if: always()` matters.

## Optional

- [Everything, in one file](https://panel.nimbus-online.net/llms-full.txt): every page above concatenated, for a single fetch.