Uninstall

Removing a package stops its service and leaves configuration and state. Purging a package removes those as well. The system user kyvernon stays in both cases, because the other package and the virtual machine images may still use it.

Before you start

• Remove a host from its cluster first: Hosts. A host that still carries virtual machines cannot be removed from the inventory.
• Move or delete the virtual machines of the host. Removing the agent stops only the agent: the virtual machine processes keep running until you stop them, and they are managed again when an agent returns.
• Back up the controller before you purge it: Back up the controller.

Remove the packages

With the CLI

On a host:

# keep configuration and state
sudo apt remove kyvernon-agent
# or remove them as well
sudo apt purge kyvernon-agent

remove stops the agent and leaves /etc/kyvernon/agent.toml and /var/lib/kyvernon/agent. purge removes both. Virtual machine images under /var/lib/kyvernon/images and the datastores are never removed by the packages.

On the controller:

# keep configuration and state
sudo apt remove kyvernon-controller
# or remove them as well
sudo apt purge kyvernon-controller

remove leaves the configuration and the state directory. purge removes /etc/kyvernon/controller.toml, join-token and admin-password and the whole state directory /var/lib/kyvernon/controller, including the store with its identity key.

The packages kyvernon-vmm and kyvernon-cli are removed in the same way.

Related

• Install from an offline depot