| name | omni-talos |
| description | Operational tooling for Talos Linux Kubernetes clusters via Sidero Omni with Proxmox infrastructure provider, covering machine classes, CEL storage selectors, and provider lifecycle management.
|
| when_to_use | Use when checking provider status, restarting provider, viewing provider logs, debugging provider registration, creating a machine class, configuring Proxmox provider, setting up CEL storage selectors, or creating a Talos cluster.
|
Omni + Proxmox Infrastructure Provider
Operational tooling for Talos Linux Kubernetes clusters via Sidero Omni with Proxmox infrastructure provider.
Provider Operations
Use ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py for provider management:
| Task | Command |
|---|
| Check status | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --status |
| View logs | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --logs 50 |
| Raw JSON logs | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --logs 50 --raw |
| Restart provider | ${CLAUDE_PLUGIN_ROOT}/skills/omni-talos/scripts/provider-ctl.py --restart |
The provider runs in Foxtrot LXC CT 200. The script reaches Foxtrot with
Tailscale SSH and executes provider commands through pct exec. Override its
defaults with OMNI_PROVIDER_HOST, OMNI_PROVIDER_CT, or
OMNI_PROVIDER_SERVICE when the deployment topology changes. The provider
container is discovered from its Docker Compose service label;
OMNI_PROVIDER_CONTAINER remains available as an explicit override.
Current Deployment
| Component | Location | IP | Endpoint |
|---|
| Omni | Holly (VMID 101, Quantum) | 192.168.10.20 | omni.spaceships.work |
| Proxmox Provider | Foxtrot LXC (CT 200, Matrix) | 192.168.3.10 | L2 adjacent to Talos VMs |
| Target Cluster | Matrix (Foxtrot/Golf/Hotel) | 192.168.3.{5,6,7} | Proxmox API |
| Storage | CEPH RBD | — | vm_ssd pool |
Quick Reference
omnictl commands:
omnictl cluster status <cluster-name>
omnictl get machines -l omni.sidero.dev/cluster=<cluster-name>
omnictl get machineclasses
omnictl apply -f machine-classes/<name>.yaml
omnictl cluster template sync -f clusters/<name>.yaml
Note: --cluster flag does not exist. Use label selector -l instead.
MachineClass minimal example:
metadata:
namespace: default
type: MachineClasses.omni.sidero.dev
id: matrix-worker
spec:
autoprovision:
providerid: matrix-cluster
providerdata: |
cores: 4
memory: 16384
disk_size: 100
storage_selector: name == "vm_ssd"
node: foxtrot
See references/machine-classes.md for full field reference.
Key Constraints
| Constraint | Details |
|---|
| L2 adjacency | Provider MUST be on same L2 as Talos VMs (Foxtrot LXC) |
CEL type reserved | Use name only for storage selectors |
| Hostname bug | Use :local-fix tag, not :latest |
| No CP pinning | Omni allows only 1 ControlPlane section per template |
| No VM migration | Destroys node state — destroy/recreate instead |
| Split-horizon DNS | omni.spaceships.work → 192.168.10.20 (LAN) |
Reference Files
| File | Content |
|---|
references/architecture.md | Network topology, design decisions |
references/machine-classes.md | Full provider data fields (compute, storage, network, PCI) |
references/provider-setup.md | Provider config, compose setup, credentials |
references/cluster-templates.md | Cluster template structure, patches |
references/cel-storage-selectors.md | CEL syntax and patterns |
references/debugging.md | Common issues |
references/recovery-procedures.md | Recovery from stuck states |
references/proxmox-permissions.md | API token setup |
references/omnictl-auth.md | Authentication methods |
Examples
| File | Description |
|---|
examples/machineclass-ceph.yaml | CEPH storage |
examples/machineclass-local.yaml | Local LVM |
examples/cluster-template.yaml | Complete cluster |
examples/proxmox-gpu-worker.yaml | GPU passthrough |
examples/proxmox-storage-node.yaml | Storage node |
examples/proxmox-worker-multi-net.yaml | Multi-network |
