Installing Hyperledger Sawtooth


These instructions have been tested on Ubuntu 18.04 (Bionic) only.

This procedure describes how to install Hyperledger Sawtooth on a Ubuntu system for proof-of-concept or production use in a Sawtooth network.

  1. Choose whether you want the stable version (recommended) or the most recent nightly build (for testing purposes only).

    • (Release 1.2 and later) To add the stable repository, run these commands in a terminal window on your host system.

      $ sudo apt-key adv --keyserver hkp:// --recv-keys 8AA7AF1F1091A5FD
      $ sudo add-apt-repository 'deb [arch=amd64] bionic universe'


      The chime metapackage includes the Sawtooth core software and associated items such as separate consensus software.

    • The latest version of Sawtooth is available in a repository of nightly builds. These builds may incorporate undocumented features and should be used for testing purposes only.

      To use the nightly repository, run the following commands in a terminal window on your host system.

      $ sudo apt-key adv --keyserver hkp:// --recv-keys 44FC67F19B2466EA
      $ sudo apt-add-repository 'deb [arch=amd64] bionic universe'
  2. Update your package lists.

    $ sudo apt-get update
  3. Install the Sawtooth packages. Sawtooth consists of several Ubuntu packages that can be installed together using the sawtooth meta-package. Run the following command:

    $ sudo apt-get install -y sawtooth
  1. (PBFT only) Install the PBFT consensus engine package.

    $ sudo apt-get install -y sawtooth sawtooth-pbft-engine
  2. (PoET only) Install the PoET consensus engine, transaction processor, and CLI packages.

    $ sudo apt-get install -y sawtooth \
    python3-sawtooth-poet-cli \
    python3-sawtooth-poet-engine \


Any time after installation, you can view the installed Sawtooth packages with the following command:

$ dpkg -l '*sawtooth*'