mirror of
https://github.com/podman-desktop/podman-desktop
synced 2026-05-24 10:18:53 +00:00
docs: added _Setting Podman machine default connection_ (#3609)
Co-authored-by: Charlie Drage <charlie@charliedrage.com>
This commit is contained in:
parent
7218ef5ebd
commit
7bbb391e17
1 changed files with 51 additions and 0 deletions
|
|
@ -0,0 +1,51 @@
|
|||
---
|
||||
sidebar_position: 10
|
||||
title: Setting Podman machine default connection
|
||||
description: How to set Podman machine default connection.
|
||||
---
|
||||
|
||||
## 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:
|
||||
|
||||
```shell-session
|
||||
$ podman system connection ls
|
||||
```
|
||||
|
||||
1. Set the Podman machine default connection to your desired connection, such as `podman-machine-default-root`, in a terminal:
|
||||
|
||||
```shell-session
|
||||
$ podman system connection default podman-machine-default-root
|
||||
```
|
||||
|
||||
1. List Podman machine connections, to verify which is the default, in a terminal:
|
||||
|
||||
```shell-session
|
||||
$ podman system connection ls
|
||||
```
|
||||
|
||||
1. Restart the Podman machine that has the default connection:
|
||||
|
||||
```shell-session
|
||||
$ podman mahine stop
|
||||
$ podman machine start
|
||||
```
|
||||
|
||||
1. Refresh Podman Desktop connection to Podman: click the **<icon icon="fa-solid fa-lightbulb" size="lg" />** 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.
|
||||
Loading…
Reference in a new issue