Skip to main content
Version: v2.5

Node Drivers

Node drivers are used to provision hosts, which Rancher uses to launch and manage Kubernetes clusters. A node driver is the same as a Docker Machine driver. The availability of which node driver to display when creating node templates is defined based on the node driver's status. Only active node drivers will be displayed as an option for creating node templates. By default, Rancher is packaged with many existing Docker Machine drivers, but you can also create custom node drivers to add to Rancher.

If there are specific node drivers that you don't want to show to your users, you would need to de-activate these node drivers.

Managing Node Drivers

Prerequisites: To create, edit, or delete drivers, you need one of the following permissions:

Activating/Deactivating Node Drivers

By default, Rancher only activates drivers for the most popular cloud providers, Amazon EC2, Azure, DigitalOcean and vSphere. If you want to show or hide any node driver, you can change its status.

  1. From the Global view, choose Tools > Drivers in the navigation bar. From the Drivers page, select the Node Drivers tab.

  2. Select the driver that you wish to Activate or Deactivate and select the appropriate icon.

Adding Custom Node Drivers

If you want to use a node driver that Rancher doesn't support out-of-the-box, you can add that provider's driver in order to start using them to create node templates and eventually node pools for your Kubernetes cluster.

  1. From the Global view, choose Tools > Drivers in the navigation bar. From the Drivers page, select the Node Drivers tab.

  2. Click Add Node Driver.

  3. Complete the Add Node Driver form. Then click Create.

Developing your own node driver

Node drivers are implemented with Docker Machine.