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.
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:
Puppet provides packages for installing Bolt on several Linux distributions and versions:
In a terminal, run the set of commands that correspond to your Linux version:
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
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
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-fedora-28.noarch.rpm sudo dnf install puppet-bolt
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-fedora-29.noarch.rpm sudo dnf install puppet-bolt
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-fedora-30.noarch.rpm sudo dnf install puppet-bolt
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-el-6.noarch.rpm sudo yum install puppet-bolt
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-el-7.noarch.rpm sudo yum install puppet-bolt
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-el-8.noarch.rpm sudo yum install puppet-bolt
sudo rpm -Uvh https://yum.puppet.com/puppet-tools-release-sles-12.noarch.rpm sudo zypper install puppet-bolt
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
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:
Like most macOS software, you can install Bolt using an Apple Disk Image (DMG) file:
puppet-bolt-latest.dmgfile to mount it.
puppet-bolt-[version]-installer.pkgto run the installer.