Quick Start

Follow these two easy steps to get started with Rancher

Step 1: Prepare a Linux Host

Rancher requires a single host installed with either Ubuntu 16.04 (kernel v3.10+) or RHEL/CentOS 7.3 as well as at least 2GB of memory, 80GB of local disk and the latest version of Docker.


Step 2: Start the server

To install and run Rancher server, execute the following Docker command on your host:

Rancher 1.6

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

Rancher 2.0 (tech preview)

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

It only takes a few minutes for the Rancher server to start up. The Rancher user interface is published on port 8080 by default, and can be accessed at http://host_ip:8080. Once Rancher has successfully been installed, the user interface will guide you through adding your first compute node and container.

Learn and Connect

Now that you’re up and running, learn more about using Rancher and connect with the community.

Visit the forums
Read the docs
Join users Slack
Search the resources