Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with rancher
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how


A module to install the Rancher server and accompanying agents on supported operating systems.

Module Description

Rancher is a complete platform for running containers. Rancher supports both Kubernetes and Docker Swarm, making it simple to run any containerized application on any infrastructure. With this Puppet module you can easily setup Rancher on your own Puppet managed hosts.


The module requires Docker to be running on the hosts. For this you can use the Puppet Docker module or any other means. If using the docker module this is as simple as:

class { 'docker': }


First you are likely to want to install a new rancher server. This is as simple as:

class { 'rancher::server': }

It is also possible to specify a custom port for the server to run on:

class { 'rancher::server':
  port => 9090,

Once the server is up and running and you can retrieve a registration token (from the web interface or from the API) you can bootstrap Rancher agents.

class { 'rancher':
  registration_url => '',

The class will use the ipaddress from facter ipaddress to register the agent, if this is not correct you can override it like so:

class { 'rancher':
  registration_url => '',
  agent_address    => $::ipaddress_eth1,


Full API reference documentation is available as generated by Puppet Strings.


This module is maintained by: Gareth Rushgrove


Puppet module for installing Rancher Server and Agent




No packages published