Back to all templates
Rancher logo

Rancher

Infrastructure4096MB+ RAM

Kubernetes management platform

kubernetesmanagementmulti-cluster

Deploy Rancher in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Rancher

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Rancher on a VPS with Server Compass

Use the Rancher template in Server Compass to deploy a Kubernetes management platform on your VPS, then verify the web UI in a browser.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Rancher app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Rancher

Use the template picker search to find Rancher in the Server Compass template catalog.

Searching for Rancher in the Server Compass template picker
4
Step 4

Select the Rancher template

Choose the Rancher template. Server Compass fills the privileged Rancher service, persistent data volume, HTTPS port, and HTTP redirect port.

Rancher template selected in Server Compass
5
Step 5

Review the Rancher settings

Confirm the app name and compose service. In this run, the app was named rancher-demo and used host port 4443.

Reviewing Rancher project settings and compose service
6
Step 6

Deploy Rancher

Review the generated compose settings, confirm the Rancher HTTPS and HTTP ports are available, and click Deploy.

Reviewing Rancher HTTPS and HTTP ports before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Rancher image, starts the container, and verifies the stack.

Server Compass deploying the Rancher template on the VPS
8
Step 8

Confirm Rancher is running

After deployment finishes, return to the Apps tab and confirm the Rancher app is marked Running with its application URL available.

Rancher template running in the Server Compass Apps tab
9
Step 9

Open Rancher in the browser

Open the HTTPS application URL in a browser. The Rancher first-run screen confirms the management UI is reachable.

The deployed Rancher web UI loaded in a browser

After Rancher Opens

  • Retrieve the Rancher bootstrap password from container logs and rotate it during first setup.
  • Use a VPN, IP allowlist, firewall rule, or authenticated reverse proxy for production access.
  • Use trusted TLS certificates before managing production clusters through Rancher.
  • Review privileged container requirements before using this on shared hosts.
  • Back up the Rancher data volume before moving or replacing the VPS.
  • Keep the Rancher image updated for Kubernetes and dependency security fixes.

Verified Result

The Rancher web interface loaded successfully from the deployed container.

Rancher deployment questions

What does the Rancher template deploy?

It deploys the Rancher container in privileged mode with a persistent Rancher data volume and public HTTPS/HTTP ports.

Which port did the tutorial use?

The tutorial used host port 4443, which maps to Rancher HTTPS on container port 443. The template also exposes an HTTP port mapped to container port 80.

How do I get the first login password?

Use the Rancher bootstrap password command from the template notes, then rotate the password during first setup.

Should this become a blog post?

No. The deployment guide should live on the Rancher template detail page and be linked from the reusable template deployment docs page.

DIY Deployment

Self-Host Rancher with Docker

Take the DIY route and deploy Rancher on your own server using Docker.

1

Remote into Your Server

Initiate a secure shell connection to your server using the command below.

terminal
# Connect to your VPS
ssh root@your-server-ip

# Or with a specific SSH key
ssh -i ~/.ssh/your-key root@your-server-ip

First time? Docker required! Install it with: curl -fsSL https://get.docker.com | sh

2

Create the App Directory

Organize your deployment by creating a dedicated project folder.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/rancher
cd ~/apps/rancher
3

Write Your docker-compose.yml

Create a new docker-compose.yml file and paste this configuration:

docker-compose.yml
services:
  rancher:
    image: rancher/rancher:latest
    ports:
      - "443:443"
      - "80:80"
    volumes:
      - rancher_data:/var/lib/rancher
    privileged: true
    restart: unless-stopped

volumes:
  rancher_data:
Configurable Options
PORTHTTPS port(default: 443)
HTTP_PORTHTTP port(default: 80)
4

Launch the Containers

Start the services and tail the logs to verify startup.

terminal
# Spin up containers
docker compose up -d

# Verify deployment
docker compose ps

# Check logs for errors
docker compose logs -f
5

Open Firewall Ports

Open the required port in your firewall to allow access.

terminal
# Allow the application port through firewall
sudo ufw allow 443/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:443
Skip the Terminal

Want the easy way? Try Server Compass.

Forget SSH and YAML files. Deploy Rancher visually with Server Compass in just a few clicks.

  • Visual config editor
  • Instant deployment
  • Automatic HTTPS
  • Smooth updates
  • Live monitoring
  • Quick rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Rancher with Server Compass, complete these steps to finish setup

1

Get bootstrap password from logs

2

Set admin password

3

Add Kubernetes clusters

Need help? Check out our documentation for detailed guides.

Rancher FAQ

Common questions about self-hosting Rancher

How do I deploy Rancher with Server Compass?

Simply download Server Compass, connect to your VPS, and select Rancher from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Rancher?

Rancher requires a minimum of 4096MB RAM. We recommend a VPS with at least 8192MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Rancher data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Rancher backup and restore procedures.

How do I update Rancher to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Rancher image will be pulled and deployed with zero downtime.

Is Rancher free to self-host?

Rancher is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Rancher?

Download Server Compass and deploy Rancher to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass