Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 3. Customizing the Red Hat Lightspeed proxy

With Red Hat Lightspeed proxy, you can designate additional dnf or yum servers, customize the rhproxy configuration, and use customized commands and configuration options.

3.1. Designating optional dnf and yum servers
Copy link

To add additional third-party servers, including non-Red Hat and non-EPEL servers, create a custom allowlist for rhproxy.

Save the hostnames of systems providing dnf repositories in the following file:

  • /home/rhproxy/.config/rhproxy/env/mirror.servers

    1. Open the /home/rhproxy/.config/rhproxy/env/mirror.servers file, and add the hostnames of any systems that provide dnf repositories.

    2. After adding your systems, restart the service: 

      [rhproxy@server ~]$ rhproxy restart

Verification step

  • Run the following command to ensure that your third-party services were added: 

    [root@server ~]# curl -x http://$(hostname):3128 https://<hostname>

3.2. Customizing the rhproxy configuration
Copy link

You can further customize your rhproxy configuration. For a list of configurable options and their descriptions, see Appendix A.

Prerequisites

  • You have at least one active Red Hat Enterprise Linux (RHEL) subscription.
  • For the Red Hat Lightspeed proxy installation, you have at least one system running RHEL version 9.
  • You are logged in to the system as root or have sudo permissions.
  • Your architectural environment is Intel or ARM.
  • You are logged in as the rhproxy user.

Procedure

  1. Log in to the Red Hat Lightspeed proxy server.
  2. Edit the /home/rhproxy/.config/rhproxy/env/rhproxy.env file and make changes to the default configuration.

  3. Run the following command to restart the Red Hat Lightspeed proxy and enable your configuration edits to take effect: 

    [rhpproxy@server ~]$ rhproxy restart

    The allowed upstream servers are listed in the following files:

    • Red Hat servers are listed in: 

      /home/rhproxy/.config/rhproxy/env/redhat.servers
    • The DNF or YUM EPEL servers are listed in: 
/home/rhproxy/.config/rhproxy/env/epel.servers
Important

The preceding files get overwritten with rhproxy RPM updates. When the files are overwritten, you must reapply the manual configuration updates that you make.

You might decide to stop using the Red Hat Lightspeed proxy. Use the following procedure to unconfigure your client systems so that they no longer go through the Red Hat Lightspeed proxy.

Prerequisites

  • You have at least one active Red Hat Enterprise Linux (RHEL) subscription.
  • You have at least one system running RHEL version 9, for the Red Hat Lightspeed proxy installation.
  • You are logged in to the system as root or have sudo permissions.
  • Your architectural environment is either Intel or ARM.

Procedure

  1. Open your command-line interface, and navigate to the specific client system you want to remove from the Red Hat Lightspeed proxy.

  2. Run the following command on your client system: 

    [root@client ~] ./configure-client.sh --unconfigure

    Verification step

    • If the procedure is successful, you will see the following output: 

      Un-configuring insights-client/rhsm/rhc/rhcd from proxying to Red Hat Lightspeed

You can use the following options with the rhproxy command:

Expand
Table 3.1. Command options for the Red Hat Lightspeed proxy
OptionDescription

install

Installs the Red Hat Lightspeed proxy.

uninstall [-f]

Uninstalls the Red Hat Lightspeed proxy. Specify -f to force remove the certifications and downloaded data.

start

Starts the Red Hat Lightspeed proxy.

stop

Stops the Red Hat Lightspeed proxy.

restart

Restarts the Red Hat Lightspeed proxy.

status

Displays the status of the proxy’s running service and connection logs.

update

If you change the default 3128 port, you will need to use this option to update the configure-client.sh script.

If you want to run your proxy with non-default parameters, see the following table for a list of available options that you can set in the /home/rhproxy/.config/rhproxy/env/rhproxy.env configuration file.

Expand
Table 3.2. Configuration options for the Red Hat Lightspeed proxy
OptionDescription

RHPROXY_DISABLE

This option will disable an active proxy. This defaults to 0.

RHPROXY_DEBUG_CONFIG

Use this option to log environment variables and Nginx configuration upon startup. This defaults to 0.

RHPROXY_SERVICE_PORT

Use this option to define the listening port of the Red Hat Lightspeed proxy. This defaults to 3128.

RHPROXY_DNS_SERVER

Use this option to define which DNS server to use for name resolution. This defaults to 1.1.1.1. The rhproxy service will use the system DNS resolver if defined, otherwise it defaults to 1.1.1.1.

RHPROXY_WEB_SERVER_DISABLE

Use this option to disable the Red Hat Lightspeed proxy web server. This defaults to 0.

RHPROXY_WEB_SERVER_PORT

Use this option to define the listening port of the Red Hat Lightspeed proxy web server. This defaults to 8443.

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 HatBack to top