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
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/clickhouse.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/clickhouse.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/clickhouse/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/clickhouse/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/foundationdb.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ weight: 50
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/foundationdb.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/foundationdb/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/foundationdb/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/harbor.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 50
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/harbor.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/harbor/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/harbor/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/kafka.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/kafka.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/kafka/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/kafka/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/mariadb.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/mariadb.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/mariadb/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/mariadb/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/mongodb.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/mongodb.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/mongodb/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/mongodb/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/nats.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/nats.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/nats/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/nats/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/openbao.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 50
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/openbao.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/openbao/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/openbao/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/postgres.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/postgres.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/postgres/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/postgres/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/qdrant.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 50
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/qdrant.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/qdrant/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/qdrant/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/rabbitmq.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/rabbitmq.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/rabbitmq/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/rabbitmq/README.md
-->


Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/applications/redis.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/redis.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/redis/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/redis/README.md
-->


Expand Down
16 changes: 8 additions & 8 deletions content/en/docs/next/applications/tenant.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
<!--
Autogenerated content. Don't edit this file directly; edit sources instead.
metadata: https://github.com/cozystack/website/blob/main/content/en/docs/next/applications/_include/tenant.md
source: https://github.com/cozystack/cozystack/blob/release-1.2/packages/apps/tenant/README.md
source: https://github.com/cozystack/cozystack/blob/v1.3.0/packages/apps/tenant/README.md
-->


Expand All @@ -20,15 +20,15 @@ Tenants can be created recursively and are subject to the following rules:

### Tenant naming

Tenant names must follow DNS-1035 naming rules:
- Must start with a lowercase letter (`a-z`)
- Can only contain lowercase letters, numbers, and hyphens (`a-z`, `0-9`, `-`)
- Must end with a letter or number (not a hyphen)
Tenant names must be alphanumeric:

- Lowercase letters (`a-z`) and digits (`0-9`) only
- Must start with a lowercase letter
- Dashes (`-`) are **not allowed**, unlike with other services
- Maximum length depends on the cluster configuration (Helm release prefix and root domain)

**Note:** Using dashes (`-`) in tenant names is **allowed but discouraged**, unlike with other services.
This is to keep consistent naming in tenants, nested tenants, and services deployed in them.
Names with dashes (e.g., `foo-bar`) may lead to ambiguous parsing of internal resource names like `tenant-foo-bar`.
This restriction exists to keep consistent naming in tenants, nested tenants, and services deployed in them.
A tenant cannot be named `foo-bar` because parsing internal resource names like `tenant-foo-bar` would be ambiguous.

For example:

Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/cozystack-api/go-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Cozystack publishes its Kubernetes resource types as a Go module, enabling manag
Add the dependency to your Go module:

```bash
go get github.com/cozystack/cozystack/api/apps/v1alpha1@v1.2.0
go get github.com/cozystack/cozystack/api/apps/v1alpha1@{{< version-pin "cozystack_tag" >}}
```

## Use Cases
Expand Down
6 changes: 3 additions & 3 deletions content/en/docs/next/getting-started/install-cozystack.md
Original file line number Diff line number Diff line change
Expand Up @@ -259,9 +259,9 @@ In the following steps, we'll access LINSTOR interface, create storage pools, an
to set `failmode=continue` on ZFS storage pools to allow DRBD to handle disk failures instead of ZFS.

```bash
kubectl exec -ti -n cozy-linstor ds/linstor-satellite.srv1 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor ds/linstor-satellite.srv2 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor ds/linstor-satellite.srv3 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor pod/linstor-satellite.srv1 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor pod/linstor-satellite.srv2 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor pod/linstor-satellite.srv3 -- zpool set failmode=continue data
```

1. Check the results by listing the storage pools:
Expand Down
12 changes: 7 additions & 5 deletions content/en/docs/next/getting-started/install-talos.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,12 @@ curl -sSL https://github.com/cozystack/boot-to-talos/raw/refs/heads/main/hack/in
Run `boot-to-talos` and provide the configuration values.
Make sure to use Cozystack's own Talos build, found at [ghcr.io/cozystack/cozystack/talos](https://github.com/cozystack/cozystack/pkgs/container/cozystack%2Ftalos).

For Cozystack {{< version-pin "cozystack_tag" >}} the pinned Talos version is **{{< version-pin "talos" >}}** — override the installer's default when prompted:

```console
$ boot-to-talos
Target disk [/dev/sda]:
Talos installer image [ghcr.io/cozystack/cozystack/talos:v1.10.5]:
Talos installer image [ghcr.io/cozystack/cozystack/talos:v1.11.6]: ghcr.io/cozystack/cozystack/talos:{{< version-pin "talos" >}}
Add networking configuration? [yes]:
Interface [eth0]:
IP address [10.0.2.15]:
Expand All @@ -47,7 +49,7 @@ Gateway (or 'none') [10.0.2.2]:
Configure serial console? (or 'no') [ttyS0]:

Summary:
Image: ghcr.io/cozystack/cozystack/talos:v1.10.5
Image: ghcr.io/cozystack/cozystack/talos:{{< version-pin "talos" >}}
Disk: /dev/sda
Extra kernel args: ip=10.0.2.15::10.0.2.2:255.255.255.0::eth0::::: console=ttyS0

Expand All @@ -56,12 +58,12 @@ WARNING: ALL DATA ON /dev/sda WILL BE ERASED!
Continue? [yes]:

2025/08/03 00:11:03 created temporary directory /tmp/installer-3221603450
2025/08/03 00:11:03 pulling image ghcr.io/cozystack/cozystack/talos:v1.10.5
2025/08/03 00:11:03 pulling image ghcr.io/cozystack/cozystack/talos:{{< version-pin "talos" >}}
2025/08/03 00:11:03 extracting image layers
2025/08/03 00:11:07 creating raw disk /tmp/installer-3221603450/image.raw (2 GiB)
2025/08/03 00:11:07 attached /tmp/installer-3221603450/image.raw to /dev/loop0
2025/08/03 00:11:07 starting Talos installer
2025/08/03 00:11:07 running Talos installer v1.10.5
2025/08/03 00:11:07 running Talos installer {{< version-pin "talos" >}}
2025/08/03 00:11:07 WARNING: config validation:
2025/08/03 00:11:07 use "worker" instead of "" for machine type
2025/08/03 00:11:07 created EFI (C12A7328-F81F-11D2-BA4B-00A0C93EC93B) size 104857600 bytes
Expand All @@ -76,7 +78,7 @@ Continue? [yes]:
2025/08/03 00:11:07 copying from io reader to /boot/A/initramfs.xz
2025/08/03 00:11:08 writing /boot/grub/grub.cfg to disk
2025/08/03 00:11:08 executing: grub-install --boot-directory=/boot --removable --efi-directory=/boot/EFI /dev/loop0
2025/08/03 00:11:08 installation of v1.10.5 complete
2025/08/03 00:11:08 installation of {{< version-pin "talos" >}} complete
2025/08/03 00:11:08 Talos installer finished successfully
2025/08/03 00:11:08 remounting all filesystems read-only
2025/08/03 00:11:08 copy /tmp/installer-3221603450/image.raw → /dev/sda
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/getting-started/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ weight: 1

You will need the following tools installed on your workstation:

- [talosctl](https://www.talos.dev/v1.10/talos-guides/install/talosctl/), the command line client for Talos Linux.
- [talosctl](https://www.talos.dev/{{< version-pin "talos_minor" >}}/talos-guides/install/talosctl/), the command line client for Talos Linux (use the {{< version-pin "talos_minor" >}}.x series that matches Cozystack {{< version-pin "cozystack_version" >}}).
- [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl), the command line client for Kubernetes.
- [Talm](https://github.com/cozystack/talm?tab=readme-ov-file#installation), Cozystack's own configuration manager for Talos Linux:<br>

Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/next/install/ansible.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ cluster:
**Always pin `cozystack_chart_version` explicitly.** The collection ships with a default version that may not match the release you intend to deploy. Set it in your inventory to avoid unexpected upgrades:

```yaml
cozystack_chart_version: "1.0.0-rc.2"
cozystack_chart_version: "{{< version-pin "cozystack_version" >}}"
```

Check [Cozystack releases](https://github.com/cozystack/cozystack/releases) for available versions.
Expand Down Expand Up @@ -177,7 +177,7 @@ The playbook performs the following steps automatically:
| Variable | Default | Description |
| --- | --- | --- |
| `cozystack_api_server_host` | *(required)* | Internal IP of the control-plane node. |
| `cozystack_chart_version` | `1.0.0-rc.1` | Version of the Cozystack Helm chart. **Pin this explicitly.** |
| `cozystack_chart_version` | `{{< version-pin "cozystack_version" >}}` | Version of the Cozystack Helm chart. **Pin this explicitly.** |
| `cozystack_platform_variant` | `isp-full-generic` | Platform variant: `default`, `isp-full`, `isp-hosted`, `isp-full-generic`. |
| `cozystack_root_host` | `""` | Domain for Cozystack services. Leave empty to skip publishing configuration. |

Expand Down
8 changes: 4 additions & 4 deletions content/en/docs/next/install/cozystack/platform.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ This installs the operator, CRDs, and creates the `PackageSource` resource.

### Installing on non-Talos OS

By default, the Cozystack operator is configured to use the [KubePrism](https://www.talos.dev/latest/kubernetes-guides/configuration/kubeprism/)
By default, the Cozystack operator is configured to use the [KubePrism](https://www.talos.dev/{{< version-pin "talos_minor" >}}/kubernetes-guides/configuration/kubeprism/)
feature of Talos Linux, which allows access to the Kubernetes API via a local address on the node.

If you're installing Cozystack on a system other than Talos Linux, set the operator variant during installation:
Expand Down Expand Up @@ -268,9 +268,9 @@ It is [recommended](https://github.com/LINBIT/linstor-server/issues/463#issuecom
to set `failmode=continue` on ZFS storage pools to allow DRBD to handle disk failures instead of ZFS.

```bash
kubectl exec -ti -n cozy-linstor ds/linstor-satellite.srv1 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor ds/linstor-satellite.srv2 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor ds/linstor-satellite.srv3 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor pod/linstor-satellite.srv1 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor pod/linstor-satellite.srv2 -- zpool set failmode=continue data
kubectl exec -ti -n cozy-linstor pod/linstor-satellite.srv3 -- zpool set failmode=continue data
```

{{% /tab %}}
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/install/how-to/kubespan.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ weight: 120

Talos Linux provides a full mesh WireGuard network for your cluster.

To enable this functionality, you need to configure [KubeSpan](https://www.talos.dev/v1.8/talos-guides/network/kubespan/) and [Cluster Discovery](https://www.talos.dev/v1.2/kubernetes-guides/configuration/discovery/) in your Talos Linux configuration:
To enable this functionality, you need to configure [KubeSpan](https://www.talos.dev/{{< version-pin "talos_minor" >}}/talos-guides/network/kubespan/) and [Cluster Discovery](https://www.talos.dev/{{< version-pin "talos_minor" >}}/kubernetes-guides/configuration/discovery/) in your Talos Linux configuration:

```yaml
machine:
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/install/how-to/single-disk.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ provisioning:

For `talm`, append the same lines at end of the first node's configuration file, such as `nodes/node1.yaml`.

Read more in the Talos documentation: https://www.talos.dev/v1.10/talos-guides/configuration/disk-management/.
Read more in the Talos documentation: https://www.talos.dev/{{< version-pin "talos_minor" >}}/talos-guides/configuration/disk-management/.

After applying the configuration, wipe the `data-storage` partition:

Expand Down
8 changes: 4 additions & 4 deletions content/en/docs/next/install/kubernetes/generic.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,15 +182,15 @@ disable-kube-proxy: true
Download and apply Custom Resource Definitions:

```bash
kubectl apply -f https://github.com/cozystack/cozystack/releases/latest/download/cozystack-crds.yaml
kubectl apply -f https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-crds.yaml
```

### 2. Deploy Cozystack Operator

Download the generic operator manifest, replace the API server address placeholder, and apply:

```bash
curl -fsSL https://github.com/cozystack/cozystack/releases/latest/download/cozystack-operator-generic.yaml \
curl -fsSL https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-operator-generic.yaml \
| sed 's/REPLACE_ME/<YOUR_NODE_IP>/' \
| kubectl apply -f -
```
Expand Down Expand Up @@ -364,13 +364,13 @@ This example uses k3s default CIDRs. Adjust for kubeadm (`10.244.0.0/16`, `10.96
tasks:
- name: Apply Cozystack CRDs
ansible.builtin.command:
cmd: kubectl apply -f https://github.com/cozystack/cozystack/releases/latest/download/cozystack-crds.yaml
cmd: kubectl apply -f https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-crds.yaml
changed_when: true

- name: Download and apply Cozystack operator manifest
ansible.builtin.shell:
cmd: >
curl -fsSL https://github.com/cozystack/cozystack/releases/latest/download/cozystack-operator-generic.yaml
curl -fsSL https://github.com/cozystack/cozystack/releases/download/{{< version-pin "cozystack_tag" >}}/cozystack-operator-generic.yaml
| sed 's/REPLACE_ME/{{ cozystack_api_host }}/'
| kubectl apply -f -
changed_when: true
Expand Down
8 changes: 4 additions & 4 deletions content/en/docs/next/install/kubernetes/talm.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ All you need for an installation with Talm is to have access to the nodes: direc
This guide will use private IPs as a default option in examples, and public IPs in instructions and examples which are specific for the public IP setup.

If you are using DHCP, you might not be aware of the IP addresses assigned to your nodes in the private subnet.
Nodes with Talos Linux [expose Talos API on port `50000`](https://www.talos.dev/v1.10/learn-more/talos-network-connectivity/).
Nodes with Talos Linux [expose Talos API on port `50000`](https://www.talos.dev/{{< version-pin "talos_minor" >}}/learn-more/talos-network-connectivity/).
You can use `nmap` to find them, providing your network mask (`192.168.123.0/24` in the example):

```bash
Expand Down Expand Up @@ -69,7 +69,7 @@ For this guide, you need a couple of tools installed:
brew install siderolabs/tap/talosctl
```

For more installation options, see the [`talosctl` installation guide](https://www.talos.dev/v1.9/talos-guides/install/talosctl/)
For more installation options, see the [`talosctl` installation guide](https://www.talos.dev/{{< version-pin "talos_minor" >}}/talos-guides/install/talosctl/)

## 2. Initialize Cluster Configuration

Expand Down Expand Up @@ -111,9 +111,9 @@ endpoint: "https://192.168.100.10:6443"
clusterDomain: cozy.local
## Floating IP — should be an unused IP in the same subnet as nodes
floatingIP: 192.168.100.10
## Talos source image: use the latest available version
## Talos source image: pinned to the version that ships with the current Cozystack release
## https://github.com/cozystack/cozystack/pkgs/container/cozystack%2Ftalos
image: "ghcr.io/cozystack/cozystack/talos:v1.10.5"
image: "ghcr.io/cozystack/cozystack/talos:{{< version-pin "talos" >}}"
## Pod subnet — used to assign IPs to pods
podSubnets:
- 10.244.0.0/16
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ talos-bootstrap --help
- name: vfio_pci
- name: vfio_iommu_type1
install:
image: ghcr.io/cozystack/cozystack/talos:v1.10.3
image: ghcr.io/cozystack/cozystack/talos:{{< version-pin "talos" >}}
registries:
mirrors:
docker.io:
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/next/install/kubernetes/talosctl.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ Discovered open port 50000/tcp on 192.168.123.13
- name: vfio_pci
- name: vfio_iommu_type1
install:
image: ghcr.io/cozystack/cozystack/talos:v1.10.3
image: ghcr.io/cozystack/cozystack/talos:{{< version-pin "talos" >}}
registries:
mirrors:
docker.io:
Expand Down
Loading