diff --git a/docs/cspell.json b/docs/cspell.json
index 991ce9fdcf0a8..170f6e3668cbb 100644
--- a/docs/cspell.json
+++ b/docs/cspell.json
@@ -612,6 +612,7 @@
"lmnop",
"loadbalancer",
"localca",
+ "localinstall",
"loginerrortroubleshooting",
"loginrule",
"loginrules",
diff --git a/docs/pages/installation.mdx b/docs/pages/installation.mdx
index af0f6533ae4c6..d64211c9c2b12 100644
--- a/docs/pages/installation.mdx
+++ b/docs/pages/installation.mdx
@@ -317,14 +317,15 @@ repositories.
-### TAR archives (self-hosted only)
+### Downloading packages and TAR archives (self-hosted only)
-For self-hosted deployments, Teleport maintains TAR archives for
+Teleport maintains TAR archives as well as DEB and RPM packages for
Linux-compatible binaries at `https://cdn.teleport.dev`. This section explains
-the Teleport TAR archives and how to use them.
+how to install Teleport by manually downloading a release.
-It is not possible to install the automatic agent updater using TAR archives.
-Teleport Cloud customers must use the [one-line installation
+It is not possible to install the automatic agent updater using this method, so
+using packages and TAR archives is only available for users who self-hosted
+Teleport. Teleport Cloud customers must use the [one-line installation
script](#one-line-installation-script) or manually install Teleport from a
[package repository](#package-repositories) in order to install the updater.
@@ -354,38 +355,98 @@ script](#one-line-installation-script) or manually install Teleport from a
The following architecture values are available:
- - `amd64`
+ - `amd64` (`x86_84` if downloading an RPM package)
- `arm64`
- `arm`
- - `386`
+ - `386` (`i386` if downloading a DEB or RPM package)
-1. Run the following commands to download the Teleport archive, unpack it, and
- install binaries:
+1. Run the following commands to download a Teleport package or archive, unpack
+ it, and install binaries:
+
+
+
```code
$ curl https://cdn.teleport.dev/${TELEPORT_PKG?}-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-bin.tar.gz.sha256
#
$ curl -O https://cdn.teleport.dev/${TELEPORT_PKG?}-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-bin.tar.gz
- $ shasum -a 256 ${TELEPORT_PKG?}-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-bin.tar.gz
- # Verify that the checksums match
+ $ shasum --check -a 256 ${TELEPORT_PKG?}-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-bin.tar.gz
$ tar -xvf ${TELEPORT_PKG?}-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-bin.tar.gz
$ cd ${TELEPORT_PKG?}
$ sudo ./install
```
+
+
+
+ ```code
+ $ curl https://cdn.teleport.dev/${TELEPORT_PKG?}_${TELEPORT_VERSION?}_${SYSTEM_ARCH?}.deb.sha256
+ #
+ $ curl -O https://cdn.teleport.dev/${TELEPORT_PKG?}_${TELEPORT_VERSION?}_${SYSTEM_ARCH?}.deb
+ $ shasum --check -a 256 ${TELEPORT_PKG?}_${TELEPORT_VERSION?}_${SYSTEM_ARCH?}.deb
+ $ sudo dpkg -i ${TELEPORT_PKG?}_${TELEPORT_VERSION?}_${SYSTEM_ARCH?}.deb
+ ```
+
+
+
+
+ ```code
+ $ curl https://cdn.teleport.dev/${TELEPORT_PKG?}-${TELEPORT_VERSION?}-1.${SYSTEM_ARCH?}.rpm.sha256
+ #
+ $ curl -O https://cdn.teleport.dev/${TELEPORT_PKG?}-${TELEPORT_VERSION?}-1.${SYSTEM_ARCH?}.rpm
+ $ shasum --check -a 256 https://cdn.teleport.dev/${TELEPORT_PKG?}-${TELEPORT_VERSION?}-1.${SYSTEM_ARCH?}.rpm
+ # Or use yum localinstall, dnf localinstall etc.
+ $ sudo rpm -i https://cdn.teleport.dev/${TELEPORT_PKG?}-${TELEPORT_VERSION?}-1.${SYSTEM_ARCH?}.rpm
+ ```
+
+
+
For FedRAMP/FIPS-compliant installations of Teleport Enterprise, package URLs
are slightly different:
+
+
+
```code
$ curl https://cdn.teleport.dev/teleport-ent-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-fips-bin.tar.gz.sha256
#
$ curl -O https://cdn.teleport.dev/teleport-ent-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-fips-bin.tar.gz
- $ shasum -a 256 teleport-ent-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-fips-bin.tar.gz
- # Verify that the checksums match
+ $ shasum --check -a 256 teleport-ent-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-fips-bin.tar.gz
$ tar -xvf teleport-ent-v${TELEPORT_VERSION?}-linux-${SYSTEM_ARCH?}-fips-bin.tar.gz
$ cd teleport-ent
$ sudo ./install
```
+
+
+
+ FIPS builds are only available for the `arm64` and `amd64` system
+ architectures.
+
+ ```code
+ $ curl https://cdn.teleport.dev/teleport-ent_${TELEPORT_VERSION}-fips_${SYSTEM_ARCH}.deb.sha256
+ #
+ $ curl -O https://cdn.teleport.dev/teleport-ent_${TELEPORT_VERSION}-fips_${SYSTEM_ARCH}.deb
+ $ shasum --check -a 256 teleport-ent_${TELEPORT_VERSION}-fips_${SYSTEM_ARCH}.deb
+ $ sudo dpkg -i teleport-ent_${TELEPORT_VERSION}-fips_${SYSTEM_ARCH}.deb
+ ```
+
+
+
+
+ FIPS builds are only available for the `arm64` and `x86_64` system
+ architectures.
+
+ ```code
+ $ curl https://cdn.teleport.dev/teleport-ent-${TELEPORT_VERSION?}-1-fips.${SYSTEM_ARCH?}.rpm.sha256
+ #
+ $ curl -O https://cdn.teleport.dev/teleport-ent-${TELEPORT_VERSION?}-1-fips.${SYSTEM_ARCH?}.rpm
+ $ shasum --check -a 256 https://cdn.teleport.dev/teleport-ent-${TELEPORT_VERSION?}-1-fips.${SYSTEM_ARCH?}.rpm
+ # Or use yum localinstall, dnf localinstall etc.
+ $ sudo rpm -i https://cdn.teleport.dev/teleport-ent-${TELEPORT_VERSION?}-1-fips.${SYSTEM_ARCH?}.rpm
+ ```
+
+
+
### From your browser