Aeion OS Platform — Enterprise Multi-Tenant Infrastructure
Running a multi-tenant SaaS normally means stitching together a subscription vendor, a VPS provisioner, a backup/restore system, and a compliance reporting tool — four separate outages to debug, four data models to reconcile. Aeion Platform is all of it on one database: plan management and subscription lifecycle, VPS provisioning across Hetzner, Contabo, DigitalOcean, and Vultr, multi-tenant federation, Aegis point-in-time restore, compliance reporting, temporal backup retention, and real-time tier auto-upgrade.
Platform Infrastructure
Plan Management
Upgrades, downgrades, cancellations, and reactivations all run through the same lifecycle engine — trial expiry checked daily, Stripe payment webhooks processed automatically, and a customer who cancels stays live until the period they already paid for actually ends, then gets suspended cleanly instead of cut off mid-cycle.
VPS Provisioning
Spinning up a new tenant — server, domain, entitlements — runs as an async job queue against Hetzner, Contabo, DigitalOcean, or Vultr, with automatic 3-retry recovery on transient failures. Instances stuck mid-provision get polled and flipped to active the moment the provider confirms they're actually up, so nobody has to babysit a deploy.
Cross-Tenant Federation — Digital Alliances
Code-free B2B event sharing between separate tenants. Two organizations sign a "Digital Alliance" data contract (provider + consumer + an allowed-event whitelist); when a whitelisted event fires in one tenant it's deep-cloned, re-stamped with the consumer's tenant ID, and injected into their real-time stream in milliseconds — no webhooks, no custom API integration. Zero-trust airlock: federated events are read-only signals, loop-guarded against reflection, and system/platform/cron-level events are hard-blocked from ever crossing the boundary.
Ring-0 Kernel Firewall (XDP eBPF)
Define threat-matrix rules (block subnets, protect ports) in a visual rule builder; the Universal AST Engine compiles them straight down to kernel-level packet-filtering bytecode and loads it onto the network card's fast path. Malicious and DDoS packets get dropped before the kernel even allocates memory for them, so an attack costs your application close to zero CPU. On hosts where the low-level compiler toolchain isn't available, it degrades gracefully to a simulation mode so you can still author and test rules.
Aegis Point-in-Time Restore
Restore to any second between your oldest backup and now — not just the nearest nightly snapshot — using continuous WAL-based recovery, with a sidecar-restore path available when you need a selective table-level extract instead of a full restore. If point-in-time recovery isn't configured yet, the system says so honestly rather than pretending a restore worked.
Temporal Backup Retention
Pick a retention window per plan tier — 7, 30, or 90+ days — and every sweep gets logged per-tenant for cron health visibility, so a silent retention failure shows up in the Aegis Hub Health card instead of quietly deleting backups nobody noticed were gone.
Compliance Reporting
Every month, your backup and verification activity rolls up automatically into an auditor-ready JSON + HTML evidence package, uploaded straight to your own backup bucket — the SOC2/ISO27001 paperwork your auditor asks for, generated without anyone building a report by hand.
Realtime Tier Auto-Upgrade
When a real-time session's call-minute usage threatens to exceed your plan's allowance, the tenant auto-upgrades to the next tier before the meeting drops — bill shock happens after the fact in an invoice, not mid-sentence in a live call.
Backup Verification
Every tenant's latest backup gets restored and verified weekly, automatically — closing the gap auditors always flag: an untested backup isn't actually a backup. Honestly reports a no-op when there's no recent backup or storage isn't configured yet, rather than showing a false green check.
Tenant Management
Create, suspend, activate, or archive a tenant with one action each. Suspension stops billing immediately; archiving preserves the data instead of deleting it; reactivation resumes both billing and any suspended instances in one step.
Tenant Config Validation
Every module can add its own tenant-level config settings without stepping on another module's — type-safe validation catches a malformed config before it reaches production, and new modules can extend the schema without a merge conflict with existing ones.
Email Infrastructure
Transactional email delivery, inbound processing, and account management across SMTP, SendGrid, Mailgun, Resend, or Postmark — with SPF/DKIM/DMARC authentication configured so your platform emails land in the inbox, not the spam folder.
Audit Log Retention
Configurable retention windows archive old audit entries and purge expired ones automatically, driven by your own retention policy — so compliance requirements are enforced by a schedule, not a quarterly manual cleanup.
Cross-Tenant Federation — Code-Free B2B Alliances
In a normal SaaS ecosystem, when one company's system needs to notify another's, someone builds webhooks (Zapier/Make) or a custom API integration. Aeion replaces that with Digital Alliances: two tenants sign a data contract, and approved events flow directly between their real-time event streams — instantly, with no integration code on either side.
What it looks like:
- Autonomous supply chain — a manufacturer updates a wholesale price; the
commerce.product.updatedevent crosses the alliance and triggers the retailer's workflow to re-price their storefront. No nightly sync, no API polling. - Franchise network — corporate hits "DEFCON 2"; the
crisis.defcon.escalatedevent broadcasts to 500 franchisee tenants at once, locking down each local system — without 500 API calls. - Agency ↔ client — an agency uploads a campaign asset; the
vault.document.createdevent refreshes the live-preview panel in the client's separate workspace in real time.
How it stays safe (the zero-trust airlock): federation requires an active, signed contract that names the provider, the consumer, and an explicit allowedEvents whitelist (exact or wildcard, e.g. logistics.shipment.*). When an event qualifies, the payload is deep-cloned to sever all references to the provider's objects, re-stamped with the consumer's tenant ID, and tagged federatedFrom so its origin is traceable. Three guarantees are structural, not configurable: federated events are read-only signals (the provider can never write to the consumer's data — the consumer's own workflows decide what to do), reflection loops are impossible (a federatedFrom event is never re-federated), and system.* / platform.* / cron.* events are hard-blocked at the router even if someone tries to whitelist them.
Subscription Lifecycle — How Upgrades and Cancellations Work
Upgrading: the moment a customer confirms an upgrade, their new plan's entitlements are granted immediately — no waiting for the next billing cycle to unlock a feature they just paid for. The change is logged and propagates instantly to every module that checks entitlements.
Cancelling: by default, a cancelling customer keeps full access through the end of the period they already paid for, then suspends cleanly — never cut off mid-cycle for something they paid for. An immediate-cancellation option is available too, for cases where a customer wants access to stop right away.
Reactivating: un-cancelling restores active status and resumes anything that was suspended in one step — no manual cleanup required.
Payment webhooks: successful renewal payments extend the billing period automatically; a failed payment moves the account to past-due, fires a notification, and kicks off a dunning sequence — so a declined card starts a recovery flow instead of silently lapsing.
Aegis — Point-in-Time Restore
The problem Aegis solves: Before Aegis, database restore was a blunt instrument — you could restore a full backup or nothing. If a bug corrupted 5 minutes of data across 3 tables at 2:47 AM, you had to choose between losing a full backup's worth of data or keeping the corruption.
Aegis solution: Point-in-time recovery. Restore to any second between the oldest full backup and now — not just the nearest nightly snapshot — with a selective, table-level extract path available when a full restore is more than what's needed.
Bulk undo: an event-store-based safety net that stays read-only until an operator explicitly confirms the action — nothing changes as a side effect of just reviewing what would be undone.
Honest by design: if point-in-time recovery isn't configured yet on a given deployment, the system says so plainly rather than pretending a restore worked. No silent failures, no false green checkmarks.
Provisioning — How Tenants Are Created
Spinning up a new tenant — server, domain, entitlements — runs as a background job with automatic retry: up to 3 attempts recover from transient failures before anything is flagged for manual attention. Provisioning covers the full lifecycle: creating the tenant, provisioning the server, setting up the domain, granting entitlements, and handling suspend/resume/upgrade transitions as they happen.
VPS providers: Hetzner Cloud, Contabo, DigitalOcean, and Vultr today, through a provider-agnostic interface designed to add more without disrupting existing tenants.
Self-healing on stuck instances: instances that get stuck mid-provision are automatically polled and flipped to active the moment the underlying provider confirms they're actually up — nobody has to babysit a deploy — checking up to 100 at a time.
Instance lifecycle: every instance moves cleanly through pending → provisioning → active, with suspend, upgrade, and downgrade all resuming back to active from a consistent state — no dead ends.
Real-Time Tier Auto-Upgrade
The problem: A tenant on a Professional real-time plan has 2,000 call minutes/month. They run a long all-hands meeting that uses 1,900 minutes. Without auto-upgrade, the remaining 100 minutes lasts about 10 more minutes — then the meeting gets cut off mid-sentence.
The fix: usage is monitored continuously against the plan's allowance. The moment a live session threatens to exceed it, the tenant is upgraded to the next tier automatically — mid-meeting, without interrupting the call — and notified afterward by email, Slack, or webhook. Bill shock happens after the fact in an invoice, never mid-sentence in a live call.
Configurable per plan: each tier defines its own call-minute allowance and the exact usage threshold (e.g. 80%) that triggers the auto-upgrade, plus which tier it upgrades to — so the safety margin can be tuned per plan rather than being one-size-fits-all.
By the Numbers
4 VPS providers
Hetzner, Contabo, DigitalOcean, and Vultr, with a pluggable provider interface for adding more
~30s RPO
Point-in-time recovery via continuous WAL streaming
7 / 30 / 90+ days
Backup retention windows you pick per plan tier
3 retries
Each provisioning job auto-recovers from transient failures
Aegis-backed
Backup, PITR, and per-document time-travel built in
Multi-tenant from day one
Per-tenant resource isolation, plan-based feature gating, automatic billing reconciliation
Frequently Asked Questions
Platform handles cross-cutting infrastructure that every module relies on — tenant provisioning, VPS auto-upgrade, BYOB S3 backup config, the Aegis backup/restore/PITR engine, subscription billing, compliance reporting, and the mail relay used across modules. Not customer-facing in the usual sense; it's the operator-facing meta-module.
Your tenant's CPU/memory/disk usage is continuously monitored against your tier's limits. Approaching capacity triggers a notification to the operator; if auto-scale is enabled, the next tier up provisions automatically with zero-downtime cutover. Downgrade requires manual approval since it has data-fit implications.
Aegis is Platform's backup + restore + time-travel feature, built directly into the same infrastructure layer every tenant runs on. It gets its own marketing surface because the story is buyer-facing enough to deserve dedicated pricing + positioning. Aegis is to backup what Stripe Billing is to checkout — a focused product inside the larger platform.
Yes — self-host on Hetzner, OVH, Linode, AWS, GCP, Azure, or bare metal. Provisioning is optimized for Hetzner (fastest to set up), but the platform itself runs anywhere Docker + Postgres 17 + Redis 7 run.
Customer-controlled S3-compatible bucket (AWS S3 / Cloudflare R2 / Wasabi / Backblaze B2 / MinIO / DO Spaces). Aeion writes backups + WAL archive + PITR base + verification snapshots to that bucket using credentials only you hold. Aeion staff cannot access customer backups.