Installation

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

Select your operating system or infrastructure:

macOS

Install step and step-ca together, via Homebrew:

brew install step

Linux

Debian
  1. Install step

    Download and install the Debian package for your platform from our latest release:

    wget https://github.com/smallstep/cli/releases/download/v0.15.14/step-cli_0.15.14_amd64.deb sudo dpkg -i step-cli_0.15.14_amd64.deb
  2. Install step-ca

    Download and install the Debian package for your platform from our latest release:

    wget https://github.com/smallstep/certificates/releases/download/v0.15.11/step-ca_0.15.11_amd64.deb sudo dpkg -i step-ca_0.15.11_amd64.deb

To configure step-ca as a daemon, see our systemd configuration guide.

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

Arch Linux

There are community-driven Arch Linux packages in the Arch User Repository.

You can use pacman to install the packages.

pacman -S step-cli step-ca

The binary tarballs can be found here:

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

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

Alpine Linux

There are community driven Alpine Linux Packages for step and step-ca.

Use apk to install step:

apk add step-cli step-certificates

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

The binary tarballs can be found here:

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

NixOS

There are community-maintained packages for NixOS 20.09:

The NixOS unstable channel hosts more recent versions of step-cli and step-ca.

Linux (other)
  1. Install step

    Download and install the Linux tarball from our latest release:

    wget -O step.tar.gz https://github.com/smallstep/cli/releases/download/v0.15.14/step_linux_0.15.14_amd64.tar.gz tar -xf step.tar.gz sudo cp step_0.15.14/bin/step /usr/bin
  2. Install step-ca

    Download and install the Linux tarball from our latest release:

    wget -O step-ca.tar.gz https://github.com/smallstep/certificates/releases/download/v0.15.11/step-ca_linux_0.15.11_amd64.tar.gz tar -xf step-ca.tar.gz sudo cp step-ca_0.15.11/bin/step-ca /usr/bin

To configure step-ca as a daemon, see our systemd configuration guide.

Kubernetes

We publish helm charts for easy installation on kubernetes:

helm install step-certificates

You can see all the configuration options at https://hub.helm.sh/charts/smallstep/step-certificates.

Docker

We publish docker images for easy container installation.

Test your installation

$ step version Smallstep CLI/0.10.0 (darwin/amd64) Release Date: 2019-04-30 19:01 UTC $ step-ca version Smallstep CA/0.10.0 (darwin/amd64) Release Date: 2019-04-30 19:02 UTC

Next Steps

Subscribe

Unsubscribe anytime. See our privacy policy.