Skip to main content
Skip table of contents


Rancher is the open source multi-cluster orchestration platform.


1. Create a custom role for Cloudaware in Rancher:

1.1. Log in to your Rancher account → Home → hamburger icon.

1.2. Select 'Users & Authentication' → Role Template → Create Global Role.

rancher - role templates - create.png

1.3. Set up a meaningful name for the role, e.g., CA Read Only. Grant get, list, and watch permissions in 'Verbs'. Set the scope as * in 'Resource'. Leave the radio button in 'New User Default' as is - No:

rancher - create role - permissions.png

Click Create.

1.4. Go back to 'Users & Authentication' → Users → select the user created for Cloudaware. Click tree dots on the right → click Edit Config.

rancher - users - edit config.png

Assign CA Read Only role to the Cloudaware user in 'Custom'. Click Save.

rancher - create role - assign.png

More about custom roles in Rancher here.

2. If Rancher server is running on the private network, TunHub Gateway must be configured before Rancher integration can be added to Cloudaware. Address the Cloudaware TunHub Integration Guidefor more information.

Adding Rancher Server

1. Log in to Cloudaware account → select Admin in the main menu under your username.

2. Find Rancher in the list of integrations, click +Add.

3. Fill in the required information:

Name - the Rancher integration name

URL - insert the TunHub URL generated by Cloudaware after a designated route is set up in TunHub integration (e.g.

API Key - use Bearer Token (see more in Rancher documentation)

Trust Certificate - check this box if Rancher server is running on a private network, and TunHub Gateway has been set up in Cloudaware.

Сlick Save.

4. The green light in 'Status' means that Rancher Server integration has been successfully configured. If there is a red light, please contact

5. Once the integration is added, go to Cloudaware CMDB Navigator to view the Rancher data collected under the section RANCHER on the left.

List of Rancher Objects 

Cloudaware supports the following Rancher objects:

Rancher Cluster
Rancher Cluster Config Map
Rancher Cluster Daemon Set
Rancher Cluster Deployment
Rancher Cluster Endpoint
Rancher Cluster HPA
Rancher Cluster Ingress
Rancher Cluster Limit Range
Rancher Cluster Namespace
Rancher Cluster Network Policy
Rancher Cluster Network Policy Rule
Rancher Cluster Node
Rancher Cluster Node Address
Rancher Cluster Pod
Rancher Cluster Pod Container
Rancher Cluster Pod Disruption Budget
Rancher Cluster Replica Set

Rancher Cluster Resource Quota
Rancher Cluster Role
Rancher Cluster Role Binding
Rancher Cluster Role Template Binding
Rancher Cluster Secret
Rancher Cluster Service
Rancher Cluster Service Account
Rancher Cluster Service Account Secret
Rancher Cluster Stateful Set
Rancher Global Role
Rancher Global Role Binding
Rancher Project
Rancher Project Role Template Binding
Rancher Role Template
Rancher Server
Rancher User

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.