Hi - hopefully an easy question.... just started to play with k3d (love it so far), but where can I find more detailed docs? For example, I noticed that when I stop and the start the cluster it'll remember the state of things, which is great. But where is that saved? And, how can I modify the start-up options of a cluster? Sorry if the docs are there and I just missed it.

Hey 👋 You mean more detailed than https://k3d.io ?

it'll remember the state of things

Cluster state is stored in etcd/sqlite inside the K3s containers. The K3s' containers' state is saved in Docker's overlayfs.

how can I modify the start-up options of a cluster

What start-up options do you mean?

so when I restart the cluster does it create new containers or just restart the previous one, thus restoring state? I was thinking of changing the --api-port of an already created cluster.

so when I restart the cluster does it create new containers or just restart the previous one, thus restoring state?

If you mean

k3d cluster stop && k3d cluster start

, that's just stopping and starting the same docker containers. k3d itself doesn't handle any state.

I was thinking of changing the --api-port of an already created cluster.

Modifying already running clusters is extremely limited, influenced by the limitations that the docker wrapper brings. But you can change the port-mapping for example. See

k3d cluster edit

for those options.

ah perfect - thanks a ton!

You're welcome