diff --git a/docs/img/use-teleport/connect-cluster.png b/docs/img/use-teleport/connect-cluster.png deleted file mode 100644 index ad0fb1af9c0d3..0000000000000 Binary files a/docs/img/use-teleport/connect-cluster.png and /dev/null differ diff --git a/docs/img/use-teleport/connect-cluster@2x.png b/docs/img/use-teleport/connect-cluster@2x.png new file mode 100644 index 0000000000000..37b49304c7355 Binary files /dev/null and b/docs/img/use-teleport/connect-cluster@2x.png differ diff --git a/docs/img/use-teleport/connect-my-computer-setup@2x.png b/docs/img/use-teleport/connect-my-computer-setup@2x.png new file mode 100644 index 0000000000000..be75cd3d2a948 Binary files /dev/null and b/docs/img/use-teleport/connect-my-computer-setup@2x.png differ diff --git a/docs/img/use-teleport/connect-my-computer-status@2x.png b/docs/img/use-teleport/connect-my-computer-status@2x.png new file mode 100644 index 0000000000000..483867567257f Binary files /dev/null and b/docs/img/use-teleport/connect-my-computer-status@2x.png differ diff --git a/docs/img/use-teleport/connect-my-computer-top-bar@2x.png b/docs/img/use-teleport/connect-my-computer-top-bar@2x.png new file mode 100644 index 0000000000000..e01dd7ea24ccf Binary files /dev/null and b/docs/img/use-teleport/connect-my-computer-top-bar@2x.png differ diff --git a/docs/img/use-teleport/connect-ui-overview.png b/docs/img/use-teleport/connect-ui-overview.png deleted file mode 100644 index 24e9430c5cd16..0000000000000 Binary files a/docs/img/use-teleport/connect-ui-overview.png and /dev/null differ diff --git a/docs/img/use-teleport/connect-ui-overview@2x.png b/docs/img/use-teleport/connect-ui-overview@2x.png new file mode 100644 index 0000000000000..3e85dd81d35f6 Binary files /dev/null and b/docs/img/use-teleport/connect-ui-overview@2x.png differ diff --git a/docs/pages/connect-your-client/includes/connect-my-computer-prerequisites.mdx b/docs/pages/connect-your-client/includes/connect-my-computer-prerequisites.mdx index 1755a37dec6c3..d6cffce65bd31 100644 --- a/docs/pages/connect-your-client/includes/connect-my-computer-prerequisites.mdx +++ b/docs/pages/connect-your-client/includes/connect-my-computer-prerequisites.mdx @@ -1,6 +1,6 @@ - A macOS or Linux device. -- Teleport Connect v14.1+, on the same major version or one version behind the proxy version. See - [version compatibility](../../faq.mdx#version-compatibility). -- A local Teleport user: you authenticate using credentials or passwordless login, you don't - use SSO to log in to the cluster. +- Teleport Connect v14.1+, on the same major version or one version behind the Teleport Proxy + Service version. See [version compatibility](../../faq.mdx#version-compatibility). +- A local Teleport user: you must authenticate using credentials or passwordless login, and not with + SSO. - Permissions to create join tokens (verb `create` for [the `token` resource](../../access-controls/reference.mdx#teleport-resources)). diff --git a/docs/pages/connect-your-client/introduction.mdx b/docs/pages/connect-your-client/introduction.mdx index 6f3cf069e402b..da9dcf982bb64 100644 --- a/docs/pages/connect-your-client/introduction.mdx +++ b/docs/pages/connect-your-client/introduction.mdx @@ -126,7 +126,7 @@ server and database access within a single window. 1. Browse and connect to all the resources your user is permitted to access: - ![An example of Teleport Connect, populated with instances](../../img/use-teleport/connect-ui-overview.png) + ![An example of Teleport Connect, populated with instances](../../img/use-teleport/connect-ui-overview@2x.png) ### Web UI diff --git a/docs/pages/connect-your-client/teleport-connect.mdx b/docs/pages/connect-your-client/teleport-connect.mdx index d885e1ebba22a..96afaf47b884f 100644 --- a/docs/pages/connect-your-client/teleport-connect.mdx +++ b/docs/pages/connect-your-client/teleport-connect.mdx @@ -6,7 +6,7 @@ description: Using Teleport Connect Teleport Connect provides easy and secure access to SSH servers, databases, and Kubernetes clusters, with support for other resources coming in the future. -![resources tab in Teleport Connect](../../img/use-teleport/connect-cluster.png) +![resources tab in Teleport Connect](../../img/use-teleport/connect-cluster@2x.png) ## Installation & upgrade @@ -46,7 +46,7 @@ $ "Teleport Connect Setup-(=teleport.version=).exe" /S ## User interface -![user interface of Teleport Connect](../../img/use-teleport/connect-ui-overview.png) +![user interface of Teleport Connect](../../img/use-teleport/connect-ui-overview@2x.png) The top bar of Teleport Connect consists of: @@ -69,12 +69,12 @@ which cluster the current tab is bound to, and the **Share Feedback** button in Connect My Computer makes it possible to add your personal machine to a Teleport cluster in just a couple of clicks. -It is the easiest way to add a computer to the cluster, whether you're just exploring the -capabilities of Teleport or want your computer to be available in a Teleport-powered home lab. +It is the easiest way to add a computer to the cluster, whether you're exploring the capabilities of +Teleport or want your computer to be available in a Teleport-powered home lab. Connect My Computer sets up a Teleport agent managed completely by Teleport Connect, without having to use the terminal to get the job done and without the need for tools like `systemctl` to control -agent lifecycle. +the lifecycle of the agent. ### Prerequisites @@ -92,6 +92,8 @@ as logging in as other system users or [host user creation](../server-access/gui To begin the setup, click on the laptop icon in the top left and select "Connect My Computer". The new tab will guide you through an interaction-free setup. Click "Connect" to start the setup. +![Connect My Computer in the top bar](../../img/use-teleport/connect-my-computer-top-bar@2x.png) + The setup creates a new role in the cluster which grants access to your device as the current system user. The role is then added to your user object. @@ -110,10 +112,14 @@ Next, the setup downloads a Teleport agent for your platform and runs `teleport pointed at the current cluster. Once that is done, Connect My Computer starts the agent and waits for it to show up in the cluster as an SSH node. +![Connect My Computer setup](../../img/use-teleport/connect-my-computer-setup@2x.png) + After the agent joins the cluster, the tab transitions to showing the status of the agent. From here, you can connect to the node made available by the agent, stop and start the agent, as well as completely remove it. Manually logging out of the cluster will remove the agent as well. +![Connect My Computer status](../../img/use-teleport/connect-my-computer-status@2x.png) + Your computer will be shared while Teleport Connect is open. To stop sharing, close Teleport Connect or stop the agent through the Connect My Computer tab. Sharing will resume on app restart, unless you stop the agent before exiting. The agent stops immediately if Teleport Connect unexpectedly