Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

15.7. Removing Life Cycle Environments from the Red Hat Satellite Capsule Server

There are multiple reasons to remove life cycle environments from the Red Hat Satellite Capsule Server. For example:
  • When life cycle environments are no longer relevant to the host systems
  • When life cycle environments have been incorrectly added to the Satellite Capsule Server
To remove a life cycle environment from the Satellite Capsule Server:
  1. Log in to the Satellite Server CLI as the root user.
  2. Choose the desired Red Hat Satellite Capsule Server from the list and take note of its id: 
    # hammer capsule list
    Copy to Clipboard Toggle word wrap
    The Satellite Capsule Server's details can be verified using the command: 
    # hammer capsule info --id capsule_id_number
    Copy to Clipboard Toggle word wrap
  3. Verify the list of life cycle environments currently attached to the Red Hat Capsule Server and note down the environment id: 
    hammer capsule content lifecycle-environments --id capsule_id_number
    Copy to Clipboard Toggle word wrap
  4. Remove the life cycle environment from the Satellite Capsule Server: 
    # hammer capsule content remove-lifecycle-environment --id capsule_id_number --environment-id environment_id
    Copy to Clipboard Toggle word wrap
    Where:
    • --id is the Satellite Capsule Server's identification number.
    • --environment-id is the life cycle environment's identification number.
    Repeat this step for every life cycle environment to be removed from the Capsule Server.
  5. Synchronize the content from the Satellite Server's environment to the Satellite Capsule Server: 
    # hammer capsule content synchronize --id capsule_id_number
    Copy to Clipboard Toggle word wrap
Result:

The chosen environments are removed from the Satellite Capsule Server.

Report a bug
Back to top
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

© 2025 Red Hat