Skip to content

Commit

Permalink
docs: added _Recovering from a failed start_ - references #3127
Browse files Browse the repository at this point in the history
Signed-off-by: Fabrice Flore-Thébault <[email protected]>
  • Loading branch information
themr0c committed Aug 17, 2023
1 parent a64bb8f commit 7a2e489
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions website/docs/troubleshooting/troubleshooting-podman-on-macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 start because a QEMU process is still running and the PID file is being used.

#### 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.

0 comments on commit 7a2e489

Please sign in to comment.