Menu
Products
Open Source
- Run a private internal ACME CA
- Configure popular ACME clients to use a private CA
- Use Kubernetes cert-manager with
step-ca - Issue X.509 host certificates to cloud VMs
- Issue X.509 user certificates via your identity provider
- Create a CA that uses RSA keys
- Import an existing root or intermediate CA into
step-ca - Use Keycloak to issue SSH certificates with step-ca
- Run an SSH CA and connect to VMs using SSH certificates
- Use AWS to deploy a certificate authority and secure microservices
- Run
step-cain a Docker container - Federate multiple autonomous certificate authorities
Products
Open Source
- Run a private internal ACME CA
- Configure popular ACME clients to use a private CA
- Use Kubernetes cert-manager with
step-ca - Issue X.509 host certificates to cloud VMs
- Issue X.509 user certificates via your identity provider
- Create a CA that uses RSA keys
- Import an existing root or intermediate CA into
step-ca - Use Keycloak to issue SSH certificates with step-ca
- Run an SSH CA and connect to VMs using SSH certificates
- Use AWS to deploy a certificate authority and secure microservices
- Run
step-cain a Docker container - Federate multiple autonomous certificate authorities
Installation
It's trivial to install the step binary on your local machine.
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/gh-release/cli/docs-cli-install/v0.18.0/step-cli_0.18.0_amd64.deb
sudo dpkg -i step-cli_0.18.0_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
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/gh-release/cli/docs-cli-install/v0.18.0/step_windows_0.18.0_amd64.zip
Expand-Archive -LiteralPath .\step_windows_0.18.0_amd64.zip -DestinationPath .
step_0.18.0\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.
© 2022 Smallstep Labs, Inc. All rights reserved.