Skip to main content

Setting Podman machine default connection

Each Podman machine exposes two connections:

  • rootless
  • rootful

Podman has one default connection.

Podman Desktop, and other tools, such as Kind, connect to the default connection.

After an event that might have changed the default Podman machine connection, such as creating another Podman machine, consider verifying and setting the default connection.

Procedure​

  1. List Podman machine connections, in a terminal:

    $ podman system connection ls

  2. Set the Podman machine default connection to your desired connection, such as podman-machine-default-root, in a terminal:

    $ podman system connection default podman-machine-default-root

  3. List Podman machine connections, to verify which is the default, in a terminal:

    $ podman system connection ls

  4. Restart the Podman machine that has the default connection:

    $ podman machine stop
    $ podman machine start

  5. Refresh Podman Desktop connection to Podman: click the icon to open the Troubleshooting page, and click the Reconnect providers button.

Verification​

  • Podman Desktop lists images, containers, and pods that are accessible via the desired Podman machine connection.