k3sm

Releases

What shipped in each k3sm release, the pinned install one-liner, and a link to the full GitHub release notes for each.


k3sm releases from GitHub Releases on the k3sm repository. Every row below is a published release, with what shipped, the date, the pinned install command, and links to its release notes, tarball, checksums and, from v0.2.2 on, the app’s disk image.

versiondatehighlightsinstallassets
v0.2.32026-10-29
  • Gzip-compressed build layers.
  • No 60-second cut on large layer transfers.
  • A faster k3sm image ls and a streaming Images tab.
  • helm v4.3.1.
curl -fsSL https://k3sm.io/install.sh | K3SM_INSTALL_VERSION=v0.2.3 sh
sha256d2310e29b32ee306770ec9fbe09a17ae9f92fc396dcc8e518b7fd1dbb9c15bab
v0.2.22026-10-28
  • One image store.
  • Managed updates.
  • sudo k3sm stop, start and restart.
  • k3sm status top.
see 7 more
  • kubectl top works.
  • LoadBalancer Services are hosted on every node
  • sudo k3sm network lan on|off.
  • k3sm build ls, cancel, rm, logs and prune
  • Scheduled etcd snapshots and restore on HA servers
  • The macOS app installs and updates through k3sm install --from-staging
  • k3sm status gains dns, services, heartbeat and kubeconfig rows, reads what your account can without sudo, reports joined workers and the join target in JSON, and streams NDJSON with --watch -o json.
curl -fsSL https://k3sm.io/install.sh | K3SM_INSTALL_VERSION=v0.2.2 sh
sha2565e06d2bfe7a797260b88e0a65576fa9ca9368dbefde17219915fe06724132fdf
v0.1.72026-10-05
  • vm Pods answer on their pod IP from every node.
curl -fsSL https://k3sm.io/install.sh | K3SM_INSTALL_VERSION=v0.1.7 sh
sha2563daf51604abb0bf7611f1d78e7c4330cd5ddf0ff197557e23cca91d299aa24c3
v0.1.62026-10-05
  • A defence against the host kernel panic seen on the pod network.
  • Shell tools see mounted paths.
  • curl and TLS clients work in native Pods.
  • Node identity under the Node authorizer.
see 18 more
  • Node-pressure eviction.
  • k3sm install --data-volume.
  • k3sm datavol mount|status|delete.
  • k3sm status reports the data volume and more.
  • Container logs on disk.
  • A resident shim keeps container output and exit status.
  • Pods survive a node-daemon restart.
  • Image pull failures read like the kubelet’s.
  • Per-container stop and ephemeral containers.
  • Projected volumes refresh.
  • Helm charts.
  • Operator manifests.
  • Secrets encryption at rest.
  • sudo k3sm uninstall --purge --yes.
  • Worker lifecycle.
  • Ingress, load balancers and service policy.
  • MLX scheduling.
  • Faster proxy paths.
curl -fsSL https://k3sm.io/install.sh | K3SM_INSTALL_VERSION=v0.1.6 sh
sha256ac0dcc22bf267ac59a450f1c1ff229bd8473dfff63dc502d4b97615f98a7dfd8

Older releases stay installable the same way and are listed on prior releases.

The unpinned install script (curl -fsSL https://k3sm.io/install.sh | sh) resolves the newest stable release here, skipping any row marked pre-release. Set K3SM_INSTALL_VERSION to the version column to pin an older release instead. See install for every channel and upgrades for moving between them.

Verifying a Download by Hand#

The install script already verifies the sha256 before it runs anything. To check a downloaded tarball yourself:

shasum -a 256 k3sm_<version>_darwin_arm64.tar.gz

Compare the output against the sha256 in the assets column above (open the “sha256” disclosure), or against the checksums file linked there, which is the same file the script checks against. The same file has a line for the disk image; download shows that check.