Chapter 3. Configure proxy settings on Linux


To configure proxy settings for Podman on Linux, you must configure Podman directly. This is needed because Red Hat build of Podman Desktop proxy settings have no effect on the Podman service when running on a Linux machine.

Prerequisites

  • You have a proxy URL in the format: <your.proxy.tld:port>.
  • Optional: You have proxy Certificate Authorities (CAs) in Privacy-Enhanced Mail (PEM) format.

Procedure

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

    1. Open the containers.conf file.

      Note

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

    2. Set the value of the proxy environment variables to pass to the Podman engine in the file:

      [engine]
      env = ["http_proxy=<your.proxy.tld:port>", "https_proxy=<your.proxy.tld:port>"]
      Copy to Clipboard Toggle word wrap
  2. Optional: To use a custom CA in your proxy, perform the following steps:

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

      $ sudo cp proxy_ca.pem /etc/pki/ca-trust/source/anchors/
      Copy to Clipboard Toggle word wrap
    2. Run the following command to add your proxy certificate to the trust store:

      $ sudo update-ca-trust
      Copy to Clipboard Toggle word wrap
  3. Run the following command to restart all podman processes.

    $ pkill podman
    Copy to Clipboard Toggle word wrap

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.

You can access the image from an external repository.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top