Learning Kit

Intro to Bolt

Installing Bolt

Time: 15 minutes
Materials needed: none

Installing Bolt

Bolt is a software tool that runs on one computer (which is called the host node throughout this course) and controls one or more other computers (which are called target nodes). To use Bolt, all you have to do is install a single package on the host node, and you’re done!
Remember that Bolt does not require you to install Puppet or any other software on the host node or any of the target nodes.
As an aside, you might be wondering whether it’s possible to treat the Bolt host node as a target node (that is, could you use Bolt to control the same computer that it’s running on?) While in theory you could do that, it is not a normal use case. The typical use case is to use Bolt to control computers other than the computer that Bolt itself is running on.
NOTE: By default, Bolt collects data about how you use it. To find out more, or to op out of providing this data, see Bolt’s data collection policy.
The installation method varies slightly depending on what operating system, and what version of that operating system, your host node runs. The sections below cover all common situations.

Windows

Note: These instructions were tested with 64-bit Windows 10, but they should also work with 64-bit Windows 8.1. Bolt does not run on 32-bit Windows.
Like most Windows software, you can install Bolt using an MSI file:

  1. Download the Bolt installer package.
  2. Double-click the downloaded MSI file and run the installation.
  3. Open a command shell or PowerShell with Windows-x, then i.
  4. In the shell, run a Bolt command to make sure the installation succeeded: bolt --help

Linux

Puppet provides packages for installing Bolt on several Linux distributions and versions:

  • Debian 8 and 9
  • Fedora 28, 29, and 30
  • RHEL 6, 7, and 8
  • SUSE Linux Enterprise Server 12
  • Ubuntu 16.04 LTS and 18.04 LTS

In a terminal, run the set of commands that correspond to your Linux version:

Debian 8

wget https://apt.puppet.com/puppet-tools-release-jessie.deb
sudo dpkg -i puppet-tools-release-jessie.deb
sudo apt-get update && sudo apt-get install puppet-bolt

Debian 9

wget https://apt.puppet.com/puppet-tools-release-stretch.deb
sudo dpkg -i puppet-tools-release-stretch.deb
sudo apt-get update && sudo apt-get install puppet-bolt

Fedora 28

sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-fedora-28.noarch.rpm
sudo dnf install puppet-bolt

Fedora 29

sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-fedora-29.noarch.rpm
sudo dnf install puppet-bolt

Fedora 30

sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-fedora-30.noarch.rpm
sudo dnf install puppet-bolt

RHEL 6

sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-el-6.noarch.rpm
sudo yum install puppet-bolt

RHEL 7

sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-el-7.noarch.rpm
sudo yum install puppet-bolt

RHEL 8

sudo rpm -Uvh
https://yum.puppet.com/puppet-tools-release-el-8.noarch.rpm
sudo yum install puppet-bolt

SUSE Linux Enterprise Server 12

sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-sles-12.noarch.rpm
sudo zypper install puppet-bolt

Ubuntu 16.04

wget https://apt.puppet.com/puppet-tools-release-xenial.deb
sudo dpkg -i puppet-tools-release-xenial.deb
sudo apt-get update && sudo apt-get install puppet-bolt

Ubuntu 18.04

wget https://apt.puppet.com/puppet-tools-release-bionic.deb
sudo dpkg -i puppet-tools-release-bionic.deb
sudo apt-get update && sudo apt-get install puppet-bolt

In a terminal, run a Bolt command to make sure the installation succeeded: bolt --help.

macOS

Like most macOS software, you can install Bolt using an Apple Disk Image (DMG) file:

  • Find the macOS version number on your Mac by going to the Apple menu in the top left corner of your screen and choosing About This Mac.
  • Click the appropriate link to download the right version of the Bolt installer:
    • 10.11 El Capitan
    • 10.12 Sierra
    • 10.13 High Sierra
    • 10.14 Mojave
  • Double-click the downloaded puppet-bolt-latest.dmg file to mount it.
  • In the newly mounted drive, double-click puppet-bolt-[version]-installer.pkg to run the installer.
  • Open a terminal by running Terminal.app.
  • In a terminal, run a Bolt command to make sure the installation succeeded: bolt --help.
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.