Documentation
Basalt Documentation
Detailed deployment documentation is being built out alongside the platform and ships with each Basalt release. This page is the current index for public architecture, operations, capability, and engineering resources.
Platform Reference
These pages describe how Basalt is structured: the three-component model, the control-plane security boundary, the operational task system, and the monitoring surfaces operators use during cluster lifecycle work.
Architecture
Platform Architecture
Review the control plane, managed-host agents, resource model, and how Basalt coordinates compute, networking, storage, tasks, and identity across a cluster.
Security
Security Model
Understand tenant isolation, Postgres RLS, RBAC permissions, zero-trust agent identity, activation leases, and FIPS 140-3 cryptography via aws-lc-rs.
Operations
Operations & Monitoring
Explore durable tasks, audit events, metrics, alerts, maintenance mode, host lifecycle workflows, and the operational signals used to keep clusters observable.
Capability Guides
Capability pages document the infrastructure services Basalt exposes today, with implementation details and honest limitations where backend support differs by storage pool or deployment model.
Compute
Compute Lifecycle
KVM/libvirt VM lifecycle management, image templates, cloud-init customization, console access, live migration, GPU passthrough, and placement-aware operations.
Networking
Networking
OVS-native SDN with VLAN, flat, and VXLAN zones; OpenFlow security groups; routers; NAT; and tenant-aware routing controls.
Storage
Storage
Multi-backend storage orchestration across dir, LVM, NFS, iSCSI, GlusterFS, Ceph RBD, DRBD, and the pool-capability checks that govern supported operations.
AI
AI Integration
MCP tools, operator-assisted workflows, capability reasoning, and automation boundaries for AI agents working against Basalt infrastructure.
Engineering Resources
Blog
Engineering Blog
Follow design notes, implementation write-ups, and release-focused engineering context while the public documentation set expands.
Need deployment-specific documentation?
Production deployment guides, upgrade runbooks, environment-specific topology notes, and integration checklists are provided with early access and licensed platform engagements. Share your target hardware, storage backend, network design, and operational constraints so the documentation matches the environment you plan to run.