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 smallstep/smallstep/step


step certificate inspect


Download the latest Debian package from releases:


Install the Debian package:

sudo dpkg -s 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