Skip to main content


Upgrade Notice

Before upgrading from earlier releases, be sure to read the Kubernetes Urgent Upgrade Notes.

VersionRelease dateKubernetesKineSQLiteEtcdContainerdRuncFlannelMetrics-serverTraefikCoreDNSHelm-controllerLocal-path-provisioner
v1.27.6+k3s1Sep 20 2023v1.27.6v0.
v1.27.5+k3s1Sep 05 2023v1.27.5v0.
v1.27.4+k3s1Jul 27 2023v1.27.4v0.
v1.27.3+k3s1Jun 26 2023v1.27.3v0.
v1.27.2+k3s1May 26 2023v1.27.2v0.
v1.27.1+k3s1Apr 27 2023v1.27.1v0.

Release v1.27.6+k3s1

This release updates Kubernetes to v1.27.6, and fixes a number of issues.

For more details on what's new, see the Kubernetes release notes.

Changes since v1.27.5+k3s1:

  • Bump kine to v0.10.3 (#8324)
  • Update to v1.27.6 and Go to 1.20.8 (#8356)
    • Bump embedded containerd to v1.7.6
    • Bump embedded stargz-snapshotter plugin to latest
    • Fixed intermittent drone CI failures due to race conditions in test environment setup scripts
    • Fixed CI failures due to changes to api discovery changes in Kubernetes 1.28

Release v1.27.5+k3s1

This release updates Kubernetes to v1.27.5, and fixes a number of issues.


This release includes support for remediating CVE-2023-32187, a potential Denial of Service attack vector on K3s servers. See for more information, including mandatory steps necessary to harden clusters against this vulnerability.

For more details on what's new, see the Kubernetes release notes.

Changes since v1.27.4+k3s1:

  • Update cni plugins version to v1.3.0 (#8056)
    • Upgraded cni-plugins to v1.3.0
  • Update flannel to v0.22.1 (#8057)
    • Update flannel to v0.22.1
  • ADR on secrets encryption v3 (#7938)
  • Unit test for MustFindString (#8013)
  • Add support for using base template in etc/containerd/config.toml.tmpl (#7991)
    • User-provided containerd config templates may now use {{ template "base" . }} to include the default K3s template content. This makes it easier to maintain user configuration if the only need is to add additional sections to the file.
  • Make apiserver egress args conditional on egress-selector-mode (#7972)
    • K3s no longer enables the apiserver's enable-aggregator-routing flag when the egress proxy is not being used to route connections to in-cluster endpoints.
  • Security bump to docker/distribution (#8047)
  • Fix coreos multiple installs (#8083)
  • Update stable channel to v1.27.4+k3s1 (#8067)
  • Fix tailscale bug with ip modes (#8077)
  • Consolidate CopyFile functions (#8079)
  • E2E: Support GOCOVER for more tests + fixes (#8080)
  • Fix typo in terraform/ (#8090)
  • Add FilterCN function to prevent SAN Stuffing (#8085)
    • K3s's external apiserver listener now declines to add to its certificate any subject names not associated with the kubernetes apiserver service, server nodes, or values of the --tls-san option. This prevents the certificate's SAN list from being filled with unwanted entries.
  • Bump docker/docker to master commit; cri-dockerd to 0.3.4 (#8092)
    • Bump docker/docker module version to fix issues with cri-dockerd caused by recent releases of golang rejecting invalid host headers sent by the docker client.
  • Bump versions for etcd, containerd, runc (#8109)
    • Updated the embedded containerd to v1.7.3+k3s1
    • Updated the embedded runc to v1.1.8
    • Updated the embedded etcd to v3.5.9+k3s1
  • Etcd snapshots retention when node name changes (#8099)
  • Bump kine to v0.10.2 (#8125)
    • Updated kine to v0.10.2
  • Remove terraform package (#8136)
  • Fix etcd-snapshot delete when etcd-s3 is true (#8110)
  • Add --disable-cloud-controller and --disable-kube-proxy test (#8018)
  • Use go list -m instead of grep to look up versions (#8138)
  • Use VERSION_K8S in tests instead of grep go.mod (#8147)
  • Fix for Kubeflag Integration test (#8154)
  • Fix for cluster-reset backup from s3 when etcd snapshots are disabled (#8155)
  • Run integration test CI in parallel (#8156)
  • Bump Trivy version (#8150)
  • Bump Trivy version (#8178)
  • Fixed the etcd retention to delete orphaned snapshots based on the date (#8177)
  • Bump dynamiclistener (#8193)
    • Bumped dynamiclistener to address an issue that could cause the apiserver/supervisor listener on 6443 to stop serving requests on etcd-only nodes.
    • The K3s external apiserver/supervisor listener on 6443 now sends a complete certificate chain in the TLS handshake.
  • Bump helm-controller/klipper-helm versions (#8204)
    • The version of helm used by the bundled helm controller's job image has been updated to v3.12.3
  • E2E: Add test for k3s token (#8184)
  • Move flannel to 0.22.2 (#8219)
    • Move flannel to v0.22.2
  • Update to v1.27.5 (#8236)
  • Add new CLI flag to enable TLS SAN CN filtering (#8257)
    • Added a new --tls-san-security option. This flag defaults to false, but can be set to true to disable automatically adding SANs to the server's TLS certificate to satisfy any hostname requested by a client.
  • Add RWMutex to address controller (#8273)

Release v1.27.4+k3s1

This release updates Kubernetes to v1.27.4, and fixes a number of issues.
​ For more details on what's new, see the Kubernetes release notes. ​

Changes since v1.27.3+k3s1:

  • Pkg imported more than once (#7803)
  • Faster K3s Binary Build Option (#7805)
  • Update stable channel to v1.27.3+k3s1 (#7827)
  • Adding cli to custom klipper helm image (#7682)
    • The default helm-controller job image can now be overridden with the --helm-job-image CLI flag
  • Check if we are on ipv4, ipv6 or dualStack when doing tailscale (#7838)
  • Remove file_windows.go (#7845)
  • Add a k3s data directory location specified by the cli (#7791)
  • Fix e2e startup flaky test (#7839)
  • Allow k3s to customize apiServerPort on helm-controller (#7834)
  • Fall back to basic/bearer auth when node identity auth is rejected (#7836)
    • Resolved an issue that caused agents joined with kubeadm-style bootstrap tokens to fail to rejoin the cluster when their node object is deleted.
  • Fix code spell check (#7858)
  • Add e2e s3 test (#7833)
  • Warn that v1.28 will deprecate reencrypt/prepare (#7848)
  • Support setting control server URL for Tailscale (#7807)
    • Support connecting tailscale to a separate server (e.g. headscale)
  • Improve for K3s release Docs (#7864)
  • Fix rootless node password location (#7887)
  • Bump from 1.51.0 to 1.53.0 in /tests/terraform (#7879)
  • Add retry for clone step (#7862)
  • Generation of certificates and keys for etcd gated if etcd is disabled. (#6998)
  • Don't use zgrep in check-config if apparmor porfile is enforced (#7939)
  • Fix script and download trivy version (#7950)
  • Revert "Warn that v1.28 will deprecate reencrypt/prepare" (#7977)
  • Adjust default kubeconfig file permissions (#7978)
  • Fix update go version command on release documentation (#8028)
  • Update to v1.27.4 (#8014)

Release v1.27.3+k3s1

This release updates Kubernetes to v1.27.3, and fixes a number of issues.

For more details on what's new, see the Kubernetes release notes.

Changes since v1.27.2+k3s1:

  • Update flannel version (#7628)
    • Update flannel to v0.22.0
  • Add el9 selinux rpm (#7635)
  • Update channels (#7634)
  • Allow coredns override extensions (#7583)
    • The coredns-custom ConfigMap now allows for *.override sections to be included in the .:53 default server block.
  • Bump klipper-lb to v0.4.4 (#7617)
    • Bumped klipper-lb image to v0.4.4 to resolve an issue that prevented access to ServiceLB ports from localhost when the Service ExternalTrafficPolicy was set to Local.
  • Bump metrics-server to v0.6.3 and update tls-cipher-suites (#7564)
    • The bundled metrics-server has been bumped to v0.6.3, and now uses only secure TLS ciphers by default.
  • Do not use the admin kubeconfig for the supervisor and core controllers (#7616)
    • The K3s core controllers (supervisor, deploy, and helm) no longer use the admin kubeconfig. This makes it easier to determine from access and audit logs which actions are performed by the system, and which are performed by an administrative user.
  • Bump golang:alpine image version (#7619)
  • Make LB image configurable when compiling k3s (#7626)
  • Bump vagrant libvirt with fix for plugin installs (#7605)
  • Add format command on Makefile (#7437)
  • Use el8 rpm for fedora 38 and 39 (#7664)
  • Check variant before version to decide rpm target and packager closes #7666 (#7667)
  • Test Coverage Reports for E2E tests (#7526)
  • Soft-fail on node password verification if the secret cannot be created (#7655)
    • K3s now allows nodes to join the cluster even if the node password secret cannot be created at the time the node joins. The secret create will be retried in the background. This resolves a potential deadlock created by fail-closed validating webhooks that block secret creation, where the webhook is unavailable until new nodes join the cluster to run the webhook pod.
  • Enable containerd aufs/devmapper/zfs snapshotter plugins (#7661)
    • The bundled containerd's aufs/devmapper/zfs snapshotter plugins have been restored. These were unintentionally omitted when moving containerd back into the k3s multicall binary in the previous release.
  • Bump docker go.mod (#7681)
  • Shortcircuit commands with version or help flags (#7683)
    • Non root users can now call k3s --help and k3s --version commands without running into permission errors over the default config file.
  • Bump Trivy version (#7672)
  • E2E: Capture coverage of K3s subcommands (#7686)
  • Integrate tailscale into k3s (#7352)
    • Integration of tailscale VPN into k3s
  • Add private registry e2e test (#7653)
  • E2E: Remove unnecessary daemonset addition/deletion (#7696)
  • Add issue template for OS validation (#7695)
  • Fix spelling check (#7740)
  • Remove useless libvirt config (#7745)
  • Bump helm-controller to v0.15.0 for create-namespace support (#7716)
    • The embedded helm controller has been bumped to v0.15.0, and now supports creating the chart's target namespace if it does not exist.
  • Fix error logging in tailscale (#7776)
  • Add commands to remove advertised routes of tailscale in (#7777)
  • Update Kubernetes to v1.27.3 (#7790)

Release v1.27.2+k3s1

This release updates Kubernetes to v1.27.2, and fixes a number of issues.

For more details on what's new, see the Kubernetes release notes.

Changes since v1.27.1+k3s1:

  • Ensure that klog verbosity is set to the same level as logrus (#7303)
  • Create CRDs with schema (#7308)
    • Fixed an issue where Addon, HelmChart, and HelmChartConfig CRDs were created without structural schema, allowing the creation of custom resources of these types with invalid content.
  • Bump k3s-root for aarch64 page size fix (#7364)
    • K3s once again supports aarch64 nodes with page size > 4k
  • Bump Runc and Containerd (#7339)
  • Add integration tests for etc-snapshot server flags and refactor /tests/integration/integration.go/K3sStartServer (#7300)
  • Bump traefik to v2.9.10 / chart 21.2.0 (#7324)
    • The packaged Traefik version has been bumped to v2.9.10 / chart 21.2.0
  • Add longhorn storage test (#6445)
  • Improve error message when CLI wrapper Exec fails (#7373)
    • K3s now prints a more meaningful error when attempting to run from a filesystem mounted noexec.
  • Fix issues with --disable-agent and --egress-selector-mode=pod|cluster (#7331)
    • Servers started with the (experimental) --disable-agent flag no longer attempt to run the tunnel authorizer agent component.
    • Fixed an regression that prevented the pod and cluster egress-selector modes from working properly.
  • Retry cluster join on "too many learners" error (#7351)
    • K3s now retries the cluster join operation when receiving a "too many learners" error from etcd. This most frequently occurred when attempting to add multiple servers at the same time.
  • Fix MemberList error handling and incorrect etcd-arg passthrough (#7371)
    • K3s now correctly passes through etcd-args to the temporary etcd that is used to extract cluster bootstrap data when restarting managed etcd nodes.
    • K3s now properly handles errors obtaining the current etcd cluster member list when a new server is joining the managed etcd cluster.
  • Bump Trivy version (#7383)
  • Handle multiple arguments with StringSlice flags (#7380)
  • Add v1.27 channel (#7387)
  • Enable FindString to search dotD config files (#7323)
  • Migrate netutil methods into /util/net.go (#7422)
  • Local-storage: Fix permission (#7217)
  • Bump cni plugins to v1.2.0-k3s1 (#7425)
    • The bundled CNI plugins have been upgraded to v1.2.0-k3s1. The bandwidth and firewall plugins are now included in the bundle.
  • Add dependabot label and reviewer (#7423)
  • E2E: Startup test cleanup + RunCommand Enhancement (#7388)
  • Fail to validate server tokens that use bootstrap id/secret format (#7389)
    • K3s now exits with a proper error message when the server token uses a bootstrap token id.secret format.
  • Fix token startup test (#7442)
  • Bump kine to v0.10.1 (#7414)
    • The embedded kine version has been bumped to v0.10.1. This replaces the legacy lib/pq postgres driver with pgx.
  • Add kube-* server flags integration tests (#7416)
  • Add support for -cover + integration test code coverage (#7415)
  • Bump kube-router version to fix a bug when a port name is used (#7454)
  • Consistently use constant-time comparison of password hashes instead of bare password strings (#7455)
  • Bump containerd to v1.7.0 and move back into multicall binary (#7418)
    • The embedded containerd version has been bumped to v1.7.0-k3s1, and has been reintegrated into the main k3s binary for a significant savings in release artifact size.
  • Adding PITS and Getdeck Beiboot as adopters thanks to Schille and Miw… (#7524)
  • Bump helm-controller version for repo auth/ca support (#7525)
    • The embedded Helm controller now supports authenticating to chart repositories via credentials stored in a Secret, as well as passing repo CAs via ConfigMap.
  • Bump containerd/runc to v1.7.1-k3s1/v1.1.7 (#7533)
    • The bundled containerd and runc versions have been bumped to v1.7.1-k3s1/v1.1.7
  • Wrap error stating that it is coming from netpol (#7539)
  • Add Rotation certification Check, remove func to restart agents (#7097)
  • Bump alpine from 3.17 to 3.18 in /package (#7550)
  • Bump alpine from 3.17 to 3.18 in /conformance (#7551)
  • Add '-all' flag to apply to inactive systemd units (#7567)
  • Update to v1.27.2-k3s1 (#7575)
  • Fix iptables rules clean during upgrade (#7591)
  • Pin emicklei/go-restful to v3.9.0 (#7597)
  • Add el9 selinux rpm (#7443)
  • Revert "Add el9 selinux rpm (#7443)" (#7608)

Release v1.27.1+k3s1

This release is K3S's first in the v1.27 line. This release updates Kubernetes to v1.27.1.

Before upgrading from earlier releases, be sure to read the Kubernetes Urgent Upgrade Notes.

Changes since v1.26.4+k3s1:

  • Kubernetes 1.27.1 (#7271)
  • V1.27.1 CLI Deprecation (#7311)
    • --flannel-backed=wireguard has been completely replaced with --flannel-backend=wireguard-native
    • The k3s etcd-snapshot command will now print a help message, to save a snapshot use: k3s etcd-snapshot save
    • The following flags will now cause fatal errors (with full removal coming in v1.28.0):
      • --flannel-backed=ipsec: replaced with --flannel-backend=wireguard-native see docs for more info.
      • Supplying multiple --flannel-backend values is no longer valid. Use --flannel-conf instead.
  • Changed command -v redirection for iptables bin check (#7315)
  • Update channel server for april 2023 (#7327)
  • Bump cri-dockerd (#7347)
  • Cleanup help messages (#7369)