Skip to main content


This section contains instructions for installing K3s in various environments. Please ensure you have met the Requirements before you begin installing K3s.

Configuration Options provides guidance on the options available to you when installing K3s.

Private Registry Configuration covers use of registries.yaml to configure container image registry mirrors.

Embedded Mirror shows how to enable the embedded distributed image registry mirror.

Air-Gap Install details how to set up K3s in environments that do not have direct access to the Internet.

Managing Server Roles details how to set up K3s with dedicated control-plane or etcd servers.

Managing Packaged Components details how to disable packaged components, or install your own using auto-deploying manifests.

Uninstalling K3s details how to remove K3s from a host.