Getting started with step locally

What is step

The step toolchain is a suite of services and command line components that make it easy to manage credentials and orchestrate security at “agile devopsy” shops in “cloud-ish” environments that use things like containers, microservices, and serverless functions.

More generally, the goal is to make security easy and non-intrusive in any environment.

Installing step locally

These instructions will install an OS specific version of the step binary on your local machine.

Mac OS

Install step via Homebrew:

brew install step

# test ...
step certificate inspect

Note: If you have installed step previously through the smallstep/smallstep tap you will need to run the following commands before installing:

brew untap smallstep/smallstep
brew uninstall step


Download the latest Debian package from releases:


Install the Debian package:

sudo dpkg -i step_X.Y.Z_amd64.deb

Testing your installation


step version

Which should display:

Smallstep CLI/0000000-dev (darwin/amd64)
Build time: 2018-04-26 20:26 UTC