Unraid Kubernetes
Unraid Kubernetes is a native Unraid plugin for installing, adopting, managing, and observing a k3d/K3S cluster directly from the Unraid web GUI.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
57/100 Fair
- Maintained
- 76last commit 38 days ago
- Popular
- 2414 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- 502 GB minimum RAM
- Security check
- 95no serious findings, CI, tests
Availability: platform listings confirmed today, links checked 4 days ago
- GitHub stars
- 14
- Open issues
- 1
- Last commit
- 2026-10-14
- Latest release
- v2026.08.31
- License
- MIT
- Activity
- stale
Checked 4 days ago - source: GitHub (DonnieDice/unraid-kubernetes)
Resources & Compatibility
Minimum requirements: 2 GB RAM, 2 CPU core(s).
Checked 44 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install from the local plugin address If you are using a local plugin build, make sure it is reachable at http://YOUR_IP:5858/ (replace YOUR_IP with the machine running it; port 5858 is the installer page), then enter that address in Unraid's Plugins → Install Plugin. If Unraid can't reach it, the plugin install page won't load. source
- Cluster Setup After installing the plugin, use the built-in Kubernetes page to install or adopt a k3d/K3S cluster; deploy workloads with Kubernetes manifests, Helm, or GitOps tooling. source
- Initial Use Use the dedicated Kubernetes page in the unRAID web GUI for cluster lifecycle, then deploy workloads using manifests, Helm, or GitOps tooling. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I install Unraid Kubernetes as a Docker template?
No, install the .plg file from Unraid’s Plugins page or from a Community Apps entry published as a plugin. It is an Unraid plugin, not a Docker template.
Can I manage the k3d Kubernetes runtime containers from Docker’s Edit page?
No, do not recreate them through Docker Edit because k3d owns their labels, mounts, command line, and network. Change cluster settings through the Kubernetes settings page instead.
What happens to cluster data when I remove the Unraid Kubernetes plugin?
Removing the plugin stops the cluster but preserves its datastore, token, kubeconfig, and local-path storage. This allows you to recover or deliberately delete the cluster data later.
How should I deploy applications to the cluster created by the plugin?
Deploy workloads with Kubernetes manifests, Helm charts, or your preferred GitOps tool. The plugin handles host-level cluster lifecycle and visibility, while application deployment remains separate.
Can I keep using Unraid as storage while running Kubernetes workloads on Unraid?
Community guidance says Unraid can export NFS or iSCSI for Kubernetes nodes to consume. Transcoding may hit a bandwidth bottleneck, so check the network throughput your workload needs.
Answers sourced from github.com, www.reddit.com
Community
- Migrating from unRAID to Kubernetes : r/homelab - Reddit (reddit)
- [Guide] Arch Linux Kubernetes cluster on Unraid - VMs - Unraid (forum)
- Kubernetes cluster - Feature Requests - Unraid (forum)
- [Plugin] Unraid Kubernetes - Support - Plugin System - Unraid (forum)
- Using unRAID as storage for a Kubernetes cluster : r/unRAID - Reddit (reddit)
Collected 48 days ago - public community threads