Rancher

Multi-cluster Kubernetes management platform. Allows you to manage, monitor, and operate multiple Kubernetes and k3s clusters from a single web interface.

Version:

2.13.2

back to Marketplace

VM Requisites

Resource Minimun
CPU 2 vCPU
RAM 4 GB
Disk 40 GB
Operating System Ubuntu 22.04 / 24.04

Access Port

Port Protocol Usage
443 HTTPS Rancher web interface

How To Access

With SSL enabled (recommended)

https://<IP-CON-GUIONES>.sslip.io/

Example: if your VM has the IP address 200.25.101.125:

https://200-25-101-125.sslip.io/

Without SSL

http://<VM_IP>/

Access credentials

When opening the URL for the first time, Rancher requests the Bootstrap Password to set up the administrator account.

Field Value
Bootstrap Password Find the value of RANCHER_BOOTSTRAP_PASSWORD or look for it in the deployment outputs

After entering the bootstrap password, Rancher will ask you to define a permanent password for the admin user.

Verify that Rancher is active

# View the Rancher pod
`kubectl get pods -A | grep rancher`

# View the installation log
`tail -f /var/log/cuemby/bootstrap.log`

# Check the health endpoint
`curl -k https://<VM_IP>/healthz`

Expected output

ok

Expected pod output:

NAME                       READY   STATUS    RESTARTS
rancher-xxxxxxxxx-xxxxx    1/1     Running   0        ← Running ✓

ℹ️ Even if the pod is in Running mode, Rancher may take several additional minutes to initialize all its internal controllers. Wait until /healthz responds ok before accessing the UI.

Configuration Parameters

Parameter Default Description
RANCHER_BOOTSTRAP_PASSWORD ⚠️ auto-generated Initial login password. Find it in the deployment outputs if you didn't configure it.
RANCHER_DATA_SIZE 10Gi Persistent volume size for Rancher configuration and status.
RANCHER_SSL_ENABLED true Enable HTTPS with automatic certificate via sslip.io.
RANCHER_HOSTNAME auto (sslip.io) Custom hostname. If left blank, the URL generated by Cuemby will be used.

⚠️ Set RANCHER_HOSTNAME before deployment if you plan to use your own domain. Changing it afterward requires manual certificate reconfiguration and may break existing registered clusters.

First Steps (quick start)

  1. Open the URL, enter the Bootstrap Password, and set your permanent admin password.
  2. Rancher automatically detects the local k3s cluster. Click on Local to manage it.
  3. Explore namespaces, workloads, services, and volumes from the Cluster Management menu.
  4. Connect additional clusters from Cluster Management → Create or Import Existing

💡 Tip: Rancher automatically manages the k3s cluster where it's installed as a local cluster. It's the starting point for exploring all the Cuemby Marketplace resources deployed on the same VM, offering a more comprehensive view than Portainer for multi-cluster operations.

Quick Troubleshooting

Problem Probable cause Solution
UI not loading Rancher still initializing Wait 8–15 min. Check with curl -k https:///healthz.
Bootstrap Password not working Incorrect password Review the deployment outputs in the Cuemby portal.
Local cluster in Unavailable state Rancher still registering the cluster Wait a few minutes and refresh the page. This is part of the normal startup process.
Invalid SSL certificate Hostname misconfigured Verify that RANCHER_HOSTNAME exactly matches the URL you are using.
Pod in CrashLoopBackOff Insufficient resources Check with kubectl describe pod -n .

Cuemby Cloud

IaaS

About Cuemby Cloud

Cuemby Cloud is enterprise-grade cloud infrastructure managed from a single console, built for stronger security, predictable operations, and easy scaling across regions.

Datacenters regions available in Colombia, Ecuador, and Chile

Backed by Tier III / Tier IV data center locations

Zero Network Ingress and Egress Fees

24/7 local expert support

Ready to Modernize Your Enterprise?

Future challenges demand future-ready solutions.
Let’s get started!

© Copyright | Cuemby® 2025