System requirements for OpenStack

Node requirements

• x86-64, arm64, ppc64le, or s390x processor

• Calico must be able to manage tap* interfaces on the host.

• Linux kernel 5.10 or later with required dependencies. The following distributions have the required kernel, its dependencies, and are known to work well with Calico.
  • Ubuntu 20.04 or later
  • RHEL 8 or later

note

Many Linux distributions, such as most of the above, include NetworkManager. By default, NetworkManager does not allow Calico to manage interfaces. If your nodes have NetworkManager, complete the steps in Preventing NetworkManager from controlling Calico interfaces before installing Calico.

• If your Linux distribution comes with installed Firewalld or another iptables manager it should be disabled. These may interfere with rules added by Calico and result in unexpected behavior.

note

If a host firewall is needed, it can be configured by Calico HostEndpoint and GlobalNetworkPolicy. More information about configuration at Policy for hosts and VMs.

Key/value store

Calico requires a key/value store accessible by all Calico components. For production you will likely want multiple nodes for greater performance and reliability. If you don’t already have an etcdv3 cluster to connect to, please refer to the upstream etcd docs for detailed advice and setup.

Network requirements

Ensure that your hosts and firewalls allow the necessary traffic based on your configuration.

Configuration	Host(s)	Connection type	Port/protocol
Calico networking (BGP)	All	Bidirectional	TCP 179
Calico networking with IP-in-IP enabled (default)	All	Bidirectional	IP-in-IP, often represented by its protocol number 4
All	etcd hosts	Incoming	Officially TCP 2379 but can vary

* If your compute hosts connect directly and don’t use IP-in-IP, you don’t need to allow IP-in-IP traffic.

Privileges

Ensure that Calico has the CAP_SYS_ADMIN privilege.

The simplest way to provide the necessary privilege is to run Calico as root or in a privileged container.

OpenStack requirements

We recommend using OpenStack Caracal, and our active support and testing of Calico v3.33 with OpenStack is with Caracal.

Looking back, Calico should also work with any older OpenStack release that can be run under Python 3.

Looking forwards, Calico might work with a newer OpenStack release, but we don't know.

We generally update our recommended OpenStack version every fourth OpenStack release, and hence the next increment of support in our own coding and testing will be for OpenStack Gazpacho.

Kernel dependencies

tip

If you are using one of the recommended distributions, you will already satisfy these.

Due to the large number of distributions and kernel version out there, it’s hard to be precise about the names of the particular kernel modules that are required to run Calico. However, in general, you’ll need:

• The iptables modules (both the “legacy” and “nft” variants are supported). These are typically broken up into many small modules, one for each type of match criteria and one for each type of action. Calico requires:
  • The “base” modules (including the IPv6 versions if IPv6 is enabled in your cluster).
  • At least the following match criteria: set, rpfilter, addrtype, comment, conntrack, icmp, tcp, udp, ipvs, icmpv6 (if IPv6 is enabled in your kernel), mark, multiport, rpfilter, sctp, ipvs (if using kube-proxy in IPVS mode).
  • At least the following actions: REJECT, ACCEPT, DROP, LOG.
• IP sets support.
• Netfilter Conntrack support compiled in (with SCTP support if using SCTP).
• IPVS support if using kube-proxy in IPVS mode.
• IPIP, VXLAN, WireGuard support, if using Calico networking in one of those modes.
• eBPF (including the tc hook support) and XDP (if you want to use the eBPF data plane).