What is BYOC?

BYOC (Bring Your Own Cloud) lets you deploy the Allternit runtime agent to your own infrastructure. This gives you:
  • Data privacy - Your data never leaves your servers
  • Compliance - Meet SOC2, HIPAA, GDPR requirements
  • Cost control - No per-request pricing
  • Customization - Full control over the runtime environment

Architecture

One-Line Installer

Install the runtime agent on any Linux/macOS server:
This will:
  1. Download the latest runtime binary
  2. Install to /usr/local/bin/allternit-runtime
  3. Create systemd service (Linux)
  4. Generate default configuration

System Requirements

Supported Platforms

  • Linux: Ubuntu 20.04+, Debian 11+, CentOS 8+, RHEL 8+
  • macOS: 12+ (Monterey and later)
  • Architecture: x86_64, ARM64

Configuration

The runtime is configured via runtime.yaml:

Deployment Options

VPS/Dedicated Server

Run on DigitalOcean, Linode, Hetzner, or any VPS provider

On-Premises

Deploy to your own data center or private cloud

Edge Devices

Run on edge hardware with limited resources

Homelab

Perfect for personal projects and experimentation

Security

  • API key authentication required
  • TLS encryption for all connections
  • Local SQLite database (no external DB needed)
  • Optional mTLS for enhanced security

Next Steps

Installation

Detailed installation guide

Configuration

Configure the runtime

Deployment

Production deployment tips