NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #391 by repository stars
Latest stable
v0.28.11
Last release 2 days ago
19 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
225 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
A short summary of some key commits:
A short summary of some key commits:
905c5d6b fix deleteLease 477d9fa1 Use publicIP lookup iface if --public-ip indicated 251ecdb3 kubernetes 1.16 cni error 701c2e87 Add cniVersion to general CNI plugin configuration. cdcef373 Needs to clear NodeNetworkUnavailable flag on Kubernetes 1d43a1ef Replaces gorillalabs go-powershell with bhendo/go-powershell 3e31d3b8 Make VXLAN device learning attribute configurable ac54a74d change nodeSelector to nodeAffinity and schedule the pod to linux node 0106d234 This PR adds the cni version to the cni-conf.yaml inside the kube-flannel-cfg configmap 5c7091b4 EnableNonPersistent flag for Windows Overlay networks 9d18981a snap package. 90764d23 Update lease with DR Mac aac870ee main.go: add the "net-config-path" flag 219cb896 Deploy Flannel with unprivileged PSP fc9cdb10 Enable local host to local pod connectivity in Windows VXLAN 403cffd8 Update hcsshim for HostRoute policy in Windows VXLAN
Nothing published for this version
This release of flannel contains exciting new support for Windows (host-gw and vxlan), an enviable IPSec backend and some conformance and stability ch
This release of flannel contains exciting new support for Windows (host-gw and vxlan), an enviable IPSec backend and some conformance and stability changes.
A short summary of some key commits: #1078 Get HNS networks using V2 schema (thanks @ksubrmnn) #1061 Remote subnet feature (thanks @ksubrmnn) #1042 Windows "host-gw" & "vxlan" support (thanks @thxCode) #997 Allow changing subnet/kube annotation prefix (thanks @kopiczko) #1045 Do not define keys for tolerations (thanks @outcoldman) #1016 Use latest Go version (thanks @tomdee) #978 Make the iptables FORWARD chain rules optional (thanks @KashifSaadat) #949 Add link to flannel-node-annotator (thanks @alvaroaleman) #987 add recycling for old iptables rules (thanks @mainred) #1000 subnet: handle unknown state in delete event (thanks @ggaaooppeenngg) #989 Documentation/k8s: add daemonsets for all archs (thanks @lentzi90) #1005 Update kube-flannel-rbac.yml (thanks @somashekhar) #940 Log all the available interfaces when none were found (thanks @dmathieu) #941 backend/udp: Use a /32 prefix for the flannel0 interface (thanks @celskeggs) #935 Added new flag -iptables-resync (thanks @SleepyBrett) #930 translate alicloud-vpc-backend.md (thanks @DiamondYuan) #929 Add IPSec backend (thanks @tomdee)
This release of flannel contains many new features and improvements. Highlights include
This release of flannel contains many new features and improvements. Highlights include
.conflist which allows multiple plugins to be chained. If you are upgrading flannel by just applying the new manifest, then kubernetes will continue to use the old .conf instead of the new .conflist until you manually delete the .conf file. See discussion in https://github.com/coreos/flannel/pull/855#issuecomment-349520067 for more details.#842 Add new ipip backend (thanks @chenchun)
#898 backend/extension: Add Wireguard configuration (thanks @tomdee)
#859 Makefile: Stop building ACIs (thanks @tomdee) #860 Makefile: Cleanup, alpine and amd64 only UDP (thanks @tomdee) #863 MAINTAINER is deprecated, using LABEL now (thanks @cglewis)
#911 flannel: Get flannel running on windows (thanks @tomdee) #879 backend: Get flannel building on windows with stubs (thanks @jroggeman) #903 Fix to build/release windows binaries from Linux (thanks @madhanrm) #854 network: move ipmasq management into platform-specific files (thanks @jroggeman)
This changes could cause problems when using very small subnets. #896 subnet/config.go: Fix handling of subnet config (thanks @tomdee) #894 subnet/config.go: Ensure that Subnets are aligned (thanks @tomdee)
#855 make sure flanneld got QoS class "Guaranteed" to have lower oom_score_adj (thanks @Dieken) #888 Add portmap plugin to CNI conf (thanks @osoriano) #884 Documentation/Manifests: Improve YMLs. (thanks @Gacko) #849 kube-flannel-cfg: enable hairpin mode (thanks @Dieken) #910 Correct Spelling ClusterRoleBinding (thanks @abhaydiwan)
#843 Remove unexpected route from route list (thanks @chenchun) #840 Fix #712, allow overwriting the public IP of a Kubernetes node (thanks @alvaroaleman) #897 backend/vxlan: Return correct MTU value (thanks @tomdee)
#845 Add support for multiarch e2e tests (thanks @mkumatag) #816 Improve functional tests (thanks @tomdee) #850 Fix TTY error while running e2e tests in container (thanks @mkumatag) #876 Fix e2e tests for non-amd64 archs (thanks @mkumatag) #861 Remove leftover containers (thanks @mkumatag) #858 travis: Only run the tests once (thanks @tomdee)
#827 Fix printf verb %s of wrong type (thanks @sakeven) #893 subnet/etcdv2/local_manager.go: Fix startup log (thanks @tomdee) #873 Log kubernetes public ip override (thanks @alvaroaleman) #828 Fix error message in ipmasq (thanks @sakeven)
#912 automated PR: update CoC (thanks @ericchiang) #907 fixes typo (thanks @karthequian) #857 README.md: fix link to kubernetes documentation (thanks @ysim) #856 Comment out the PR template message and add release note section (thanks @gunjan5) #880 [DOC] Clarify GCE route quota is only 100 by default (thanks @yuvipanda) #868 fix typo (thanks @vissible) #839 All lowercase filename (thanks @athai)
This release of flannel contains a single fix (https://github.com/coreos/flannel/pull/872) to improve compatibility with newer versions of Docker.
This release of flannel contains a single fix (https://github.com/coreos/flannel/pull/872) to improve compatibility with newer versions of Docker.
Install on kubernetes
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.9.1/Documentation/kube-flannel.ymlThe Docker image can be downloaded from quay.io
Please provide feedback through one of the following channels:
This release of flannel brings some significant improvements to the vxlan backend.
This release of flannel brings some significant improvements to the vxlan backend.
It also adds a retry mechanism to the --ip-masq feature to ensure that iptables rules are correct.
There are a number of other important bug fixes and improvements. See the complete list below.
Install on kubernetes
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.9.0/Documentation/kube-flannel.ymlThe Docker image can be downloaded from quay.io
Please provide feedback through one of the following channels:
The complete list of PRs in this release #808 Always ensure iptables masquerade rules are installed (thanks @julia-stripe) #817 Makefile: Stop pulling the unused lib from kube-cross #809 subnet/*: Remove unused reservations code #811 Remove Library copy commands from dockefiles (thanks @mkumatag) #807 backend/hostgw: Improve robustness, add logging and comments #787 backend/vxlan: Add support for "direct routing" #803 Fix route deletion when replacing route in hostgw backend (thanks @julia-stripe) #800 Add flag validation for subnet-lease-renew-margin (thanks @ruoshan) #785 backend/vxlan: simplify vxlan processing #791 add ca-certificates (thanks @oilbeater) #789 Remove broken reference (thanks @athai) #777 main.go: Remove sleep during shutdown #776 Remove RevokeLease from manager interface #778 Remove wait() from backendmanager. Nothing calls it
This pre release of flannel brings some significant improvements to the vxlan backend.
This pre release of flannel brings some significant improvements to the vxlan backend.
There are a number of other important bug fixes and improvements. See the complete list below.
Install on kubernetes
Download and edit the file at https://raw.githubusercontent.com/coreos/flannel/v0.9.0-rc1/Documentation/kube-flannel.yml to reference the correct release version.
If you're using RBAC (e.g. if you're using kubeadm) then also apply the RBAC file
The Docker image can be downloaded from quay.io
Please provide feedback through one of the following channels:
The complete list of PRs in this release #817 Makefile: Stop pulling the unused lib from kube-cross #809 subnet/*: Remove unused reservations code #811 Remove Library copy commands from dockefiles (thanks @mkumatag) #807 backend/hostgw: Improve robustness, add logging and comments #787 backend/vxlan: Add support for "direct routing" #803 Fix route deletion when replacing route in hostgw backend (thanks @julia-stripe) #800 Add flag validation for subnet-lease-renew-margin (thanks @ruoshan) #785 backend/vxlan: simplify vxlan processing #791 add ca-certificates (thanks @oilbeater) #789 Remove broken reference (thanks @athai) #777 main.go: Remove sleep during shutdown #776 Remove RevokeLease from manager interface #778 Remove wait() from backendmanager. Nothing calls it
Nothing published for this version
Nothing published for this version
This release of flannel brings many new features and improvements. There are some pretty big changes in this release
This release of flannel brings many new features and improvements. There are some pretty big changes in this release
Install on kubernetes
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.8.0/Documentation/kube-flannel.ymlIf you're using RBAC (e.g. if you're using kubeadm) then also apply the RBAC file
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/v0.8.0/Documentation/kube-flannel-rbac.ymlThe Docker image can be downloaded from quay.io
Please provide feedback through one of the following channels:
The following PRs are in this release:
#701 backend/extension: Introduce new extension backend #717 aws-vpc: add support for multiple route tables #571 Add ali cloud VPC network support #754 Added iface-regex option #752 flannel reads from created subnet.env file on startup #722 add healthz
#633 Remove the experimental support for multiple networks. #606 remote: Remove experimental remote support
#675 subnet/etcdv2: Fix panic from bad error contruction #693 Keep route: [ 0.0.0.0/0 via ECS instance ] to work with alicloud DNAT… #745 Add iptables rule to prevent masquerade on some external traffic #750 Added compatibility check to compare GBP for VXLAN
#714 docs: adding CNI plugin note. #715 docs: adding pointer to reservations.md. #713 docs: adding MTU note. #679 flannel-docs: Updating flannel Documents files. #682 Flannel ReadMe: Added Tom's notes. #700 Add templates for PRs/Issues #707 Fixes typo #702 bill-of-materials: initial commit #656 Documentation: Split README into multiple files #625 added production users and integrations pages #622 Typo corrected in README.md
#703 network order functionality changed based on endianess #686 update the LIB_DIR for s390x #650 Build tar.gz for ppc64le, arm and arm64 arch #547 Modifying pkg/ip/ipnet.go to fix endian problem
#689 Add iptables binaries #690 Update kube-flannel.yml to use 0.7.1 flannel image #687 vendor: remove files not needed for building #684 Makefile: add libpthread* to make clean #669 Makefile: Fix the releases target #662 Makefile: Use $(CURDIR) #597 vendor: Revendor with more sensible pinnings #645 functional-test: Add a simple bandwidth test #658 Fix various little problems found by gometalinter #629 Backends: Remove Run() from interface as it's not used #697 main.go: Remove a reference to client/server mode #631 subnet: Move etcd files into their own package. #594 README: Update build instructions #575 backend/vxlan: Make variables more verbose #744 Makefile: Smaller flanneld binary
#665 Explicit operator: Exists to allow toleration on masters #652 kube-flannel: Add namespace for compatibility with RBAC rules #618 Tolerate flannel running on master nodes #614 Simplify rbac creation process #593 Documentation: Update releases to v0.7.0 #591 Add Kubernetes RBAC support #600 [doc][kube-flannel] set explicit arch on daemonset images #729 Allow more events to be buffered before the backend starts
Nothing published for this version
Nothing published for this version
This is an early release candidate for the upcoming flannel v0.8.0 release with the goal of getting community feedback from the new (and removed) feat
This is an early release candidate for the upcoming flannel v0.8.0 release with the goal of getting community feedback from the new (and removed) features.
Please provide feedback through one of the following channels:
The following PRs are in this release:
#701 backend/extension: Introduce new extension backend #717 aws-vpc: add support for multiple route tables #571 Add ali cloud VPC network support
#633 Remove the experimental support for multiple networks. #606 remote: Remove experimental remote support
#675 subnet/etcdv2: Fix panic from bad error contruction #693 Keep route: [ 0.0.0.0/0 via ECS instance ] to work with alicloud DNAT…
#714 docs: adding CNI plugin note. #715 docs: adding pointer to reservations.md. #713 docs: adding MTU note. #679 flannel-docs: Updating flannel Documents files. #682 Flannel ReadMe: Added Tom's notes. #700 Add templates for PRs/Issues #707 Fixes typo #702 bill-of-materials: initial commit #656 Documentation: Split README into multiple files #625 added production users and integrations pages #622 Typo corrected in README.md
#703 network order functionality changed based on endianess #686 update the LIB_DIR for s390x #650 Build tar.gz for ppc64le, arm and arm64 arch #547 Modifying pkg/ip/ipnet.go to fix endian problem
#689 Add iptables binaries #690 Update kube-flannel.yml to use 0.7.1 flannel image #687 vendor: remove files not needed for building #684 Makefile: add libpthread* to make clean #669 Makefile: Fix the releases target #662 Makefile: Use $(CURDIR) #597 vendor: Revendor with more sensible pinnings #645 functional-test: Add a simple bandwidth test #658 Fix various little problems found by gometalinter #629 Backends: Remove Run() from interface as it's not used #697 main.go: Remove a reference to client/server mode #631 subnet: Move etcd files into their own package. #594 README: Update build instructions #575 backend/vxlan: Make variables more verbose
#665 Explicit operator: Exists to allow toleration on masters #652 kube-flannel: Add namespace for compatibility with RBAC rules #618 Tolerate flannel running on master nodes #614 Simplify rbac creation process #593 Documentation: Update releases to v0.7.0 #591 Add Kubernetes RBAC support #600 [doc][kube-flannel] set explicit arch on daemonset images
This is primarily a bug fix release which has the following key fixes and improvements.
This is primarily a bug fix release which has the following key fixes and improvements.
Nothing published for this version
This release introduces a new experimental feature. The Kubernetes API server can now be used as a datastore instead of etcd. This makes deployment ea
This release introduces a new experimental feature. The Kubernetes API server can now be used as a datastore instead of etcd. This makes deployment easier as flannel no longer directly relies on the presence of an etcd server. To use it, pass the -kube-subnet-mgr option to the flannel daemon.
This release also contains a large number of merged PRs (thanks everyone for all your contributions, please keep them coming) and some other build, documentation and other minor improvements.
kubernetes API server as datastore #483 add a subnet manager backed by the kubernetes apiserver #564 Improve kube subnet lease handling #518 Fix the kube-flannel.yaml in order to work
AWS backend #540 AWS VPC backend fixes and cleanups #523 aws-vpc: Fix crash when route has vpc-endpoints #524 aws-vpc: remove "blackholes" #507 Update aws-vpc-backend.md
Key Bug fixes #522 Fixed #521: flanneld hang on at initialEvtsBatch := <-evts because of… #495 The docker daemon syntax change addressed #576: backend/vxlan: Set the netmask of the IP used for the vxlan device
Logging #565 network manager: Improve logging #555 vxlan logging verbosity #574: backend/vxlan: Improve the comments and logging
Testing #490 Add functional (end-to-end) testing #503 Run e2e tests on travis
This is a small point release that fixes a logging issue.
This is a small point release that fixes a logging issue.
For a complete list of changes https://github.com/coreos/flannel/compare/v0.6.1...v0.6.2
This is a small point release that adds the pthread library to the busybox-based deploy images.
This is a small point release that adds the pthread library to the busybox-based deploy images.
For a complete list of changes https://github.com/coreos/flannel/compare/v0.6.0...v0.6.1
This is the first release in a while so it's rolling up a large number of small improvements and bug fixes.
This is the first release in a while so it's rolling up a large number of small improvements and bug fixes.
v prefix so they match the reported version and git tag name.For a complete list of changes https://github.com/coreos/flannel/compare/v0.5.5...v0.6.0
NOTE: The deploy images for this version are broken - use version 0.6.1 instead
Nothing published for this version
Bug fix: out of memory crash when vxlan used with bonded interfaces.
While we're waiting for 0.6.0, this release picks few bug fixes and small improvements from master.
While we're waiting for 0.6.0, this release picks few bug fixes and small improvements from master.
This release brings bug fixes, a missing feature needed for CNI integration and internal improvements.
This release brings bug fixes, a missing feature needed for CNI integration and internal improvements.
New features:
FLANNEL_NETWORK will be printed to subnet.env with the CIDR value of the whole network. Makes CNI integration possible.Bug fixes:
-m options was not processedInternal improvements:
--public-ip allows specifying IP to publish in etcd. This helps with NAT traversal. Note that there's still no encryption so going across the WAN is r
New features:
Bug fixes:
aws-vpc -- flannel will disable Source/Dest IP check if granted ec2:ModifyInstanceAttribute permission. Thank, @MohdAhmad
GCE backend -- analogous to AWS-VPC backend, this manipulates the GCE routes to provide no-encapsulation data plane. Thank you, @MohdAhmad
New features:
Bug fixes and improvements:
host-gw backend: routes did not survive interface going down and up (e.g. cable unplug). Thank you, Huang.
Rohan Singh contributed aws-vpc backend (thanks, Rohan). It works by programming the VPC router to forward a subnet to the VM. It allows for eliminati
flannel will try to recreate VXLAN device every second on startup. Allows for the interface that it's enslaving to come up after flannel (thank you, J
--ip-masq now works for all backends. Previously it was only working properly for UDP backend.
Nothing published for this version
Added VXLAN backend to move encapsulation into the kernel
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.