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.
   • 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 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.

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.

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 — set up your first Security Group and API Key.
• Monitoring & Logging — track Sentinel's health once it's live.