Registration Assistant

Updated -

This application will guide you towards the best registration option for your Red Hat Enterprise Linux environment. Simply select the Red Hat Enterprise Linux Version and the subscription management technology you are using and the app will provide the appropriate commands to register your system.

Was this helpful?

We appreciate your feedback. Leave a comment if you would like to provide more detail.
It looks like we have some work to do. Leave a comment to let us know how we could improve.

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

Get notified when this content is updated



Subscriber exclusive content

An active Red Hat subscription is required to participate.

Log In

What about Satellite 6?

Hi Tony, great question!
We're in the process of getting that path added now. We hope to have something available by early next week. I'll reply here to let you know when that's complete.

There's no info in this "app" about registering virtual instances

Hi Jared,

In nearly every situation registering a virtual instance would be identical to a physical RHEL instance. Is there something specific you were looking for here?

The Select Version drop down is missing RH 5.10 and 5.11. Please update.

Good catch Rob, thanks! We'll get right on this.

Nothing here to help[ with registration during first boot...

Thank you for your feedback. I will see if we can have the information for this added. In the meantime you can find it for RHEL 7 here and for RHEL 6 here

You know what's SO great? Your instructions for remote registration in your documents doesn't look like what you get in your web portal. So I get to fuck around navigating your site rather than doing my job. But I guess RHEL 7 is so old that can happen.

Hi Dale,

You're completely right and we apologize for that. We redesigned the layout of the Customer Portal about a month ago and the documentation has not been updated yet to reflect that change. You can register systems starting at this interface and we'll work to get the documentation updated. Thanks for your feedback.

My redhat servers are on a closed network. Automated registration is not going to work. All of the selections in the Registration Assistant appear to be for internet connected systems.

We use the registration assistant to cover use cases where the command line interface is all that should be needed. You can register systems via the Customer Portal Web Interface by following the instructions here although do keep in mind this will not allow you to update systems, it's simply for auditing and record keeping.

We do have a few services including Red Hat Satellite and Subscription Asset Manager that will allow you to register systems locally. Hope that helps!

Now that the Subscription portal has changed drastically, how do I register virtual systems that are segregated and have no internet connectivity? The link you provided is instructions for an old website UI that no longer applies (not that I can find, anyway).

When I run register message returns already registered. When I run status message returns invalid.

Hi Rich, you may need to check the identity of your system but running subscription-manager identity. This may indicate that you're registered but not subscribed, and it might be best to open a support case if you're able to do that.

I ran into the same issues. Systems were 6.3 so this is only for 6.3. I cannot guarantee this will work for 5.x

Ultimately I had to go to each server and sudo su, moving the tarball to /var/regupdate then I ran

tar xvf registration_update-rhel6.tar.gz && rpm -Uvh *.rpm --replacefiles

Sudo will not work with this tarball extraction. You must be root.
Once that was done...

warning: openssl-1.0.1e-30.el6.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID fd431d51: NOKEY
Preparing...                ########################################### [100%]
   1:openssl                ########################################### [ 33%]
   2:python-rhsm            ########################################### [ 67%]
   3:subscription-manager   ########################################### [100%]

And then

subscription-manager register --username blah --password blah --auto-attach --force works perfectly

Hi what is the command to unregister at RHEL4, please?

I believe this is what you are looking for

subscription-manager register is run successfully.

Now what?

yum update doesn't work, it just tells me "there are no enabled repos".

Back in the world of classic Redhat I expected to have some indication of enabling entitlements, but instead I'm spending ages clicking randomly around the website in between all the irrelevant marketing.

What do we do next?

I am trying to run (rhn_register) COMMAND and I have the following error
An error has occurred:
class 'xmlrpclib.ResponseError'
See /var/log/up2date for more information

any idea?


There could be a number of reasons that you are getting that error. Did /var/log/up2date give any information that could be used to search the Knowledgebase If you are not able to find it there it may be worthwhile opening a support case to trouble shoot. You can open a case here


Just today we purchased a subscription for RHEL server.
The available install media is a DVD of RHEL 6.4
I installed this and registered using the new subscription.
Note the subscription and what follows was done using ssh from a remote location.
After registering, I ran "yum update".
Toward the end of the update I lost my ssh connection.
I reconnected. yum was no longer running.
An additional "yum update" said there was nothing to do.
I ran "rpm -Va" to see if the packages were OK. That appeared to work fine.
The system looked like RHEL 6.6 -- exactly what I expected.
... kernel panic. The system is now unbootable.
We decide to re-install RHEL from the DVD.
That installation is done.
But the subscription I need to use is taken up by a system that no longer exists.
For the life of me, I cannot find how to unsubscribe / unregister that system.

So, help!

Hello Keith,
Check out this about unregistering systems if that does not help you may need to open a support case.

i was able to register but unable to apply my subscription. any help? red hat enterprise desktop 7.1

Was there any errors or messages when you tried to attach? i found this that may be able to help you . I looked at your account and can see that you have a available Desktop subscription so you should be able to attach it.

The registration assistant does not help at all in attaching a subscription to an already registered system.

Where the hell is the list of machines that have been assigned to subscriptions? It takes me a few hundred clicks to find it every time. And that's the biggest reason I ever visit this site.

i need to change the ip address of my registered server and am having issues doing same

How to register or any kind of
account can access AUS channel?

am try to register my rhel linux 6.4 server using subscription-manager cmd
the system is registered but it shows the status as not subscribed and i not getting any updates from rhn can any one please suggest me on this

my mail:

Hello, have you tried refreshing then (re) attaching? This Solution has more info:

Hi, I need to download RedHat CloudForms 3.2, but when I click on download, it raises questions about subscription.

How to proceed with this? Does this mean I do not have an active subscription?

How do a register a system that can never be on the Internet?

Had to re-install my system, now it wont register the thing and i cant figure out how to remove the old registration from the same machine.

wow - this is quite disturbing. I just an additional spent several hundreds for the option of having a new Dell M6800 w/ RHEL 6.4 pre-installed - because it should work right out of the box, with no issues, no headaches, guaranteed compatibility.

I can't use it on first boot.

The support options for a PAID subscription is as obtuse and nebulous as I would expect for open SuSE - at least there I got what I paid for... Here? What DID I pay for?

Oh, call Dell, they'll take care of it.... um, it's a callback queue on brand new equipment. grrrrrrr

Call Red Hat - oh, we can't do anything until Dell's Red Hat Linux Expert Engineers diagnose the problem and pass it back to us....


You're losing precious credibility here for your right to CHARGE for support...

Hi team
I have upgraded RHN 5.4 to 5.7 in disconnected mode and also activate the key in disconnected mode and now trying to re-activate the key in connected mode I am getting below error :
ERROR: unhandled XMLRPC fault upon remote deactivation (reraising):

Please suggest on this error.

Here is the error details :
ERROR: unhandled XMLRPC fault upon remote deactivation (reraising):

On RHEL6.2, it seems --auto-attach is not supported by sub-scription-manager 0.96.17.

This doesn't work at all - and the troubleshooting process when this goes wrong is very poorly documented and unintelligibly presented. RHN classic just worked out of the box every time. If reasonably intelligent IT professionals can't figure this out in less than 10 minutes, then you're obviously doing something wrong with your software design.

When reinstalling Red Hat Enterprise Linux 6.5 onto the same machine, the reinstalled operating system cannot be subscribed because the subscription considers it as different. This requires a trip to your website to delete the previous subscription.

This is a bug. Is it resolved in an update, and can you path the 6.5 download image accordingly? I'm required to use this version for compatibility with other software.

My servers are not internet-connected, I don't see where it gives the option to register these? How can I register my "offline" servers?

Instructions for RHEL 7 didn't work. There's no "assistance" when it doesn't work in the registration assistant. That should be fixed. All I get is "Status: Not Subscribed", and there's nothing helpful here to resolve that.

How do I download the Ceph devel packages from the Red Hat Ceph repos? I have RHCS subscriptions and am not clear on which repo's I need to enable to download devel packages to build ceph.


Thank You So much for Guiding me at right Direction... again A big Thanks to Red Hat and its Team Members....

Can you return me my password from the purchased software RED HAT, to my email address?

We have purchased subscription for Linux Enterprise 7.2 Developer Suite. We cannot find Eclipse, Java and other parts of the Development Tools anywhwre. When we try: " [root@localhost ~]# subscription-manager list --available" the answer is "No available subscription pools to list"

Any thoughts? Do we hvae to purchase any additional subscription to be able to use the Developer Tools?

to solve DROWN I need to upgrade systems version 4. When I try it gives me error (SSL routines, SSL3_GETSERVER_CERTIFICATE, certificate verify failed). How to solve it

I'm trying to register an old 5.7 system and running into problems

$ mkdir registration
$ cd registration
$ wget
$ tar xvf Registration_Update-rhel-5-rhsm.tar.gz
$ sudo rpm -Uvh *.rpm --replacefiles
error: Failed dependencies:
    python-simplejson is needed by python-rhsm-1.11.3-5.el5.x86_64
    python-ethtool is needed by subscription-manager-1.11.3-10.el5.x86_64
    virt-what is needed by subscription-manager-1.11.3-10.el5.x86_64

Fixed it myself... needed to add the following from the original iso or downloaded from


I had the same issue, this fix worked for me except for the following changes: 1. I did not need libnl-1.0-0.10.pre5.5.x86_64.rpm 2. The packages are now here: Just wanted to say thanks and leave an update for future readers.

This is empty.

Your links are broken. /labs/registrationassistant => 404|a|a2|regassist&#/rhel7/?tech=subscription&service=sam&process=unattended&vdc=true gives an incorrect RPM name. SAM 1.4 uses candlepin-cert-consumer-latest.noarch.rpm rather than katello-ca-consumer-latest.noarch.rpm.

Registration Assistant links to 404 - page not found.

Great to have a link to an assistant..... But the link is broken, it returns a 404. Fail

It works for me, It took a while to show the dialog, but it worked right now.

The URL it forwards me to from the registration assistant is:

STILL missing instructions on how to register a standalone, not connected, will never be connected, can't ever be connected system.

Hello Jon, thanks for the feedback - we're looking into adding this for the registration assistant; in the meantime this might help:

I needed a newer version to work with my hardware. How do I unregister 6.5 so I can register 7.2?

Is your system registered to Red Hat Customer Portal? If so this Solution outlines steps to unregister, otherwise, try the registration asistant or this [RHEL Registration Guide] to see available options based on RHEL version and Classic vs RHSM subscription model.

how to check my License usage details ??

Need help ASAP.

Hi Subhash,

My apologies for not getting back to you soon, but I'd this is beyond the scope of this app. I'd suggest you open a support case to get help from Red Hat support team.

Thanks, Dong

I have a RHEL 7.3 system that used to have a subscription but for some reason, it completely disappeared from the portal. I do not know when it happened. On my system it said it is not registered so I decided to register the system again using subscription-manager register. The command completed successfully and displayed the UUID. However, I still cannot find this system on the customer portal. Tried looking up by system name and UUID and it's just not there. On the system, I also tried subscription-manager list --available --all and it said "No available subscription pools to list". I'm not sure how to resolve this. Does anyone have any suggestions?


Hi Henry, My apologies for not getting back to you soon, but I'd suggest you create a support case with Red Hat to solve the problem you have.

Thanks, Dong