I found an issue with this document.

Title: Troubleshoot apps when a host is unavailable
Location: https://fly.io/docs/apps/trouble-host-unavailable/
Source: https://github.com/superfly/docs/blob/main/apps/trouble-host-unavailable.html.markerb

Describe the issue

When following these instructions, I encountered an error like the following:
Error: error creating a new machine: failed to launch VM: insufficient resources to create new machine with existing volume 'vol_XXXXXXXXXXX' (Request ID: 01K4AS19K057WY04RHM2N58YBV-yyz) (Trace ID: c63a1385ea560f90f8201d97c77d1d26)

And it wasn't clear where to go from there.

The solution was to remove the original volume, so the new volume could be attached to a new machine.

That seemed missing from the documentation, and I had to figure it out from there and went down some rabbit holes of creating new machines, but that simple solution of removing the old volume solved that.

It feels like the docs should be updated to reflect that.

Additional info