# Omni TrueNAS Provider

Omni TrueNAS Provider is a self-hosted infrastructure app. Sidero Omni infrastructure provider that provisions and manages Talos Linux virtual machines (VMs) on TrueNAS SCALE to run a fully automated Kubernetes cluster on a homelab server. It is open source and self-hosted, installable on TrueNAS.

Canonical page: https://ourlocalhost.com/app/3733/omni-truenas-provider

## Description

Sidero Omni infrastructure provider that provisions and manages Talos Linux virtual machines (VMs) on TrueNAS SCALE to run a fully automated Kubernetes cluster on a homelab server.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

53/100 (Fair), based on 4 of 5 factors.
- Maintained: 68 (last commit 122 days ago)
- Popular: 22 (12 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- Official website: https://bearbinary.github.io/omni-infra-provider-truenas/
- TrueNAS: https://apps.truenas.com/catalog/omni-infra-provider-truenas/
- GitHub: https://github.com/bearbinary/omni-infra-provider-truenas
- Documentation: https://bearbinary.github.io/omni-infra-provider-truenas/getting-started/

## Common questions

### Can the provider use TrueNAS's legacy REST v2.0 API?

No. It uses the JSON-RPC 2.0 API exclusively and does not support the legacy REST v2.0 API.

### How does the provider authenticate to TrueNAS?

It connects through an authenticated WebSocket using a TrueNAS API key.

### What checks run before the provider accepts work?

Startup health checks validate pool, NIC, and API connectivity before the provider accepts work.

### Can persistent Kubernetes storage use dedicated data disks?

Yes. The provider is Longhorn-ready and can use dedicated data disks configured with storage_disk_size.

### Does it remove unused ISOs or orphaned VM resources automatically?

Yes. Background cleanup automatically removes stale ISOs and orphan VMs or zvols.

### Is cluster autoscaling generally stable?

Cluster autoscaling is experimental, scale-up only, and opt-in per MachineClass.

---
Source: Our Local Host (https://ourlocalhost.com/app/3733/omni-truenas-provider), the self-hosted and open-source app directory.
