How to install Chisel

To install the latest version of Chisel, you can choose any of the following methods:

Install the binary

We publish pre-built binaries for every version of Chisel on GitHub. To install the latest Chisel binary:

  1. Visit the latest release page to determine the latest version, for example, v1.0.0 (update the following steps according to your desired version and architecture).

  2. Run the following command to download the file.

    wget https://github.com/canonical/chisel/releases/download/v1.0.0/chisel_v1.0.0_linux_amd64.tar.gz

  3. We publish checksum files for the release tarballs. Download the appropriate checksum file with the following command.

    wget https://github.com/canonical/chisel/releases/download/v1.0.0/chisel_v1.0.0_linux_amd64.tar.gz.sha384

  4. Verify the checksum with the following command:

    sha384sum -c chisel_v1.0.0_linux_amd64.tar.gz.sha384

  5. Extract the contents of the downloaded tarball by running:

    tar zxvf chisel_v1.0.0_linux_amd64.tar.gz

  6. Install the Chisel binary. Make sure the installation directory is included in your system’s PATH environment variable. For example:

    sudo mv chisel /usr/local/bin/

Install from source

Alternatively, you can install the latest version of Chisel from source:

  1. Follow the official Go documentation to download and install Go.

  2. After installing, you will want to add the $GOBIN directory to your $PATH so you can use the installed tools. For more information, refer to the official documentation.

  3. Run the following command to build and install the latest version of Chisel:

    go install github.com/canonical/chisel/cmd/chisel@latest

Install Snap

You can also install the latest version of Chisel from the Snap store. Run the following command to install from the latest/stable track:

sudo snap install chisel

Note

This snap can only install the slices in a location inside the user’s $HOME directory, i.e. the --root option of the cut command must point to a location inside $HOME.

Verify installation

Once the installation is complete, verify that Chisel has been installed correctly by running:

chisel

This should produce output similar to the following:

user@host:~$ chisel
Chisel can slice a Linux distribution using a release databaseand construct a new filesystem using the finely defined parts. Usage: chisel <command> [<options>...] ...