# Install on Bunny.net

Bunny.net's Magic Containers run Sentinel with minimal setup, and pair naturally with Bunny's own LibSQL database offering — an all-in-one, EU-based option with clustering and autoscaling built in.

## Prerequisites

- An active Bunny.net account.

## Step 1 — Create the container

1. In the Bunny.net dashboard, go to **Edge Platform → Magic Containers**.
2. Click **+ Add App** and name the application.
3. Choose a single-region deployment and proceed.
4. Click **Add Container** and configure:
- **Registry**: `GitHub Public`
- **Image**: `altcha-org/sentinel`
- **Version tag**: pick the release you want — see [Releases](/docs/sentinel/releases/).
- **Port**: keep only `8080` exposed.
5. Add environment variables:
- `SECRET_SEED` — a securely generated random string, minimum 24 characters. This is critical for multi-instance deployments to stay in sync — see [Scaling](#step-3--scale-the-deployment) below.
- `LICENSE_KEY` — if applicable to your plan.
6. Confirm and create the app.

## Step 2 — Configure a database

Sentinel on Bunny.net is set up to work with Bunny's own remote LibSQL databases:

1. In **Edge Platform → Database**, click **+ Add Database** and name it.
2. Select the same region as your container.
3. Download the connection credentials.
4. Select **Add Secrets to Magic Container App** to wire the credentials into your container automatically.

Alternatively, set `BUNNY_DATABASE_URL` and `BUNNY_DATABASE_AUTH_TOKEN` manually as environment variables on the container. PostgreSQL and Redis are also supported as separately-hosted databases — see [Databases](/docs/sentinel/databases/).

## Step 3 — Scale the deployment

Under **Regions and Scaling**, adjust the number of autoscaling replicas and add additional regions as needed. Multi-instance deployments share the same database configuration; every instance appears under the same Sentinel dashboard and admin account.

> **Note:**
>
> Bunny's LibSQL database can become a bottleneck under demanding, multi-instance traffic. A local/embedded database performs well for a single instance but doesn't support clustering — pick PostgreSQL or Redis instead if you expect to scale out heavily.

## Step 4 — Access the application

Once deployed, Sentinel is reachable at:

- Web interface: `https://[your-app-id].bunny.run/`
- API: `https://[your-app-id].bunny.run/v1`
- API documentation: `https://[your-app-id].bunny.run/v1/docs`

Sign in with the default credentials `root` / `root` and change the password immediately.

## Upgrading Sentinel

Update the container's version tag in the Magic Containers dashboard and redeploy.

## Next steps

- **[Configure](/docs/sentinel/configure/)** — set up your first Security Group and API Key.
- **[Monitoring & Logging](/docs/sentinel/operations/monitoring-logging/)** — track Sentinel's health once it's live.