7.4. Configure proxy settings through UCR variables#

This page describes how to configure proxy settings so that command line tools and system utilities can access web resources through a proxy server.

Many command line tools that access web servers, such as wget, elinks, and curl, use the http_proxy or https_proxy environment variables if you set them. The tools automatically use the proxy server you’ve configured in these variables.

7.4.1. Configure proxy access#

To configure these environment variables persistently, you can use the UCR variable proxy/http and proxy/https. The system configures the environment variables in /etc/profile based on these UCR variables.

Specify the proxy URL, for example http://192.0.2.100. To add the proxy port, append a colon to the URL, for example http://192.0.2.100:3128. If the proxy requires authentication, include your credentials in the URL like this: http://<Username>:<Password>@192.0.2.100:3128.

7.4.2. Exclude domains from proxy access#

To exclude certain domains from proxy access, list them in the UCR variable proxy/no_proxy, separated by commas. When you exclude a domain, the exclusion also applies to all its subdomains. For example, if you exclude example.com, the system also excludes mail.example.com and www.example.com.

7.4.3. Session behavior#

Important

When you change proxy settings, existing sessions don’t update the environment variables. You must sign in again to apply the new settings.

7.4.4. Integration with Nubus for UCS tools#

The Nubus for UCS tools for software updates, such as univention-repository-update, also support operation through a proxy. These tools read the UCR variables proxy/http, proxy/https, and proxy/no_proxy, so your proxy configuration applies automatically.

See also

For information about software updates, see the following resources: