Open Source

Install step

It's trivial to install the step binary on your local machine.

Building from source?

Check out our guide to getting started with development.

Select your operating system or infrastructure:

Debian

macOS

Install step via Homebrew:

brew install step

To uninstall, run brew uninstall step and remove the $HOME/.step configuration directory.

Linux Packages (amd64)

Debian Linux

Download and install the Debian package from our latest release:

wget https://dl.step.sm/gh-release/cli/docs-cli-install/v0.23.1/step-cli_0.23.1_amd64.deb
sudo dpkg -i step-cli_0.23.1_amd64.deb

To uninstall, run sudo dpkg -r step-cli and remove the $HOME/.step configuration directory.

Arch Linux

There is a community-maintained step-cli package.

Use pacman to install step:

pacman -S step-cli

To uninstall, run pacman -R step-cli and remove the $HOME/.step configuration directory.

Big shout out to the maintainers of these packages! We appreciate you.

RedHat

Download and install the RPM package from our latest release:

wget https://dl.step.sm/gh-release/cli/docs-ca-install/v0.23.1/step-cli_0.23.1_amd64.rpm
sudo rpm -i step-cli_0.23.1_amd64.rpm

To uninstall, run sudo dnf remove step-cli and remove the $HOME/.step configuration directory.

Alpine Linux

This package is in a community repository.

To install it, you'll need to append http://dl-cdn.alpinelinux.org/alpine/edge/community to /etc/apk/repositories. Alternatively, see Linux (other).

There is a community-maintained step-cli package Alpine Linux Package.

Use apk to install step:

apk add step-cli

To uninstall, run apk del step-cli and remove the $HOME/.step configuration directory.

Big shout out to the maintainers of these packages! We appreciate you.

NixOS

Install the step-cli package on NixOS.

FreeBSD

Install the step-cli package on FreeBSD.

Linux binaries

We have 386, amd64, arm64, armv7, mips, and mips64 releases available to download from our latest release.

Place the binary in /usr/bin for compatibility with the rest of our documentation.

Windows

Install via Scoop

Install step via scoop:

scoop bucket add smallstep https://github.com/smallstep/scoop-bucket.git
scoop install smallstep/step

To uninstall, run scoop remove step and remove the $HOME/.step configuration directory.

Install manually

Download the Windows binary from our latest releases page and install it using PowerShell.

Open PowerShell and run the following:

curl.exe -LO https://dl.step.sm/gh-release/cli/docs-cli-install/v0.23.1/step_windows_0.23.1_amd64.zip
Expand-Archive -LiteralPath .\step_windows_0.23.1_amd64.zip -DestinationPath .
step_0.23.1\bin\step.exe version

Finally, move the step.exe binary wherever you'd like it to into a location in your user's PATH.

Testing your installation

$ step certificate inspect https://smallstep.com
Certificate:
    Data:
        Version: 3 (0x2)
        Serial Number: 326381749415081530968054238478851085504954 (0x3bf265673332db2d0c70e48a163fb7d11ba)
    Signature Algorithm: SHA256-RSA
        Issuer: C=US,O=Let's Encrypt,CN=Let's Encrypt Authority X3
        Validity
            Not Before: Feb 8 13:07:44 2019 UTC
            Not After : May 9 13:07:44 2019 UTC
        Subject: CN=smallstep.com
[...]