> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siderolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Troubleshooting Omni and machines

This guide will assume you already have Omni available and running in your environment either self-hosted or using the Omni SaaS.
The sections are unordered and can be used to troubleshoot your specific situation or error messages.

## Removing stuck machines

Machines connected to Omni can get in states where Omni can no longer cleanly remove them. This may be because the machine is no longer available, the machine has errors, or other reasons.

This may block the ability to delete a cluster as Omni tries to cleanly remove machines before deleting the cluster resources. Sometimes trying to force delete the machine from the Omni UI also does not remove the machine.

To delete a machine from Omni via `omnictl` you will first need to identify what SideroLink it is using.

Identify the UUID of the machine that is stuck deleting by copying it from the menu.

<img src="https://mintcdn.com/siderolabs-fe86397c/dW1iQtK4Lz514Ws3/omni/troubleshooting/images/machine-menu.png?fit=max&auto=format&n=dW1iQtK4Lz514Ws3&q=85&s=1d5045d862a4f6193eac3aa36b092b29" alt="Machine menu" width="676" height="282" data-path="omni/troubleshooting/images/machine-menu.png" />

The machine UUID should also match a SideroLink UUID from

```bash theme={null}
omnictl get links
```

Once you verify one of the link UUIDs match you can delete the link (and machine) with:

```bash theme={null}
omnictl delete link $UUID
```
