Chapter 2. Configure proxy settings on macOS and Windows

Procedure

1. Set up your proxy configuration mode:

   1. Go to Settings > Proxy from the left navigation pane.

   2. Select a proxy configuration: System, Manual, or Disabled.

      If you select Manual, configure your proxy URLs and bypass proxy settings details. The other two modes require no additional configuration.

      Figure 2.1. Set your proxy configuration mode

      
   3. Click Update. A notification opens.
   4. Click OK.

2. Optional: To use a custom CA in your proxy, perform the following steps:

   1. Store your proxy CA in PEM format in the proxy_ca.pem file.

   2. Copy the certificate to the Podman machine:

      $ cat proxy_ca.pem | podman machine ssh <machine_name> "cat > proxy_ca.pem"

   3. Start an interactive session with the Podman machine:

      $ podman machine ssh <machine_name>

   4. Run the following command to copy the certificate to the Podman machine:

      $ sudo cp proxy_ca.pem /etc/pki/ca-trust/source/anchors/

   5. Run the following command to add your proxy certificate to the trust store:

      $ sudo update-ca-trust

3. To use a proxy in your containers, perform the following steps:

   1. Start an interactive session with the Podman machine:

      $ podman machine ssh <machine_name>

   2. Open the containers.conf file.

      Note

      To know about the containers.conf file location, refer to the Control network traffic flow with proxy section.

   3. Set the value of the proxy environment variables to pass into the containers in the file:

      [containers]
      http_proxy = true
      env = ["http_proxy=<your.proxy.tld:port>", "https_proxy=<your.proxy.tld:port>"]

4. Go to the Settings > Resources page, and restart the Podman machine.

Verification

1. Go to Images from the left navigation pane.

2. Click Pull an image.

   • Image to Pull: Enter an image name, such as quay.io/podman/hello.
3. Click Pull image. Red Hat build of Podman Desktop reports Download complete after a while.
4. Click Done.