Skip to content

DOCS-2847: New operating systems for hosts #2521

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ctauchen merged 5 commits into from
Feb 13, 2026
Merged

DOCS-2847: New operating systems for hosts #2521

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d6329d5
Add new operating systems for host install
ctauchen Feb 12, 2026
cc19da5
Update non-cluster host docs section
danudey Feb 13, 2026
6789569
Update crawler tests
danudey Feb 13, 2026
4023610
Edits to noncluster install
ctauchen Feb 13, 2026
368732a
Fix debPkgUrl
danudey Feb 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion __tests__/crawler.test.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -200,7 +200,8 @@ test('Crawl the docs and execute tests', async () => {
'https://sysctl-explorer.net/net/ipv4/fib_multipath_hash_policy/',
'https://calico-docs.mcp.kapa.ai',
'https://docs.tigera.io/img/calico-logo-2026-badge.png',
'https://microk8s.io/docs/clustering' // TEMP
'http://www.w3.org/2000/svg', // Appears in SVG file 'xmlns', doesn't need checking
'https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html' // TEMP
];

const lc = linkChecker();
Expand Down
67 changes: 51 additions & 16 deletions calico-enterprise/getting-started/bare-metal/about.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@
description: Install Calico on non-cluster hosts and VMs
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Install Calico on non-cluster hosts and VMs

## Big picture
Expand Down Expand Up @@ -41,9 +44,19 @@

If $[prodname] is installed on a cluster, you already have a datastore.

- Non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx)

Ensure that your node OS includes the `ipset` and `conntrack` kernel dependencies.
- Node requirements for non-cluster hosts and VMs:
- x86-64 v3 microarchitecture.

Check failure on line 48 in calico-enterprise/getting-started/bare-metal/about.mdx

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'microarchitecture'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'microarchitecture'?", "location": {"path": "calico-enterprise/getting-started/bare-metal/about.mdx", "range": {"start": {"line": 48, "column": 15}}}, "severity": "ERROR"}
You can check this via the program interpreter on the node:
```bash
/lib64/ld-linux-x86-64.so.2 --help
```
If you see a line that says `x86-64-v3 (supported, searched)`, your processor supports the required microarchitecture.

Check failure on line 53 in calico-enterprise/getting-started/bare-metal/about.mdx

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'microarchitecture'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'microarchitecture'?", "location": {"path": "calico-enterprise/getting-started/bare-metal/about.mdx", "range": {"start": {"line": 53, "column": 105}}}, "severity": "ERROR"}
- The following host operating systems are supported:
- RHEL 8 and RHEL 9
- Ubuntu 22.04 and 24.04
- Debian 12 and Debian 13
- Your operating system includes the `ipset` and `conntrack` kernel dependencies.
- For everything else, your non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx)

## How to

Expand Down Expand Up @@ -91,21 +104,41 @@

### Set up your non-cluster host or VM

1. Configure the Calico Enterprise repository.

1. Download the Calico Enterprise repository to work with your Linux distro.

Check failure on line 107 in calico-enterprise/getting-started/bare-metal/about.mdx

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'distro'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'distro'?", "location": {"path": "calico-enterprise/getting-started/bare-metal/about.mdx", "range": {"start": {"line": 107, "column": 70}}}, "severity": "ERROR"}
<Tabs groupId="linux-distro">
<TabItem label="RHEL" value="rhel-0">
```bash
curl -sfL $[rpmsUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo
curl -sfL $[rhelPkgUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo
```

Only Red Hat Enterprise Linux 8 and 9 x86-64 operating systems are supported in this version of $[prodname].

</TabItem>
<TabItem label="Debian/Ubuntu" value="ubuntu-1">
1. Download the appropriate sources file for your operating system:
```bash
curl -fsSL -o calico-enterprise.sources $[debPkgUrl]/$(lsb_release -cs).sources
```
1. Copy the file into your apt sources directory:
```bash
sudo cp calico-enterprise.sources /etc/apt/sources.list.d/
```
1. Retrieve the updated package index:
```bash
sudo apt-get update
```
</TabItem>
</Tabs>
1. Install Calico node and fluent-bit log forwarder packages.

- Use `dnf` to install the `calico-node` and `calico-fluent-bit` packages:

```bash
dnf install calico-node calico-fluent-bit
```
<Tabs groupId="linux-distro">
<TabItem label="RHEL" value="rhel-0">
```bash
dnf install calico-node calico-fluent-bit
```
</TabItem>
<TabItem label="Debian/Ubuntu" value="ubuntu-1">
```bash
sudo apt install calico-node calico-fluent-bit
```
</TabItem>
</Tabs>

1. Copy the `kubeconfig` created in cluster setup step 2 to host folder `/etc/calico/kubeconfig`.

Expand All @@ -128,7 +161,9 @@
The LB must detect failures, redirect traffic to the passive cluster, and restore traffic to the active cluster once it is healthy.
Without a proper configuration, HA mode will not work as expected.

Your hosts or VMs are inherently HA-ready once you completed the setup steps. They automatically connect to the appropriate cluster.
Your hosts or VMs are inherently HA-ready once you completed the setup steps.
They automatically connect to the appropriate cluster.

To enable HA mode, system administrators must perform the following steps:

- Deploy and maintain both clusters: Provision and manage both the active and passive Kubernetes clusters.
Expand Down
3 changes: 2 additions & 1 deletion calico-enterprise/variables.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ const variables = {
openSourceVersion: releases[0].calico.minor_version.slice(1),
baseUrl: '/calico-enterprise/next',
filesUrl: 'https://downloads.tigera.io/ee/master',
rpmsUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5),
rhelPkgUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5),
debPkgUrl: 'https://downloads.tigera.io/ee/debs/' + releases[0].title.slice(0, 5),
tutorialFilesURL: 'https://docs.tigera.io/files',
tmpScriptsURL: 'https://docs.tigera.io/calico-enterprise/next',
windowsScriptsURL: 'https://raw.githubusercontent.com/kubernetes-sigs/sig-windows-tools/master/hostprocess',
Expand Down
68 changes: 52 additions & 16 deletions ...o-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@
description: Install Calico on non-cluster hosts and VMs
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Install Calico on non-cluster hosts and VMs

## Big picture
Expand Down Expand Up @@ -41,9 +44,19 @@

If $[prodname] is installed on a cluster, you already have a datastore.

- Non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx)

Ensure that your node OS includes the `ipset` and `conntrack` kernel dependencies.
- Node requirements for non-cluster hosts and VMs:
- x86-64 v3 microarchitecture.

Check failure on line 48 in calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'microarchitecture'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'microarchitecture'?", "location": {"path": "calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx", "range": {"start": {"line": 48, "column": 15}}}, "severity": "ERROR"}
You can check this via the program interpreter on the node:
```bash
/lib64/ld-linux-x86-64.so.2 --help
```
If you see a line that says `x86-64-v3 (supported, searched)`, your processor supports the required microarchitecture.

Check failure on line 53 in calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'microarchitecture'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'microarchitecture'?", "location": {"path": "calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx", "range": {"start": {"line": 53, "column": 105}}}, "severity": "ERROR"}
- The following host operating systems are supported:
- RHEL 8 and RHEL 9
- Ubuntu 22.04 and 24.04
- Debian 12 and Debian 13
- Your operating system includes the `ipset` and `conntrack` kernel dependencies.
- For everything else, your non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx)

## How to

Expand Down Expand Up @@ -91,21 +104,41 @@

### Set up your non-cluster host or VM

1. Configure the Calico Enterprise repository.

1. Download the Calico Enterprise repository to work with your Linux distro.

Check failure on line 107 in calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'distro'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'distro'?", "location": {"path": "calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx", "range": {"start": {"line": 107, "column": 70}}}, "severity": "ERROR"}
<Tabs groupId="linux-distro">
<TabItem label="RHEL" value="rhel-0">
```bash
curl -sfL $[rpmsUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo
curl -sfL $[rhelPkgUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo
```

Only Red Hat Enterprise Linux 8 and 9 x86-64 operating systems are supported in this version of $[prodname].

</TabItem>
<TabItem label="Debian/Ubuntu" value="ubuntu-1">
1. Download the appropriate sources file for your operating system:
```bash
curl -fsSL -o calico-enterprise.sources $[debPkgUrl]/$(lsb_release -cs).sources
```
1. Copy the file into your apt sources directory:
```bash
sudo cp calico-enterprise.sources /etc/apt/sources.list.d/
```
1. Retrieve the updated package index:
```bash
sudo apt-get update
```
</TabItem>
</Tabs>
1. Install Calico node and fluent-bit log forwarder packages.

- Use `dnf` to install the `calico-node` and `calico-fluent-bit` packages:

```bash
dnf install calico-node calico-fluent-bit
```
<Tabs groupId="linux-distro">
<TabItem label="RHEL" value="rhel-0">
```bash
dnf install calico-node calico-fluent-bit
```
</TabItem>
<TabItem label="Debian/Ubuntu" value="ubuntu-1">
```bash
sudo apt install calico-node calico-fluent-bit
```
</TabItem>
</Tabs>

1. Copy the `kubeconfig` created in cluster setup step 2 to host folder `/etc/calico/kubeconfig`.

Expand All @@ -128,7 +161,10 @@
The LB must detect failures, redirect traffic to the passive cluster, and restore traffic to the active cluster once it is healthy.
Without a proper configuration, HA mode will not work as expected.

Your hosts or VMs are inherently HA-ready once you completed the setup steps. They automatically connect to the appropriate cluster.

Your hosts or VMs are inherently HA-ready once you completed the setup steps.
They automatically connect to the appropriate cluster.

To enable HA mode, system administrators must perform the following steps:

- Deploy and maintain both clusters: Provision and manage both the active and passive Kubernetes clusters.
Expand Down
3 changes: 2 additions & 1 deletion calico-enterprise_versioned_docs/version-3.23-1/variables.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ const variables = {
openSourceVersion: releases[0].calico.minor_version.slice(1),
baseUrl: '/calico-enterprise/3.23',
filesUrl: 'https://downloads.tigera.io/ee/v3.23.0-1.0',
rpmsUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5),
rhelPkgUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5),
debPkgUrl: 'https://downloads.tigera.io/ee/debs/' + releases[0].title.slice(0, 5),
tutorialFilesURL: 'https://docs.tigera.io/files',
tmpScriptsURL: 'https://docs.tigera.io/calico-enterprise/3.23',
windowsScriptsURL: 'https://raw.githubusercontent.com/kubernetes-sigs/sig-windows-tools/master/hostprocess',
Expand Down