https://rancher.com/ logo
Title
r

refined-memory-51625

12/07/2022, 8:53 PM
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.
w

wide-garage-9465

12/07/2022, 9:01 PM
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?
r

refined-memory-51625

12/07/2022, 9:04 PM
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.
w

wide-garage-9465

12/07/2022, 9:06 PM
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.
r

refined-memory-51625

12/07/2022, 9:07 PM
ah perfect - thanks a ton!
w

wide-garage-9465

12/07/2022, 9:07 PM
You're welcome