Volt CLI: source-available under AGPSL v5.0

Complete infrastructure platform CLI:
- Container runtime (systemd-nspawn)
- VoltVisor VMs (Neutron Stardust / QEMU)
- Stellarium CAS (content-addressed storage)
- ORAS Registry
- GitOps integration
- Landlock LSM security
- Compose orchestration
- Mesh networking

Copyright (c) Armored Gates LLC. All rights reserved.
Licensed under AGPSL v5.0
This commit is contained in:
Karl Clinger
2026-03-21 00:30:23 -05:00
commit 0ebe75b2ca
155 changed files with 63317 additions and 0 deletions

128
README.md Normal file
View File

@@ -0,0 +1,128 @@
# Volt Platform
**Comprehensive virtualization extending Voltainer into the future of computing.**
No hypervisor. Native kernel isolation. Extreme density.
## Vision
Volt Platform extends Voltainer's revolutionary container technology into full virtualization — addressing every computing need while maintaining security, efficiency, and elegance.
| Workload | Image | Density | Boot Time |
|----------|-------|---------|-----------|
| Servers | `volt/server` | 50,000+ | <200ms |
| Databases | `volt/server-db` | 20,000+ | <300ms |
| Development | `volt/dev` | 10,000+ | <400ms |
| Desktop VDI | `volt/desktop-*` | 2,000+ | <600ms |
| Edge/IoT | `volt/edge` | 100,000+ | <100ms |
| Kubernetes | `volt/k8s-node` | 30,000+ | <200ms |
## Quick Start
```bash
# Install
curl -fsSL https://get.voltvisor.io | sh
# Create a server VM
volt vm create my-server --image volt/server --memory 256M
# Start it
volt vm start my-server
# SSH in
volt vm ssh my-server
# Create a desktop VM with ODE
volt desktop create my-desktop --image volt/desktop-productivity
# Connect via browser
volt desktop connect my-desktop
```
## Architecture
```
┌─────────────────────────────────────────────────────────────┐
│ Your Application │
├─────────────────────────────────────────────────────────────┤
│ Volt Runtime │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ TinyVol │ │ Kernel │ │ SystemD │ │ ODE │ │
│ │Filesystem│ │ Pool │ │ Isolate │ │ Display │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Landlock │ │ Seccomp │ │Cgroups v2│ │Namespaces│ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
├─────────────────────────────────────────────────────────────┤
│ Linux Kernel │
│ (No Hypervisor) │
└─────────────────────────────────────────────────────────────┘
```
## Why No Hypervisor?
Hypervisors are attack surface, not protection:
- VMware ESXi: CVE-2024-37085 (RCE) — actively exploited
- Xen: XSA-* (multiple critical)
- QEMU/KVM: Escape vulnerabilities
- Hyper-V: CVE-2024-* (multiple)
Volt uses native Linux kernel isolation:
- **Landlock** — Filesystem access control
- **Seccomp** — Syscall filtering
- **Cgroups v2** — Resource limits
- **Namespaces** — Process/network isolation
- **SystemD** — Lifecycle management
Battle-tested, open source, audited.
## Kernel Profiles
| Profile | Size | Boot | Use Case |
|---------|------|------|----------|
| `kernel-server` | 30MB | <200ms | Headless servers |
| `kernel-desktop` | 60MB | <400ms | Interactive + ODE |
| `kernel-rt` | 50MB | <300ms | Real-time, video |
| `kernel-minimal` | 15MB | <100ms | Edge, appliances |
| `kernel-dev` | 80MB | <500ms | Debugging, eBPF |
## ODE Profiles (Remote Display)
| Profile | Bandwidth | Latency | Use Case |
|---------|-----------|---------|----------|
| `terminal` | 500 Kbps | 30ms | CLI, SSH replacement |
| `office` | 2 Mbps | 54ms | Productivity apps |
| `creative` | 8 Mbps | 40ms | Design, color-critical |
| `video` | 25 Mbps | 20ms | Video editing |
| `gaming` | 30 Mbps | 16ms | Games, 120fps |
## Voltainer Integration
Volt extends Voltainer — it doesn't replace it:
- Same TinyVol filesystem format
- Same cryptographic verification
- Same ArmoredLedger attestations
- Same SBOM/CVE policies
- ODE works for both containers and VMs
## Documentation
- [Complete Specification](docs/VOLT_STARDUST_SPEC.md)
- [12-Factor VMs](docs/TWELVE_FACTOR_VMS.md)
- [Kernel Profiles](docs/KERNEL_PROFILES.md)
- [ODE Integration](docs/ODE_INTEGRATION.md)
- [Kubernetes Guide](docs/KUBERNETES.md)
## License
Copyright 2026 ArmoredGate LLC. All rights reserved.
## Links
- Website: https://voltvisor.io
- Voltainer: https://voltainer.dev
- ODE: https://armoredgate.com/ode
- ArmoredLedger: https://armoredgate.com/ledger