Skip to content

Commit ce716b3

Browse files
tashiantashian
authored
Merge pull request #403 from smallstep/carl/debs-and-rpms
Update installation instructions to use rpm and deb package repositories
2 parents ff1d23b + 750eeb6 commit ce716b3

File tree

2 files changed

+95
-63
lines changed

2 files changed

+95
-63
lines changed

‎step-ca/installation.mdx‎

Lines changed: 49 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
updated_at: April 08, 2025
23
title: Install step-ca
34
html_title: Installing open source step-ca
45
description: Learn how to install step-ca
@@ -22,12 +23,13 @@ Learn how to to install the `step-ca` binary on your local machine.
2223
- [Winget Package](#winget-package)
2324
- [Scoop Package](#scoop-package)
2425
- [Linux Packages](#linux-packages-amd64)
25-
- [Debian/Ubuntu](#debianubuntu)
26+
- [Debian/Ubuntu](#debian-ubuntu)
27+
- [RHEL/Fedora](#rhel-fedora)
2628
- [Arch Linux](#arch-linux)
27-
- [RedHat](#redhat)
2829
- [Alpine Linux](#alpine-linux)
2930
- [NixOS](#nixos)
3031
- [FreeBSD](#freebsd)
32+
- [Wolfi](#wolfi)
3133
- [Linux Binaries](#linux-binaries)
3234
- [Binary Signature Verification](#binary-signature-verification)
3335
- [Kubernetes](#kubernetes)
@@ -83,24 +85,46 @@ To uninstall, run `scoop uninstall`, then remove the configuration directory `$H
8385

8486
#### Debian/Ubuntu
8587

86-
To install `step`, download and install the Debian package for your platform from our [latest release](https://github.com/smallstep/cli/releases/latest):
87-
88-
```shell
89-
wget https://dl.smallstep.com/cli/docs-ca-install/latest/step-cli_amd64.deb
90-
sudo dpkg -i step-cli_amd64.deb
91-
```
88+
To add Smallstep as a source and install the `step-cli` and `step-ca` packages on Debian or Ubuntu distributions, run the following as `root`:
9289

93-
To install `step-ca`, download and install the Debian package for your platform from our [latest release](https://github.com/smallstep/certificates/releases/latest):
90+
```
91+
apt-get update && apt-get install -y --no-install-recommends curl vim gpg ca-certificates
92+
curl -fsSL https://packages.smallstep.com/keys/apt/repo-signing-key.gpg -o /etc/apt/trusted.gpg.d/smallstep.asc && \
93+
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/smallstep.asc] https://packages.smallstep.com/stable/debian debs main' \
94+
| tee /etc/apt/sources.list.d/smallstep.list
95+
apt-get update && apt-get -y install step-cli step-ca
96+
```
9497

95-
```shell
96-
wget https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_amd64.deb
97-
sudo dpkg -i step-ca_amd64.deb
98-
```
98+
Alternatively, to manually install a `.deb` for `step-cli` and `step-ca`, 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`) and [`smallstep/certificates`](https://github.com/smallstep/certificates/releases/latest) (`step-ca`).
9999

100100
To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup].
101101

102102
To uninstall, run `dpkg -r step-cli step-ca`, then remove the configuration directory `$HOME/.step`.
103103

104+
#### RHEL/Fedora
105+
106+
To add Smallstep as a source and install the `step-cli` and `step-ca` packages on RHEL or Fedora distributions, run the following as `root`:
107+
108+
```
109+
cat <<EOT > /etc/yum.repos.d/smallstep.repo
110+
[smallstep]
111+
name=Smallstep
112+
baseurl=https://packages.smallstep.com/stable/fedora/
113+
enabled=1
114+
repo_gpgcheck=0
115+
gpgcheck=1
116+
gpgkey=https://packages.smallstep.com/keys/smallstep-0x889B19391F774443.gpg
117+
EOT
118+
dnf makecache && dnf install -y step-cli step-ca
119+
```
120+
121+
122+
Alternatively, to manually install an `.rpm` for `step-cli` and `step-ca`, 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`) and [`smallstep/certificates`](https://github.com/smallstep/certificates/releases/latest) (`step-ca`).
123+
124+
To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup].
125+
126+
To uninstall, run `dnf remove step-cli step-ca`, then remove the configuration directory `$HOME/.step`.
127+
104128
#### Arch Linux
105129

106130
These packages are maintained by trusted Arch Linux community members.
@@ -119,26 +143,6 @@ To uninstall, run `pacman -R step-ca step-cli`, then remove the configuration di
119143

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

122-
#### RedHat
123-
124-
To install `step`, download and install the RPM package for your platform from our [latest release](https://github.com/smallstep/cli/releases/latest):
125-
126-
```shell
127-
wget https://dl.smallstep.com/cli/docs-ca-install/latest/step-cli_amd64.rpm
128-
sudo rpm -i step-cli_amd64.rpm
129-
```
130-
131-
To install `step-ca`, download and install the RPM package for your platform from our [latest release](https://github.com/smallstep/certificates/releases/latest):
132-
133-
```shell
134-
wget https://dl.smallstep.com/certificates/docs-ca-install/latest/step-ca_amd64.rpm
135-
sudo rpm -i step-ca_amd64.rpm
136-
```
137-
138-
To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup].
139-
140-
To uninstall, run `dnf remove step-cli step-ca`, then remove the configuration directory `$HOME/.step`.
141-
142146
#### Alpine Linux
143147

144148
There are community-maintained Alpine Linux Packages for `step` and `step-ca`.
@@ -173,6 +177,18 @@ To install both packages in a FreeBSD jail, follow the steps in this [installati
173177

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

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+
176192
### Linux Binaries
177193

178194
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)