Skip to content

Commit 750eeb6

Browse files
committed
More updated install instructions
1 parent 651dce5 commit 750eeb6

File tree

2 files changed

+61
-32
lines changed

2 files changed

+61
-32
lines changed

step-ca/installation.mdx

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,12 +23,13 @@ Learn how to to install the `step-ca` binary on your local machine.
2323
- [Winget Package](#winget-package)
2424
- [Scoop Package](#scoop-package)
2525
- [Linux Packages](#linux-packages-amd64)
26-
- [Debian/Ubuntu](#debianubuntu)
27-
- [RHEL/Fedora](#rhelfedora)
26+
- [Debian/Ubuntu](#debian-ubuntu)
27+
- [RHEL/Fedora](#rhel-fedora)
2828
- [Arch Linux](#arch-linux)
2929
- [Alpine Linux](#alpine-linux)
3030
- [NixOS](#nixos)
3131
- [FreeBSD](#freebsd)
32+
- [Wolfi](#wolfi)
3233
- [Linux Binaries](#linux-binaries)
3334
- [Binary Signature Verification](#binary-signature-verification)
3435
- [Kubernetes](#kubernetes)
@@ -176,6 +177,18 @@ To install both packages in a FreeBSD jail, follow the steps in this [installati
176177

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

180+
#### Wolfi
181+
182+
[Wolfi](https://wolfi.dev) has a maintained `step-ca` package.
183+
184+
Use apk to install `step-ca`:
185+
186+
```
187+
apk add step-ca
188+
```
189+
190+
To uninstall, run `apk del step-ca` and remove the `$HOME/.step` configuration directory.
191+
179192
### Linux Binaries
180193

181194
We distribute pre-compiled binaries for amd64, arm64, armv6, armv7, mips, mips64, ppc64le, and 386.

step-cli/installation.mdx

Lines changed: 46 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
updated_at: April 08, 2025
23
title: Install step
34
html_title: Installing open source step command
45
description: Learn how to install the step command
@@ -21,13 +22,13 @@ It's trivial to install the `step` binary on your local machine.
2122

2223
- [macOS](#macos)
2324
- [Linux Packages](#linux-packages-amd64)
24-
- [Debian](#debian-ubuntu)
25+
- [Debian/Ubuntu](#debian-ubuntu)
26+
- [RHEL/Fedora](#rhel-fedora)
2527
- [Arch Linux](#arch-linux)
26-
- [RedHat](#redhat)
2728
- [Alpine Linux](#alpine-linux)
28-
- [Wolfi](#wolfi)
2929
- [NixOS](#nixos)
3030
- [FreeBSD](#freebsd)
31+
- [Wolfi](#wolfi)
3132
- [Linux Binaries](#linux-binaries)
3233
- [Signature Verification](#binary-signature-verification)
3334
- [Windows](#windows)
@@ -46,15 +47,41 @@ To uninstall, run `brew uninstall step` and remove the `$HOME/.step` configurati
4647

4748
#### Debian/Ubuntu
4849

49-
Download and install the Debian package from our [latest release](https://github.com/smallstep/cli/releases/latest):
50+
To add Smallstep as a source and install the `step-cli` package on Debian or Ubuntu distributions, run the following as `root`:
5051

51-
```shell
52-
wget https://dl.smallstep.com/cli/docs-cli-install/latest/step-cli_amd64.deb
53-
sudo dpkg -i step-cli_amd64.deb
5452
```
53+
apt-get update && apt-get install -y --no-install-recommends curl vim gpg ca-certificates
54+
curl -fsSL https://packages.smallstep.com/keys/apt/repo-signing-key.gpg -o /etc/apt/trusted.gpg.d/smallstep.asc && \
55+
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/smallstep.asc] https://packages.smallstep.com/stable/debian debs main' \
56+
| tee /etc/apt/sources.list.d/smallstep.list
57+
apt-get update && apt-get -y install step-cli
58+
```
59+
60+
Alternatively, to manually install a `.deb` for `step-cli`, find the package you need for your platform on our GitHub release pages for [`smallstep/cli`](https://github.com/smallstep/cli/releases/latest) (`step-cli`).
5561

5662
To uninstall, run `sudo dpkg -r step-cli` and remove the `$HOME/.step` configuration directory.
5763

64+
#### RHEL/Fedora
65+
66+
To add Smallstep as a source and install the `step-cli` packages on RHEL or Fedora distributions, run the following as `root`:
67+
68+
```
69+
cat <<EOT > /etc/yum.repos.d/smallstep.repo
70+
[smallstep]
71+
name=Smallstep
72+
baseurl=https://packages.smallstep.com/stable/fedora/
73+
enabled=1
74+
repo_gpgcheck=0
75+
gpgcheck=1
76+
gpgkey=https://packages.smallstep.com/keys/smallstep-0x889B19391F774443.gpg
77+
EOT
78+
dnf makecache && dnf install -y step-cli step-ca
79+
```
80+
81+
Alternatively, to manually install an `.rpm` for `step-cli`, find the packages you need for your platform on our GitHub release pages for [`smallstep/cli`](https://github.com/smallstep/cli/releases/latest) (`step-cli`).
82+
83+
To uninstall, run `sudo dnf remove step-cli` and remove the `$HOME/.step` configuration directory.
84+
5885
#### Arch Linux
5986

6087
There is a community-maintained [`step-cli` package](https://archlinux.org/packages/extra/x86_64/step-cli/).
@@ -76,29 +103,6 @@ To uninstall, run `sudo pacman -R step-cli` and remove the `$HOME/.step` configu
76103

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

79-
#### RedHat
80-
81-
Download and install the RPM package from our [latest release](https://github.com/smallstep/cli/releases/latest):
82-
83-
```shell
84-
wget https://dl.smallstep.com/cli/docs-cli-install/latest/step-cli_amd64.rpm
85-
sudo rpm -i step-cli_amd64.rpm
86-
```
87-
88-
To uninstall, run `sudo dnf remove step-cli` and remove the `$HOME/.step` configuration directory.
89-
90-
#### Wolfi
91-
92-
[Wolfi](https://wolfi.dev) has a maintained `step` package.
93-
94-
Use apk to install `step`:
95-
96-
```
97-
apk add step
98-
```
99-
100-
To uninstall, run `apk del step` and remove the `$HOME/.step` configuration directory.
101-
102106
#### Alpine Linux
103107

104108
There is a community-maintained [`step-cli` package](https://pkgs.alpinelinux.org/packages?name=step-cli&branch=edge&repo=&arch=&maintainer=) for Alpine Linux.
@@ -121,6 +125,18 @@ Install the [`step-cli`](https://search.nixos.org/packages?channel=20.09&show=st
121125

122126
Install the [`step-cli`](https://www.freshports.org/security/step-cli/) package on FreeBSD.
123127

128+
#### Wolfi
129+
130+
[Wolfi](https://wolfi.dev) has a maintained `step` package.
131+
132+
Use apk to install `step`:
133+
134+
```
135+
apk add step
136+
```
137+
138+
To uninstall, run `apk del step` and remove the `$HOME/.step` configuration directory.
139+
124140
### Linux Binaries
125141

126142
We have 386, amd64, arm64, armv7, mips, and mips64 releases available to download from our [latest

0 commit comments

Comments
 (0)