Hello good people. This guide will cover the installation and usage of Rancher container management platform on Ubuntu 18.04 LTS. Rancher is an open source, production ready, complete container management platform developed by Rancher Labs.

Rancher natively supports Kubernetes and allows users to control its features through a simple and intuitive UI. Kubernetes can be launched in a matter of minutes with a single click through Rancher. It integrates with LDAP, AD, and GitHub for authentication.

Similar: How to setup 3 node Kubernetes Cluster on Ubuntu 18.04 with Weave Net CNI

Rancher also provides Application catalog with over 90 popular Docker applications where you can deploy and manage complex applications with a click of a button. If you’re a Helm user, then no worry as Rancher ships with it. Additionally,  it’s easy to update Kubernetes to latest stable release using its Rancher UI.

Install  Rancher on Ubuntu 18.04

Here is the installation process of Rancher on Ubuntu 18.04. After the installation, we will deploy a Kubernetes cluster and create a test application container.

This setup has two VMs

Rancher Node:
Worker Node:

Step 1: Install Docker on Ubuntu 18.04 ( Both rancher server and worker node)

As Rancher and all workloads run on Docker containers, you need to have docker engine installed on your server

Update system apt index

sudo apt update

Then install the latest release of docker from the repository

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get -y install docker-ce

Wait for the download and installation of packages to finish then check docker version installed.

# docker version
 Version:           18.06.1-ce
 API version:       1.38
 Go version:        go1.10.3
 Git commit:        e68fc7a
 Built:             Tue Aug 21 17:24:51 2018
 OS/Arch:           linux/amd64
 Experimental:      false

  Version:          18.06.1-ce
  API version:      1.38 (minimum version 1.12)
  Go version:       go1.10.3
  Git commit:       e68fc7a
  Built:            Tue Aug 21 17:23:15 2018
  OS/Arch:          linux/amd64
  Experimental:     false

You can also install an experimental release of docker using the script provided by Docker.

curl -fsSL get.docker.com -o get-docker.sh
chmod +x get-docker.sh
sudo ./get-docker.sh
sudo usermod -aG docker $USER

Step 2: Create a Rancher docker container ( On Rancher Node)

Next, create a new Rancher server container by running the command:

sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher

If you have ports 80 & 443 used in your host system by other applications, you can map to different ports like below

sudo docker run -d --restart=unless-stopped -p 8080:80 -p 8443:443 rancher/rancher

Sample output:

rancher check status minThe Rancher user interface can be accessed at https://<server_ip>.

On accessing the page, you’ll be asked to set a strong password for the default admin user.

install rancher 01 min

Then set Rancher URL

rancher set url min

Step 3: Create a Kubernetes Cluster

Here we’ll create a single node Kubernetes cluster, note that in a Production environment, you’ll need at least three nodes, one master node, and two worker nodes.

To create a new cluster, navigate to Clusters > Add Cluster > From my own existing nodes ( Custom). Give the cluster a name, and click “Next”. Under Node Options, choose all ( etcd, Control Plane, and Worker)

rancher add node roles min

Paste the commands given on the Worker node. It may take some time for the cluster to be ready, so be patient.

rancher ready cluster minOnce the cluster is ready, all components should be green.

Step 4: Deploy Container application

Now that we have our cluster ready, let’s proceed to deploy a test application to it. Click on your cluster name, then Catalog Apps. Search the name of the application you want to deploy, for me this is Dokuwiki. Check the Application deployment details to know the changes you may need to make.

After deployment, the application should appear on the Workloads section.

racher deploy dokuwiki minStay tuned for more articles related to Docker and Kubernetes.

Your support is our everlasting motivation,
that cup of coffee is what keeps us going!

As we continue to grow, we would wish to reach and impact more people who visit and take advantage of the guides we have on our blog. This is a big task for us and we are so far extremely grateful for the kind people who have shown amazing support for our work over the time we have been online.

Thank You for your support as we work to give you the best of guides and articles. Click below to buy us a coffee.


Please enter your comment!
Please enter your name here