Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
22 changes: 16 additions & 6 deletions content/en/docs/install/kubernetes/_index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Installing and Configuring Kubernetes Cluster on Talos Linux"
title: "Installing and Configuring Kubernetes Cluster"
linkTitle: "2. Install Kubernetes"
description: "Step 2: Installing and configuring a Kubernetes cluster on Talos Linux nodes, ready for Cozystack installation."
description: "Step 2: Installing and configuring a Kubernetes cluster ready for Cozystack installation."
weight: 20
aliases:
- /docs/operations/talos/configuration
Expand All @@ -10,24 +10,34 @@ aliases:
---


**The second step** in deploying a Cozystack cluster is to install and configure a Kubernetes cluster on Talos Linux nodes.
A prerequisite to this step is having [installed Talos Linux]({{% ref "/docs/install/talos" %}}).
**The second step** in deploying a Cozystack cluster is to install and configure a Kubernetes cluster.
The result is a Kubernetes cluster installed, configured, and ready to install Cozystack.

If this is your first time installing Cozystack, [start with the Cozystack tutorial]({{% ref "/docs/getting-started" %}}).

## Installation Options

### Talos Linux (Recommended)

For production deployments, Cozystack recommends [Talos Linux]({{% ref "/docs/guides/talos" %}}) as the underlying operating system.
A prerequisite to using these methods is having [installed Talos Linux]({{% ref "/docs/install/talos" %}}).

There are several methods to configure Talos nodes and bootstrap a Kubernetes cluster:

- **Recommended**: [using Talm]({{% ref "./talm" %}}), a declarative CLI tool, which has ready presets for Cozystack and uses the power of Talos API under the hood.
- [Using `talos-bootstrap`]({{% ref "./talos-bootstrap" %}}), an interactive script for bootstrapping Kubernetes clusters on Talos OS.
- [Using talosctl]({{% ref "./talosctl" %}}), a specialized command line tool for managing Talos.
- [Using talosctl]({{% ref "./talosctl" %}}), a specialized command-line tool for managing Talos.
- [Air-gapped installation]({{% ref "./air-gapped" %}}) is possible with Talm or talosctl.

### Generic Kubernetes

Cozystack can also be deployed on other Kubernetes distributions:

- [Generic Kubernetes]({{% ref "./generic" %}}) — deploy Cozystack on k3s, kubeadm, RKE2, or other distributions.

If you encounter problems with installation, refer to the [Troubleshooting section]({{% ref "./troubleshooting" %}}).

## Further Steps

- After installing and configuring Kubernetes on top of Talos Linux nodes, you will have a Kubernetes cluster ready to
- After installing and configuring a Kubernetes cluster, you will have it ready to
[install and configure Cozystack]({{% ref "/docs/install/cozystack" %}}).
Loading