Skip to main content

FAQ

The FAQ is updated periodically and designed to answer the questions our users most frequently ask about K3s.

Is K3s a suitable replacement for Kubernetes?

K3s is capable of nearly everything Kubernetes can do. It is just a more lightweight version. See the main docs page for more details.

How can I use my own Ingress instead of Traefik?

Simply start K3s server with --disable traefik and deploy your ingress.

Does K3s support Windows?

At this time K3s does not natively support Windows, however we are open to the idea in the future.

How can I build from source?

Please reference the K3s BUILDING.md with instructions.

Where are the K3s logs?

The installation script will auto-detect if your OS is using systemd or openrc and start the service.

When running with openrc, logs will be created at /var/log/k3s.log.

When running with systemd, logs will be created in /var/log/syslog and viewed using journalctl -u k3s.

Can I run K3s in Docker?

Yes, there are multiple ways to run K3s in Docker. See Advanced Options for more details.

What is the difference between K3s Server and Agent Tokens?

In K3s, there are two types of tokens: K3S_TOKEN and K3S_AGENT_TOKEN.

K3S_TOKEN: Defines the key required by the server to offer the HTTP config resources. These resources are requested by the other servers before joining the K3s HA cluster. If the K3S_AGENT_TOKEN is not defined, the agents use this token as well to access the required HTTP resources to join the cluster. Note that this token is also used to generate the encryption key for important content in the database (e.g., bootstrap data).

K3S_AGENT_TOKEN: Optional. Defines the key required by the server to offer HTTP config resources to the agents. If not defined, agents will require K3S_TOKEN. Defining K3S_AGENT_TOKEN is encouraged to avoid agents having to know K3S_TOKEN, which is also used to encrypt data.

If no K3S_TOKEN is defined, the first K3s server will generate a random one. The result is part of the content in /var/lib/rancher/k3s/server/token. For example, K1070878408e06a827960208f84ed18b65fa10f27864e71a57d9e053c4caff8504b::server:df54383b5659b9280aa1e73e60ef78fc, where df54383b5659b9280aa1e73e60ef78fc is the K3S_TOKEN.

I'm having an issue, where can I get help?

If you are having an issue with deploying K3s, you should:

1) Check the Known Issues page.

2) Check that you have resolved any Additional OS Preparation. Run k3s check-config and ensure that it passes.

3) Search the K3s GitHub existing issues for one that matches your problem.

4) Join the Rancher K3s Slack channel to get help.

5) Submit a New Issue on the K3s Github describing your setup and the issue you are experiencing.