From bf91418105f073665c324c55d4198ec3d0764542 Mon Sep 17 00:00:00 2001 From: Stephen Levine Date: Thu, 2 Oct 2025 15:28:05 -0400 Subject: [PATCH 1/6] Update install-linux.mdx --- docs/pages/includes/install-linux.mdx | 43 ++------------------------- 1 file changed, 2 insertions(+), 41 deletions(-) diff --git a/docs/pages/includes/install-linux.mdx b/docs/pages/includes/install-linux.mdx index b27d8661b5b78..c55f235cfd873 100644 --- a/docs/pages/includes/install-linux.mdx +++ b/docs/pages/includes/install-linux.mdx @@ -1,8 +1,7 @@ To install a Teleport Agent on your Linux server: -The easiest installation method, for *Teleport versions 17.3 and above*, is the -cluster install script. It will use the best version, edition, and installation -mode for your cluster. +The recommended installation method is the cluster install script. +It will select the correct version, edition, and installation mode for your cluster. 1. Assign to your Teleport cluster hostname and port, but not the scheme (https://). @@ -12,41 +11,3 @@ mode for your cluster. ```code $ curl "https:///scripts/install.sh" | sudo bash ``` - -On *older Teleport versions*: - -1. Assign to one of the following, depending on your - Teleport edition: - - | Edition | Value | - |-----------------------------------|--------------| - | Teleport Enterprise Cloud | `cloud` | - | Teleport Enterprise (Self-Hosted) | `enterprise` | - | Teleport Community Edition | `oss` | - -1. Get the version of Teleport to install. If you have automatic agent updates - enabled in your cluster, query the latest Teleport version that is compatible - with the updater: - - ```code - $ TELEPORT_DOMAIN= - $ TELEPORT_VERSION="$(curl https://$TELEPORT_DOMAIN/v1/webapi/automaticupgrades/channel/default/version | sed 's/v//')" - ``` - - Otherwise, get the version of your Teleport cluster: - - ```code - $ TELEPORT_DOMAIN= - $ TELEPORT_VERSION="$(curl https://$TELEPORT_DOMAIN/v1/webapi/ping | jq -r '.server_version')" - ``` - -1. Install Teleport on your Linux server: - - ```code - $ curl (=teleport.teleport_install_script_url=) | bash -s ${TELEPORT_VERSION} - ``` - - The installation script detects the package manager on your Linux server and - uses it to install Teleport binaries. To customize your installation, learn - about the Teleport package repositories in the [installation - guide](../installation/linux.mdx). From c92d6ff8d19f6a7efa0376aeec0b3003f4bd3638 Mon Sep 17 00:00:00 2001 From: Stephen Levine Date: Thu, 2 Oct 2025 15:31:56 -0400 Subject: [PATCH 2/6] Delete docs/pages/includes/install-linux-enterprise.mdx --- .../includes/install-linux-enterprise.mdx | 37 ------------------- 1 file changed, 37 deletions(-) delete mode 100644 docs/pages/includes/install-linux-enterprise.mdx diff --git a/docs/pages/includes/install-linux-enterprise.mdx b/docs/pages/includes/install-linux-enterprise.mdx deleted file mode 100644 index e1f1e8e303016..0000000000000 --- a/docs/pages/includes/install-linux-enterprise.mdx +++ /dev/null @@ -1,37 +0,0 @@ -Install Teleport on your Linux server: - -1. Assign to one of the following, depending on your - Teleport edition: - - | Edition | Value | - |-----------------------------------|--------------| - | Teleport Enterprise Cloud | `cloud` | - | Teleport Enterprise (Self-Hosted) | `enterprise` | - -1. Get the version of Teleport to install. If you have automatic agent updates - enabled in your cluster, query the latest Teleport version that is compatible - with the updater: - - ```code - $ TELEPORT_DOMAIN= - $ TELEPORT_VERSION="$(curl https://$TELEPORT_DOMAIN/v1/webapi/automaticupgrades/channel/default/version | sed 's/v//')" - ``` - - Otherwise, get the version of your Teleport cluster: - - ```code - $ TELEPORT_DOMAIN= - $ TELEPORT_VERSION="$(curl https://$TELEPORT_DOMAIN/v1/webapi/ping | jq -r '.server_version')" - ``` - -1. Install Teleport on your Linux server: - - ```code - $ curl (=teleport.teleport_install_script_url=) | bash -s ${TELEPORT_VERSION} - ``` - - The installation script detects the package manager on your Linux server and - uses it to install Teleport binaries. To customize your installation, learn - about the Teleport package repositories in the [installation - guide](../installation/linux.mdx). - From be3e8a4003d4aba8b2598436e7d70fb4501d7c93 Mon Sep 17 00:00:00 2001 From: Stephen Levine Date: Thu, 2 Oct 2025 15:34:08 -0400 Subject: [PATCH 3/6] Update oracle-self-hosted.mdx --- .../enroll-self-hosted-databases/oracle-self-hosted.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pages/enroll-resources/database-access/enroll-self-hosted-databases/oracle-self-hosted.mdx b/docs/pages/enroll-resources/database-access/enroll-self-hosted-databases/oracle-self-hosted.mdx index 1576212ae3264..e86c550f69f07 100644 --- a/docs/pages/enroll-resources/database-access/enroll-self-hosted-databases/oracle-self-hosted.mdx +++ b/docs/pages/enroll-resources/database-access/enroll-self-hosted-databases/oracle-self-hosted.mdx @@ -159,7 +159,7 @@ Install and configure Teleport where you will run the Teleport Database Service: -(!docs/pages/includes/install-linux-enterprise.mdx!) +(!docs/pages/includes/install-linux.mdx!) (!docs/pages/includes/database-access/self-hosted-config-start.mdx dbName="oracle" dbProtocol="oracle" databaseAddress="oracle.example.com:2484" dbName="oracle" !) From 0bddd9e8299e885c169ebbedcda74d1c67fdd1cf Mon Sep 17 00:00:00 2001 From: Stephen Levine Date: Thu, 2 Oct 2025 15:35:16 -0400 Subject: [PATCH 4/6] Update oracle-exadata.mdx --- .../database-access/enroll-managed-databases/oracle-exadata.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pages/enroll-resources/database-access/enroll-managed-databases/oracle-exadata.mdx b/docs/pages/enroll-resources/database-access/enroll-managed-databases/oracle-exadata.mdx index 1c1d3651a7ac3..ee49daf72af10 100644 --- a/docs/pages/enroll-resources/database-access/enroll-managed-databases/oracle-exadata.mdx +++ b/docs/pages/enroll-resources/database-access/enroll-managed-databases/oracle-exadata.mdx @@ -176,7 +176,7 @@ Install and configure Teleport where you will run the Teleport Database Service: -(!docs/pages/includes/install-linux-enterprise.mdx!) +(!docs/pages/includes/install-linux.mdx!) On the host where you will run the Teleport Database Service, start Teleport with the appropriate configuration. From 27bfd7977883d4ce0d961ae346eb6046d628f613 Mon Sep 17 00:00:00 2001 From: Stephen Levine Date: Thu, 2 Oct 2025 15:41:33 -0400 Subject: [PATCH 5/6] Update linux.mdx --- docs/pages/installation/linux.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pages/installation/linux.mdx b/docs/pages/installation/linux.mdx index ccabbfbfc29ad..9c3887f8c3107 100644 --- a/docs/pages/installation/linux.mdx +++ b/docs/pages/installation/linux.mdx @@ -87,7 +87,7 @@ The easiest way to install Teleport as an agent is through the WebUI at `/web/di ### One-line installation script -Outside of the WebUI, you can run our one-line cluster install script on your Linux server where you are deploying Teleport as an agent. This script will detect and use the best version, edition, and installation mode for your cluster. **Note that this is script is for Teleport versions 17.3 and above. If you are installing a version before this edition or this script does not work on your server, see below for other options.** +Outside of the WebUI, you can run our one-line cluster install script on your Linux server where you are deploying Teleport as an agent. This script will detect and use the best version, edition, and installation mode for your cluster. 1. Assign to your Teleport cluster hostname and Web UI port. This should contain you cluster hostname and port, but not the scheme (https://). From 3b799bfce2ebf1ef2a5c8db717954efdbc324607 Mon Sep 17 00:00:00 2001 From: Stephen Levine Date: Thu, 2 Oct 2025 16:26:40 -0400 Subject: [PATCH 6/6] Update docs/pages/installation/linux.mdx Co-authored-by: Zac Bergquist --- docs/pages/installation/linux.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pages/installation/linux.mdx b/docs/pages/installation/linux.mdx index 9c3887f8c3107..c7f9785cc8108 100644 --- a/docs/pages/installation/linux.mdx +++ b/docs/pages/installation/linux.mdx @@ -87,7 +87,7 @@ The easiest way to install Teleport as an agent is through the WebUI at `/web/di ### One-line installation script -Outside of the WebUI, you can run our one-line cluster install script on your Linux server where you are deploying Teleport as an agent. This script will detect and use the best version, edition, and installation mode for your cluster. +Outside of the Web UI, you can run our one-line cluster install script on your Linux server where you are deploying Teleport as an agent. This script will detect and use the best version, edition, and installation mode for your cluster. 1. Assign to your Teleport cluster hostname and Web UI port. This should contain you cluster hostname and port, but not the scheme (https://).