docs: added _Recovering from a failed start_ to troubleshooting (#3579)

Co-authored-by: Charlie Drage <charlie@charliedrage.com>
This commit is contained in:
Fabrice Flore-Thébault 2023-08-23 13:36:52 +02:00 committed by GitHub
parent 85f15771cc
commit ee0ba1e0dc
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -99,3 +99,21 @@ $ podman machine init
```
You should be a happy camper from here.
## Recovering from a failed start
After a failed start, the Podman machine might be unable to start because a QEMU process is still running and the PID file is in use.
#### Workaround
1. Kill the remaining QEMU process and stop the Podman machine:
```shell-session
$ ps -edf | grep qemu-system | grep -v grep | awk '{print $2}' | xargs -I{} kill -9 {}; podman machine stop
```
2. Start the Podman machine.
#### Solution
Use Podman 4.6.1 or greater.