How to Install and Configure Rancher on Ubuntu 18.04 | 16.04

This brief tutorial shows students and new users how to install Rancher on Ubuntu 18.04 | 16.04.

Rancher is a free and open-source Kubernetes management software stack that helps developers and users easily manage containers. Rancher comes with enormous community of users and allows you to build and launch Kubernetes compute nodes directly from the Rancher web interface.

Rancher centrally manages your on-premise or hybrid clusters to ensure security and accelerate transformation and that allows you to deploy and manage your stacks. Developers and businesses looking for tool to quickly deploy Kubernetes node will find Rancher useful.

For more about Rancher, please check its homepage.

To get started with installing and configuring Rancher, please follow the steps below:

Install Docker on Ubuntu

Since Rancher is a docker based took, you must first install Docker. By default, the latest stable version of Docker is not available on the Ubuntu 16.04 default repository. So, you will need to add the Docker’s repository to Ubuntu.

Run the commands below to install the below tools in order to add Docker’s repository.

sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common

Next add Docker office repository key by running the commands below:

curl -fsSL | sudo apt-key add -

If you wish to verify the above repository, simply run the commands below:

sudo apt-key fingerprint 0EBFCD88

The commands above should output similar lines as shown below:

pub   rsa4096 2017-02-22 [SCEA]
      9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid           [ unknown] Docker Release (CE deb) <>
sub   rsa4096 2017-02-22 [S]

Now that the official GPG key is installed, run the commands below to add its stable repository to Ubuntu. To add the nightly or test repository, add the word nightly or test (or both) after the word stable in the commands below.

sudo add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable"

At this point, Docker’s official GPG and repository should be installed on Ubuntu.

For those who currently have older versions of Docker, run the commands below to remove them.

sudo apt remove docker docker-engine containerd runc

When you have remove all previous versions of Docker, run the commands below to install the latest and current stable version of Docker.

To install specific version of Docker, run the apt-cache command.Then select the version to install.

apt-cache madison docker-ce

docker-ce | 5:18.09.5~3-0~ubuntu-bionic | bionic/stable amd64 Packages
docker-ce | 5:18.09.4~3-0~ubuntu-bionic | bionic/stable amd64 Packages
docker-ce | 5:18.09.3~3-0~ubuntu-bionic | bionic/stable amd64 Packages
docker-ce | 5:18.09.2~3-0~ubuntu-bionic | bionic/stable amd64 Packages

Now to install a specific version, run the commands below with the version you wish to install

sudo apt install docker-ce=5:19.03.5~3-0~ubuntu-bionic docker-ce-cli=5:19.03.5~3-0~ubuntu-bionic

If you just want to latest version without specifying above, run the commands below. The command below will always install the highest possible version.

sudo apt update
sudo apt install docker-ce docker-ce-cli

That should install Docker software on Ubuntu.

Once the Docker is installed, check the status of Docker with the following command:

sudo systemctl status docker

The above commands should output similar lines as shown below:

docker.service - Docker Application Container Engine
   Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
   Active: active (running) since Mon 2020-02-03 21:24:18 CST; 43s ago
 Main PID: 4780 (dockerd)
    Tasks: 10
   CGroup: /system.slice/docker.service
           └─4780 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.017323352-06:00" level=warning msg="Your kernel does not support cgroup rt runtime"
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.017409229-06:00" level=warning msg="Your kernel does not support cgroup blkio weight"
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.017498784-06:00" level=warning msg="Your kernel does not support cgroup blkio weight_devic
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.017723594-06:00" level=info msg="Loading containers: start."
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.122729079-06:00" level=info msg="Default bridge (docker0) is assigned with an IP address 1
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.217944703-06:00" level=info msg="Loading containers: done."
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.394264960-06:00" level=info msg="Docker daemon" commit=633a0ea838 graphdriver(s)=overlay2 
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.394345485-06:00" level=info msg="Daemon has completed initialization"
Feb 03 21:24:18 ubuntu1804 dockerd[4780]: time="2020-02-03T21:24:18.413016059-06:00" level=info msg="API listen on /var/run/docker.sock"
Feb 03 21:24:18 ubuntu1804 systemd[1]: Started Docker Application Container Engine.

Install Rancher

Now that Docker is installed, you can install Rancher simply by running the commands below.

sudo docker run -d --restart=unless-stopped -p 8080:8080 rancher/server:stable

Once the Rancher is installed, you can access its portal via the server IP address or hostname followed by port 8080.

Configure Rancher

Now, open your web browser and type the URL http://localhost:8080.

Rancher Ubuntu Install

When you first access Rancher’s portal, you will not be prompted for a username or password. To enhance its security, you should enable access restriction.

Rancher supports many access control including, Active Directory, Azure AD, Github, OpenLDAP, SAML, and Local Authentication.

To configure Rancher local authentication, click on the ADMIN menu and click on the Access Control. You should see the following page:

Rancher Ubuntu Setup

On the access control page, you will need to provide an admin username and password and click on the Enable Local Auth button.

After that, local authentication should be enabled and access restricted to only accounts created on the system.

From there you can begin to configure Rancher to suit your environment.


This post showed you how to install Rancher on Ubuntu 18.04 | 16.04. If you find any errors above, please use the form below to report them.


You may also like the post below:


  1. i installed rancher and wanted to create a kubernetes cluster. So i provisioned 3 nodes.
    Thing is how do i log into the global view/cluster console in rancher?? I have the same view as per your installation.



  2. After installing Rancher 2.5 in a single node, Ubunbtu 18.04 (VM on vSphere), I installed Guacamole and NextCloud. Everything working fine. Then I had a power failure. The Ubuntu came back but was in read-only file mode. I fixed that with ‘recovery mode’ and FSCK. Now Guacamole & NextCloud still work, but I was only getting “error 404 default backend” when trying to reach Rancher GUI. I power off the VM and today when I restarted, I still have access to Guacamole & NextCloud and now access to Rancher GUI! But I got “etcd is unhealty” but then it went away and as I tried to navigate the Rancher GUI I got “network error” and the GUI (Rancher website) goes blank. What to look for? how to fix this?

Leave a Comment

Your email address will not be published.