diff --git a/docs/pages/includes/install-linux-ent-self-hosted.mdx b/docs/pages/includes/install-linux-ent-self-hosted.mdx new file mode 100644 index 0000000000000..2ffe42b651c44 --- /dev/null +++ b/docs/pages/includes/install-linux-ent-self-hosted.mdx @@ -0,0 +1,110 @@ + + + +```code +# Download Teleport's PGP public key +$ sudo curl https://apt.releases.teleport.dev/gpg \ +-o /usr/share/keyrings/teleport-archive-keyring.asc +# Source variables about OS version +$ source /etc/os-release +# Add the Teleport APT repository for v(=teleport.major_version=). You'll need to update this +# file for each major release of Teleport. +$ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] \ +https://apt.releases.teleport.dev/${ID?} ${VERSION_CODENAME?} stable/v(=teleport.major_version=)" \ +| sudo tee /etc/apt/sources.list.d/teleport.list > /dev/null + +$ sudo apt-get update +$ sudo apt-get install teleport-ent +``` + +For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: + +```code +$ sudo apt-get install teleport-ent-fips +``` + + + + +```code +# Source variables about OS version +$ source /etc/os-release +# Add the Teleport YUM repository for v(=teleport.major_version=). You'll need to update this +# file for each major release of Teleport. +# First, get the major version from $VERSION_ID so this fetches the correct +# package version. +$ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+") +$ sudo yum-config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/v(=teleport.major_version=)/teleport.repo")" +$ sudo yum install teleport-ent +# +# Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs) +# echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path +``` + +For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: + +```code +$ sudo yum install teleport-ent-fips +``` + + + + +```code +# Source variables about OS version +$ source /etc/os-release +# Add the Teleport YUM repository for v(=teleport.major_version=). You'll need to update this +# file for each major release of Teleport. +# First, get the major version from $VERSION_ID so this fetches the correct +# package version. +$ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+") +# Use the dnf config manager plugin to add the teleport RPM repo +$ sudo dnf config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/v(=teleport.major_version=)/teleport.repo")" + +# Install teleport +$ sudo dnf install teleport-ent + +# Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs) +# echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path +``` + +For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: + +```code +$ sudo dnf install teleport-ent-fips +``` + + + + +In the example commands below, update `$SYSTEM_ARCH` with the appropriate +value (`amd64`, `arm64`, or `arm`). All example commands using this variable +will update after one is filled out. + +```code +$ curl https://get.gravitational.com/teleport-ent-v(=teleport.version=)-linux--bin.tar.gz.sha256 +# +$ curl -O https://cdn.teleport.dev/teleport-ent-v(=teleport.version=)-linux--bin.tar.gz +$ shasum -a 256 teleport-ent-v(=teleport.version=)-linux--bin.tar.gz +# Verify that the checksums match +$ tar -xvf teleport-ent-v(=teleport.version=)-linux--bin.tar.gz +$ cd teleport-ent +$ sudo ./install +``` + +For FedRAMP/FIPS-compliant installations of Teleport Enterprise, package URLs +will be slightly different: + +```code +$ curl https://get.gravitational.com/teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz.sha256 +# +$ curl -O https://cdn.teleport.dev/teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz +$ shasum -a 256 teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz +# Verify that the checksums match +$ tar -xvf teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz +$ cd teleport-ent +$ sudo ./install +``` + + + diff --git a/docs/pages/includes/install-linux-enterprise.mdx b/docs/pages/includes/install-linux-enterprise.mdx index 2a12aa17433ff..0702ad58c4523 100644 --- a/docs/pages/includes/install-linux-enterprise.mdx +++ b/docs/pages/includes/install-linux-enterprise.mdx @@ -2,119 +2,10 @@ Use the appropriate commands for your environment to install your package: - - - - ```code - # Download Teleport's PGP public key - $ sudo curl https://apt.releases.teleport.dev/gpg \ - -o /usr/share/keyrings/teleport-archive-keyring.asc - # Source variables about OS version - $ source /etc/os-release - # Add the Teleport APT repository for v(=teleport.major_version=). You'll need to update this - # file for each major release of Teleport. - $ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] \ - https://apt.releases.teleport.dev/${ID?} ${VERSION_CODENAME?} stable/v(=teleport.major_version=)" \ - | sudo tee /etc/apt/sources.list.d/teleport.list > /dev/null - - $ sudo apt-get update - $ sudo apt-get install teleport-ent - ``` - - For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: - - ```code - $ sudo apt-get install teleport-ent-fips - ``` - - - - - ```code - # Source variables about OS version - $ source /etc/os-release - # Add the Teleport YUM repository for v(=teleport.major_version=). You'll need to update this - # file for each major release of Teleport. - # First, get the major version from $VERSION_ID so this fetches the correct - # package version. - $ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+") - $ sudo yum-config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/v(=teleport.major_version=)/teleport.repo")" - $ sudo yum install teleport-ent - # - # Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs) - # echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path - ``` - - For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: - - ```code - $ sudo yum install teleport-ent-fips - ``` - - - - - ```code - # Source variables about OS version - $ source /etc/os-release - # Add the Teleport YUM repository for v(=teleport.major_version=). You'll need to update this - # file for each major release of Teleport. - # First, get the major version from $VERSION_ID so this fetches the correct - # package version. - $ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+") - # Use the dnf config manager plugin to add the teleport RPM repo - $ sudo dnf config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/v(=teleport.major_version=)/teleport.repo")" - - # Install teleport - $ sudo dnf install teleport-ent - - # Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs) - # echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path - ``` - - For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: - - ```code - $ sudo dnf install teleport-ent-fips - ``` - - - - - In the example commands below, update `$SYSTEM_ARCH` with the appropriate - value (`amd64`, `arm64`, or `arm`). All example commands using this variable - will update after one is filled out. - - ```code - $ curl https://get.gravitational.com/teleport-ent-v(=teleport.version=)-linux--bin.tar.gz.sha256 - # - $ curl -O https://cdn.teleport.dev/teleport-ent-v(=teleport.version=)-linux--bin.tar.gz - $ shasum -a 256 teleport-ent-v(=teleport.version=)-linux--bin.tar.gz - # Verify that the checksums match - $ tar -xvf teleport-ent-v(=teleport.version=)-linux--bin.tar.gz - $ cd teleport-ent - $ sudo ./install - ``` - - For FedRAMP/FIPS-compliant installations of Teleport Enterprise, package URLs - will be slightly different: - - ```code - $ curl https://get.gravitational.com/teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz.sha256 - # - $ curl -O https://cdn.teleport.dev/teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz - $ shasum -a 256 teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz - # Verify that the checksums match - $ tar -xvf teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz - $ cd teleport-ent - $ sudo ./install - ``` - - - + (!docs/pages/includes/install-linux-ent-self-hosted.mdx!) -(!docs/pages/includes/cloud/install-linux-cloud.mdx!) + (!docs/pages/includes/cloud/install-linux-cloud.mdx!)
Before installing a `teleport` binary with a version besides v(=cloud.major_version=), diff --git a/docs/pages/includes/install-linux.mdx b/docs/pages/includes/install-linux.mdx index 5276e9a6938a3..0d19d60ba2091 100644 --- a/docs/pages/includes/install-linux.mdx +++ b/docs/pages/includes/install-linux.mdx @@ -26,119 +26,10 @@ Use the appropriate commands for your environment to install your package: - - - - ```code - # Download Teleport's PGP public key - $ sudo curl https://apt.releases.teleport.dev/gpg \ - -o /usr/share/keyrings/teleport-archive-keyring.asc - # Source variables about OS version - $ source /etc/os-release - # Add the Teleport APT repository for v(=teleport.major_version=). You'll need to update this - # file for each major release of Teleport. - $ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] \ - https://apt.releases.teleport.dev/${ID?} ${VERSION_CODENAME?} stable/v(=teleport.major_version=)" \ - | sudo tee /etc/apt/sources.list.d/teleport.list > /dev/null - - $ sudo apt-get update - $ sudo apt-get install teleport-ent - ``` - - For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: - - ```code - $ sudo apt-get install teleport-ent-fips - ``` - - - - - ```code - # Source variables about OS version - $ source /etc/os-release - # Add the Teleport YUM repository for v(=teleport.major_version=). You'll need to update this - # file for each major release of Teleport. - # First, get the major version from $VERSION_ID so this fetches the correct - # package version. - $ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+") - $ sudo yum-config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/v(=teleport.major_version=)/teleport.repo")" - $ sudo yum install teleport-ent - # - # Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs) - # echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path - ``` - - For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: - - ```code - $ sudo yum install teleport-ent-fips - ``` - - - - - ```code - # Source variables about OS version - $ source /etc/os-release - # Add the Teleport YUM repository for v(=teleport.major_version=). You'll need to update this - # file for each major release of Teleport. - # First, get the major version from $VERSION_ID so this fetches the correct - # package version. - $ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+") - # Use the dnf config manager plugin to add the teleport RPM repo - $ sudo dnf config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/v(=teleport.major_version=)/teleport.repo")" - - # Install teleport - $ sudo dnf install teleport-ent - - # Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs) - # echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path - ``` - - For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead: - - ```code - $ sudo dnf install teleport-ent-fips - ``` - - - - - In the example commands below, update `$SYSTEM_ARCH` with the appropriate - value (`amd64`, `arm64`, or `arm`). All example commands using this variable - will update after one is filled out. - - ```code - $ curl https://get.gravitational.com/teleport-ent-v(=teleport.version=)-linux--bin.tar.gz.sha256 - # - $ curl -O https://cdn.teleport.dev/teleport-ent-v(=teleport.version=)-linux--bin.tar.gz - $ shasum -a 256 teleport-ent-v(=teleport.version=)-linux--bin.tar.gz - # Verify that the checksums match - $ tar -xvf teleport-ent-v(=teleport.version=)-linux--bin.tar.gz - $ cd teleport-ent - $ sudo ./install - ``` - - For FedRAMP/FIPS-compliant installations of Teleport Enterprise, package URLs - will be slightly different: - - ```code - $ curl https://get.gravitational.com/teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz.sha256 - # - $ curl -O https://cdn.teleport.dev/teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz - $ shasum -a 256 teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz - # Verify that the checksums match - $ tar -xvf teleport-ent-v(=teleport.version=)-linux--fips-bin.tar.gz - $ cd teleport-ent - $ sudo ./install - ``` - - - + (!docs/pages/includes/install-linux-ent-self-hosted.mdx!) -(!docs/pages/includes/cloud/install-linux-cloud.mdx!) + (!docs/pages/includes/cloud/install-linux-cloud.mdx!)
Before installing a `teleport` binary with a version besides v(=cloud.major_version=),