Bunny.net Deployment

Bunny.net is a global CDN provider based in the EU. It offers integrated services suitable for deploying ALTCHA Sentinel with minimal operational overhead compared to traditional cloud platforms.

This guide explains how to deploy a scalable ALTCHA Sentinel cluster on Bunny.net using its built-in services, without relying on external databases.

Preview

Bunny.net Containers and Databases are currently in preview and are not recommended for mission-critical deployments.

Benefits

• All-in-one solution with competitive pricing
• Simple deployment with minimal technical overhead
• Supports clustering and autoscaling
• EU-based provider

Requirements

• Active Bunny.net account
• ALTCHA Sentinel version 1.23.0 or later

Deployment Guide

1. Create a Container

Bunny.net provides Magic Containers, designed to simplify scalable deployments.

To deploy ALTCHA Sentinel:

1. Navigate to Magic Containers under Edge Platform
2. Click + Add App
3. Enter an application name (e.g., Sentinel)
4. Choose Single region deployment, select a region, and click Next Step
5. Click Add Container

• Select GitHub Public in the Registry field
• Enter altcha-org/sentinel in the Image field
• Select the required version in the Tag field
• Click Add Endpoints (Keep only port 8080 and remove any other automatically created endpoints)
• Open Environment Variables
  • Add SECRET_SEED and set it to a securely generated random string (minimum 24 characters)
  • Add LICENSE_KEY if applicable
• Click Add Container

6. Click Next Step, then Confirm and Create

Caution

Configuring SECRET_SEED is important for multi-instance deployments as it ensures that all nodes share the same secret values. See documentation.

2. Create a Database

Starting with Sentinel version 1.23.0, the application supports remote LibSQL databases, which are available on Bunny.net.

To create and connect a database:

1. Navigate to Database under Edge Platform
2. Click + Add Database
3. Enter the application name (e.g., Sentinel)
4. Select Single region deployment and choose the same region as your container
5. Click Add Database
6. Download the generated connection credentials
7. Select Add Secrets to Magic Container App, choose your container app, and confirm

The container will automatically update and begin using the database.

Alternatively, manually configure these environment variables:

• BUNNY_DATABASE_URL
• BUNNY_DATABASE_AUTH_TOKEN

Standard PostgreSQL and Redis deployments are also supported but require separate infrastructure.

3. Scaling

When using the Bunny.net Database, you can run multiple application instances (replicas), as they all share the same database.

To enable scaling:

1. Open your app details and navigate to Regions and Scaling
2. Adjust Autoscaling per region as needed
3. Optionally add additional regions
4. Click Save Changes

If configured correctly, all instances will appear in the Sentinel dashboard (root account required).

Tip

Keep containers geographically close to the database to minimize latency and optimize performance.

Accessing ALTCHA Sentinel

After deployment, the application is available at:

https://[your-app-id].bunny.run/

Default credentials:

• Username: root
• Password: root

Endpoints:

• 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

To use a custom domain, configure it under Endpoints.

Upgrading Sentinel

1. Open Container Settings
2. Click Edit on the container
3. Select the desired version in the Tag field
4. Click Update Container to redeploy

Performance

While Magic Containers and the CDN provide strong performance with low latency, the LibSQL database offered by Bunny.net may become a bottleneck in more demanding deployments.

For single-instance deployments, the built-in local database provides significantly better performance, but it does not support multi-instance clustering.

If higher performance is required for multi-instance clusters, consider using PostgreSQL and Redis instead. See the clustering documentation for more details.

Estimated Costs

For small deployments with low to moderate traffic:

• Magic Containers: typically under $1 per day per instance
• Database: typically under $1 per month
  • 1–2 million rows read per day
  • 50,000–100,000 rows written per day
  • 10–50 MB storage

Refer to official Bunny.net pricing documentation for accurate and up-to-date cost details.