Red Hat Subscription Management (RHSM) provides customer-driven functionality and allows for focus on future technologies.

Red Hat provides organization-wide methods to track software products and subscriptions deployed across your account. RHSM allows administrators to manage:

  • Products available to your organization
  • Subscriptions and entitlements you have used
  • Products installed on your systems

When you purchase a subscription to a product, RHSM tracks which system(s) in your inventory are registered to the subscription. Registered systems are entitled to support services, as well as errata, patches, and upgrades from the Content Delivery Network (CDN).


Remaining systems will no longer be able to check in or receive updates from RHN Hosted after March 31, 2018.

Migrate to RHSM

Red Hat Subscription Management Info

Product Feature Highlights

RHSM manages your subscriptions and utilization in a simplified user interface and helps you:

System and Subscription Information

Easily determine the relationship between systems, subscriptions, and contracts.

Usage Summaries

View a summary of subscription utilization, making purchase and renewal decisions easier.

Contract Views

View a summary of contracts, including a view of the systems using subscriptions purchased with each contract.

Flexible Management

Control your consumption and allocation of subscriptions with local system, hosted, on-premise, and public cloud tools.

System Compliance

View subscription compliance status across all systems at a glance.

Errata Display

View a summary of errata that applies to all of your systems, and errata specific to each system.

Get Started with Red Hat Subscription Management

Register a System

To begin using the interface, you must first register your systems to RHSM. Once registered, systems can be managed through the Customer Portal to receive bug fixes, manage updates, view system information and track individual subscriptions and entitlements. If you do not have a subscription, you can purchase one from the Red Hat Store or contact Sales.

Open Terminal to register and subscribe your system using the command:
# subscription-manager register --username <username> --password <password> --auto-attach
If the one-step registration process does not work, manually register and subscribe:
# subscription-manager register
If you would like further assistance for registering systems, use the Registration Assistant .

Attach a Subscription through Customer Portal

Once registered, systems can be managed through the following steps:

  1. Go to Red Hat Subscription Management.
  2. Click Systems.
  3. Click on the name of the system you want to modify.
  4. Click the Subscriptions tab, and Attach Subscriptions.
  5. Select the desired subscriptions, and click Attach Subscriptions.

Migrating to RHSM

Red Hat shut down the RHN UI on July 31, 2017.

If you have not transitioned to RHSM yet, you need to do so to continue receiving support for your subscriptions. You will no longer receive updates if the system was not registered prior to the shut down or if there were problems with the system. Satellite systems will no longer be able to register, activate, or sync to RHN Hosted and will need to use RHSM to do so. If you need help determining the systems you use with RHN, try our new RHN System List Exporter lab app.

RHN end of life timeline:

  • July 31, 2017: No access to the web user interface (UI) and no ability to view system details, edit properties, or update from the web UI for any systems still on RHN.
  • October 31, 2017: No longer able to register systems to RHN Hosted.
  • March 31, 2018: No longer able to update any systems still registered to RHN.
  • For more information, see the Red Hat Subscription Management Migration FAQ.

Choose one of the three options below:

Virt-who information

If you have a virt-limit=unlimited subscription (e.g., a data center), you need to set up virt-who before migrating to RHSM from RHN. If you don’t set up virt-who prior to the migration, repositories and/or subscriptions may fall off of any system that is using a virt-who required subscription.

  1. Decide on a configuration that suits your environment.
  2. Review the virt-who daemon’s prerequisites and ensure that all have been met.
  3. Install an instance of Red Hat Enterprise Linux for the purpose of running virt-who.
  4. Install the virt-who daemon.
    # yum install virt-who
  5. Establish connections between the virt-who daemon and your hypervisors.

Note: virt-who setup needs to be completed within 24 hours after the process is initiated.

RHN Hosted to RHSM Hosted

Beginning with RHEL versions 5.8 and 6.2, you can run an automatic command that migrates systems registered to RHN to RHSM. This is the supported method for migrating systems.

Note: Before you begin, the system you are migrating needs the subscription-manager-migration and subscription-manager-migration-data packages installed. These packages enable the RHN channels to the Customer Portal Subscription Management product certificates to be mapped during migration. If you do not have these packages installed beforehand, you need to install them manually:

Run the command:

# yum search subscription-manager-migration -v
If necessary, enable the supplementary repositories which contain the migration RPMS:
# subscription-manager repos --enable rhel-6-server-optional-rpms
Install the migration tool packages:
# yum install subscription-manager-migration subscription-manager-migration-data
Once the migration packages are installed, you can migrate from RHN to Subscription Management. The rhn-classic-to-rhsm command uses this syntax:

After the migration is completed, run the following command to confirm the details.
# subscription-manager facts --list | grep migr
migration.classic_system_id: 09876
migration.migrated_from: rhn_hosted_classic
migration.migration_date: 2012-09-14T14:55:29.280519

Install the migration tool packages:
# yum install subscription-manager-migration subscription-manager-migration-data
Run the migration command:
# rhn-migrate-classic-to-rhsm

Satellite 5 to RHSM

If you are using Red Hat Satellite 6, changes planned for RHN subscription services in July, 2017 will not impact you, and no action is needed.

If you wish to continue using Red Hat Satellite 5, we highly recommend upgrading to the recently released Satellite 5.8 version as soon as possible. Satellite 5.8 has the ability to both register via Red Hat Subscription Manager (RHSM) and retrieve content from the Content Delivery Network (CDN). Additionally, Satellite 5.8 will offer Extended Lifecycle Support beginning in early 2019, if you wish to continue using Satellite 5 after that date. All other versions of Satellite 5 will end-of-life after January 31, 2019.

If you do wish to stay on Satellite 5.6 & 5.7 for a period of time, your servers will need to be migrated from Red Hat Network (RHN) to Red Hat Subscription Management (RHSM). Special care needs to be taken with Satellite 5.6 & 5.7 servers to ensure the systems will work properly. Red Hat has released an erratum on this topic with instructions for allowing a Satellite 5.6 or 5.7 system registered via RHSM to continue to sync via satellite-sync. Additionally, reference the following article Prepare Satellite 5 systems for Red Hat Network’s End of Life’ which walks you through the steps of migrating your systems.

As always, you can reference the Red Hat Satellite Lifecycle Support page to help you plan, deploy, and support your systems management infrastructure.

Red Hat Satellite Proxy Server Stand-Alone

Red Hat Satellite Proxy Server Stand-Alone is a component of Red Hat Satellite which uses the Proxy server as a stand-alone (Satellite-less) offering.

  • We recommend that you transition from Red Hat Proxy Server Stand-Alone to Satellite 6. Work with your Red Hat Account Manager to determine what Satellite subscriptions are best suited to your organization. Review the steps you need to take to migrate systems registered to RHN Classic via Satellite Proxy to Satellite 6.
  • You can currently run the Proxy server from the command line, but it can be challenging to manage the Proxy Server and attach new clients from the command line. Therefore, we highly recommend you transition before this happens.

Important: Proxy Server Stand-Alone shuts down on October 31, 2017. Please reference the Satellite and Proxy Server Lifecycle page for more information.  

Additional Migration Resources

Browse Red Hat Subscription Management Knowledge


Red Hat Subscription Management

Customer Portal Subscription Management Overview

A brief overview of functionality that can be used to mange Red Hat subscriptions from the Red Hat Customer Portal.

Migrating to RHSM

Product Migration Guides

Red Hat shut down the RHN UI on July 31, 2017. If you have not transitioned to RHSM yet, you need to do so to continue receiving support for your subscriptions.

How can we help you?

Support Cases

Get answers quickly by opening a support case with us.

View Open Cases

Open New Case

Live Chat

Directly access our support engineers during weekday business hours.

Learn more

Call or Email

Speak directly with a Red Hat support expert by phone or through email.

Contact Us


Red Hat Security Updates

Red Hat Security Labs

Product Policies and Support Programs

Red Hat Life Cycles

Red Hat offers subscription services for each major release of products throughout four life-cycle phases—called Production 1, 2, and 3, and an Extended Life Phase.

Welcome! Check out the Getting Started with Red Hat page for quick tours and guides for common tasks.