Install Rancher on CentOS 7
Rancher is an open source platform for running containers and building a private container service. Rancher is based on Docker, so you can run it on a dedicated box, KVM machine or even on a LXC container. Rancher provides a huge library of applications which are installed within a few clicks and also supports docker images from Dockerhub.
- A Vultr instance with CentOS 7 x64.
- At least 1GB memory.
- A supported version of Docker.
As stated, Docker is required to run Rancher, so we will install it first.
First, remove any old Docker files, if necessary.
sudo yum remove docker docker-common docker-selinux docker-engine
Note: You may get a report that no Docker files are installed. This is safe to ignore.
Install required packages.
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
Check the available versions of Docker CE.
yum list docker-ce --showduplicates | sort -r
You will see output similar to the following text.
... docker-ce.x86_64 17.09.1.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.09.0.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.06.2.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.06.1.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.06.0.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.03.2.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.03.1.ce-1.el7.centos docker-ce-stable docker-ce.x86_64 17.03.0.ce-1.el7.centos docker-ce-stable ...
You can install the latest version of Docker CE simply using the
sudo yum install docker-ce command, but in a production environment, it is recommended that you install a specific version rather than the latest version.
To specify the version of Docker CE to install, append the
version-string, (second column), of the latest stable version to the package name followed by a "
-", as shown in the following command.
sudo yum install docker-ce-17.09.1.ce-1.el7.centos
sudo systemctl start docker
Verify that Docker installed correctly.
sudo docker run hello-world
This command runs a test image in a test container to print a message, then exits. The message will be similar to the following output.
Hello from Docker! This message shows that your installation appears to be working correctly. To generate this message, Docker took the following steps: 1. The Docker client contacted the Docker daemon. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64) 3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal. To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bash Share images, automate workflows, and more with a free Docker ID: https://cloud.docker.com/ For more examples and ideas, visit: https://docs.docker.com/engine/userguide/
Now we're are ready to install Rancher.
sudo docker run -d --restart=unless-stopped -p 8080:8080 rancher/server:stable
Wait a few minutes to allow the Rancher UI to boot. Then, open your favorite browser and go to port
8080 on your server.
Be sure to replace
192.0.2.0 with your actual server's IP address.
Rancher doesn't configure access control by default, so it is important to set this up immediately, otherwise the UI and API can be accessed by anyone who has your IP.
Hover over the
ADMIN tab, and click
Follow the instructions in the Rancher UI to set up whichever form of access control you prefer.
Everything is now installed and you can begin to configure Rancher. For more in-depth information on configuring and using Rancher, visit their official documentation.