Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 3. Provisioning the command-line assistant to RHEL deployments with Red Hat Satellite

Update the endpoint so that RHEL systems registered to Satellite can proxy command-line assistant requests by using the Satellite Server.

Prerequisites

  • Your system is registered with Red Hat Lightspeed for Red Hat Enterprise Linux.
  • You are using the command-line assistant on a host registered to a Satellite 6.17+ server or later versions.
  • The Satellite Server must be connected to the internet.
  • You have enabled the AppStream repository on the host to be able to install the command-line assistant.

Procedure

  1. Install command-line assistant powered by RHEL Lightspeed on your registered host. 

    $ sudo dnf install command-line-assistant
  2. Locate and open the /etc/xdg/command-line-assistant/config.toml file.

  3. In the config.toml file, replace the endpoint configuration option to point to your Satellite or Capsule hostname, for example: 

    #The endpoint points to an API server.
endpoint = "https://satellite.example.server.com/api/lightspeed/v1"
  4. Save the changes in the config.toml file.

  5. Restart the command-line assistant daemon (clad) for the changes to take effect: 

    $ sudo systemctl restart clad

Troubleshooting

If the assistant cannot trust the Red Hat Satellite certificate authority (CA), it cannot establish a secure connection to the Satellite Server. As a result, the assistant does not function. To work around this problem:

  1. Copy the Satellite CA certificate to the system truststore: 

    $ sudo cp /etc/rhsm/ca/katello* /etc/pki/ca-trust/source/anchors/

  2. Update the CA trust database: 

    $ sudo update-ca-trust
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