Skip to content

Commit 651dce5

Browse files
committed
Update installation instructions to use rpm and deb package repositories
1 parent ff1d23b commit 651dce5

File tree

1 file changed

+35
-32
lines changed

1 file changed

+35
-32
lines changed

step-ca/installation.mdx

Lines changed: 35 additions & 32 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
@@ -23,8 +24,8 @@ Learn how to to install the `step-ca` binary on your local machine.
2324
- [Scoop Package](#scoop-package)
2425
- [Linux Packages](#linux-packages-amd64)
2526
- [Debian/Ubuntu](#debianubuntu)
27+
- [RHEL/Fedora](#rhelfedora)
2628
- [Arch Linux](#arch-linux)
27-
- [RedHat](#redhat)
2829
- [Alpine Linux](#alpine-linux)
2930
- [NixOS](#nixos)
3031
- [FreeBSD](#freebsd)
@@ -83,24 +84,46 @@ To uninstall, run `scoop uninstall`, then remove the configuration directory `$H
8384

8485
#### Debian/Ubuntu
8586

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-
```
87+
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`:
9288

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):
89+
```
90+
apt-get update && apt-get install -y --no-install-recommends curl vim gpg ca-certificates
91+
curl -fsSL https://packages.smallstep.com/keys/apt/repo-signing-key.gpg -o /etc/apt/trusted.gpg.d/smallstep.asc && \
92+
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/smallstep.asc] https://packages.smallstep.com/stable/debian debs main' \
93+
| tee /etc/apt/sources.list.d/smallstep.list
94+
apt-get update && apt-get -y install step-cli step-ca
95+
```
9496

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-
```
97+
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`).
9998

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

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

103+
#### RHEL/Fedora
104+
105+
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`:
106+
107+
```
108+
cat <<EOT > /etc/yum.repos.d/smallstep.repo
109+
[smallstep]
110+
name=Smallstep
111+
baseurl=https://packages.smallstep.com/stable/fedora/
112+
enabled=1
113+
repo_gpgcheck=0
114+
gpgcheck=1
115+
gpgkey=https://packages.smallstep.com/keys/smallstep-0x889B19391F774443.gpg
116+
EOT
117+
dnf makecache && dnf install -y step-cli step-ca
118+
```
119+
120+
121+
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`).
122+
123+
To configure `step-ca` as a daemon, see our [systemd configuration guide][systemd-setup].
124+
125+
To uninstall, run `dnf remove step-cli step-ca`, then remove the configuration directory `$HOME/.step`.
126+
104127
#### Arch Linux
105128

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

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

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-
142145
#### Alpine Linux
143146

144147
There are community-maintained Alpine Linux Packages for `step` and `step-ca`.

0 commit comments

Comments
 (0)