Installation

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

Building from source?

Check out our guide to getting started with development.

macOS

Install step via Homebrew:

brew install step

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

Linux

Debian Linux

Download and install the Debian package from our latest release:

wget https://dl.step.sm/cli/v0.17.2/step-cli_0.17.2_amd64.deb
sudo dpkg -i step-cli_0.17.2_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 that uses the Arch User Repository.

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.

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 (other)

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/cli/v0.17.2/step_windows_0.17.2_amd64.zip
Expand-Archive -LiteralPath .\step_windows_0.17.2_amd64.zip -DestinationPath .
step_0.17.2\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
[...]

Subscribe to updates

Unsubscribe anytime. See our privacy policy.