Compatibility¶
This page lists the Kubernetes versions, Linux distributions, kernels, and hardware that have been tested with MeshStor, plus the broader requirements for combinations that should work but have not been explicitly verified.
For the day-of-deployment checklist (packages, kernel modules, node annotations), see Prerequisites.
Hardware requirements¶
| Requirement | Value |
|---|---|
| Drive type | NVMe (required — SATA SSDs and spinning disks are not supported) |
| Minimum node count | Equal to replicaCount — 1 for replicaCount=1 (local storage mode), 2 for replicaCount=2, and so on |
| Minimum NVMe drives per node | Equal to stripeWidth — 1 for stripeWidth=1, 2 for stripeWidth=2, and so on. Sharing NVMe drive with the OS partitions is fine — MeshStor only needs unpartitioned free space at the GPT level (free space inside an LVM PV or LVM VG do not count, since MeshStor needs direct access to NVMe drive). The drive must use a GPT partition table; legacy MBR is not supported. |
| RDMA (RoCEv2 on Ethernet, or InfiniBand) | Optional but recommended — this is the setup where MeshStor performs best (lowest latency, near-zero CPU on the data path). Auto-detected per node pair; NVMe-oF falls back to TCP when RDMA is unavailable. |
Kubernetes¶
MeshStor requires Kubernetes 1.30 or newer. The current tested version is 1.34.
Tested Linux distributions¶
These distributions have been exercised end-to-end (provisioning, replication, failure recovery, expansion).
| Distribution | Kernel | Status |
|---|---|---|
| RHEL / Rocky Linux / AlmaLinux 10.x | 6.12 | Tested |
| Ubuntu 24.04 LTS | HWE 6.17+ (linux-generic-hwe-24.04) |
Tested — the stock 6.8 GA kernel is not supported; install the HWE kernel before deploying MeshStor |
If you run MeshStor on a distribution from this list and encounter an issue, please file an issue against the repository.
Planned Linux distributions¶
On the roadmap¶
These distributions are planned for support and should land in a future release.
| Distribution | Expected kernel | Status |
|---|---|---|
| Ubuntu 26.04 LTS | 7.0+ | Planned |
Available to paid customers¶
These enterprise distributions are planned for paid customers only.
| Distribution | Status |
|---|---|
| OpenShift (RHCOS) | Planned |
| SUSE Linux Enterprise Server (SLES) | Planned |
| SLE Micro | Planned |
| Talos Linux | Planned |
Should work but unverified¶
These combinations meet the hardware and kernel requirements above and should work, but have not been explicitly tested.
| Kubernetes | Linux distro | Kernel | Status |
|---|---|---|---|
| 1.30+ | Any modern distro | 6.12+ | Untested |
If you run MeshStor on a combination from this table, please file an issue with the result so we can move it into the Tested table or document any incompatibilities.
Known incompatibilities¶
| Combination | Impact |
|---|---|
| Pre-6.11 kernels on NVMe-oF + MD RAID | Data corruption. The LP#2075110 bug affects the exact topology MeshStor uses. RHEL / Rocky Linux / AlmaLinux 10.x, Ubuntu 24.04 and 26.04 have the fix backported. |
If you encounter an additional combination that does not work, please file an issue.
What's Next¶
- Prerequisites — the deployment checklist
- Installation — the deployment procedure
- Project Status — the broader maturity context