---
title: k3s
type: docs
---

[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.k3s) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.k3s?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.k3s) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](https://gitea.rknet.org/ansible/xoxys.k3s/src/branch/main/LICENSE)

Setup K3s cluster nodes.

<!--more-->

- [Default Variables](#default-variables)
  - [k3s_config_dir](#k3s_config_dir)
  - [k3s_data_dir](#k3s_data_dir)
  - [k3s_init_log_enabled](#k3s_init_log_enabled)
  - [k3s_log_dir](#k3s_log_dir)
  - [k3s_node_ip](#k3s_node_ip)
  - [k3s_packages_extra](#k3s_packages_extra)
  - [k3s_reset](#k3s_reset)
  - [k3s_server](#k3s_server)
  - [k3s_server_admission_configuration](#k3s_server_admission_configuration)
  - [k3s_server_admission_plugins](#k3s_server_admission_plugins)
  - [k3s_server_bind_ip](#k3s_server_bind_ip)
  - [k3s_server_feature_gates](#k3s_server_feature_gates)
  - [k3s_server_flannel_backend_enabled](#k3s_server_flannel_backend_enabled)
  - [k3s_server_network_policy_enabled](#k3s_server_network_policy_enabled)
  - [k3s_server_nodes](#k3s_server_nodes)
  - [k3s_token](#k3s_token)
  - [k3s_version](#k3s_version)
- [Dependencies](#dependencies)

---

## Default Variables

### k3s_config_dir

#### Default value

```YAML
k3s_config_dir: /etc/rancher/k3s
```

### k3s_data_dir

#### Default value

```YAML
k3s_data_dir: /var/lib/rancher/k3s
```

### k3s_init_log_enabled

#### Default value

```YAML
k3s_init_log_enabled: false
```

### k3s_log_dir

#### Default value

```YAML
k3s_log_dir: /var/log/rancher/k3s
```

### k3s_node_ip

#### Default value

```YAML
k3s_node_ip: '{{ ansible_default_ipv4.address }}'
```

### k3s_packages_extra

#### Default value

```YAML
k3s_packages_extra:
  - container-selinux
  - selinux-policy-base
```

### k3s_reset

#### Default value

```YAML
k3s_reset: false
```

### k3s_server

#### Default value

```YAML
k3s_server: true
```

### k3s_server_admission_configuration

#### Default value

```YAML
k3s_server_admission_configuration:
  - name: EventRateLimit
    configuration:
      kind: Configuration
      apiVersion: eventratelimit.admission.k8s.io/v1alpha1
      limits:
        - type: Namespace
          qps: 50
          burst: 100
          cacheSize: 2000
        - type: User
          qps: 10
          burst: 50
```

### k3s_server_admission_plugins

#### Default value

```YAML
k3s_server_admission_plugins:
  - NodeRestriction
  - EventRateLimit
  - ServiceAccount
  - NamespaceLifecycle
```

### k3s_server_bind_ip

#### Default value

```YAML
k3s_server_bind_ip: 0.0.0.0
```

### k3s_server_feature_gates

#### Default value

```YAML
k3s_server_feature_gates: []
```

### k3s_server_flannel_backend_enabled

#### Default value

```YAML
k3s_server_flannel_backend_enabled: true
```

### k3s_server_network_policy_enabled

#### Default value

```YAML
k3s_server_network_policy_enabled: true
```

### k3s_server_nodes

#### Default value

```YAML
k3s_server_nodes:
  - '{{ ansible_hostname }}'
```

### k3s_token

#### Default value

```YAML
k3s_token: secure-token
```

### k3s_version

#### Default value

```YAML
k3s_version: v1.25.0+k3s1
```



## Dependencies

None.