Create a guide detailing how to configure and use Teleport/tsh on Windows

gravitational / teleport

The easiest, and most secure way to access and protect all of your infrastructure.

https://goteleport.com

GNU Affero General Public License v3.0

17.29k stars 1.74k forks source link

Create a guide detailing how to configure and use Teleport/tsh on Windows #3117

Closed webvictim closed 1 year ago

webvictim commented 4 years ago

We should have a guide detailing how to use Teleport on Windows.

how to install OpenSSH client/ssh-agent via Windows features (Windows 10)
maybe a manual installation guide for Windows 7/8
SSH config file/ProxyCommand examples using windows paths
limitations/gotchas when running on Windows

webvictim commented 4 years ago

I've made a start on this here - https://community.gravitational.com/t/how-to-connect-to-teleport-hosts-using-windows/559

ptgott commented 2 years ago

@webvictim I'm taking a look at this issue as part of this milestone. Given the release of v8 and our current Desktop Access docs, is there any other work you think we should do here? Thanks!

webvictim commented 2 years ago

I think this has definitely got easier now with the addition of tsh config (which is Windows-aware). In general desktop access is fairly easy from the client side as it's all in the browser.

ptgott commented 2 years ago

@webvictim Here is what I was thinking we could change. Does this work for you?

New tab for Windows 7/8 in the Windows section of our installation guide. We would change the current tab's label to "Windows 10 (Powershell)"
In our existing OpenSSH guide, add a Tabs box re: how to install OpenSSH/ssh-agent on different systems, including Windows.
Explain how to use tsh config and what the expected output is in our OpenSSH guide, which currently only mentions the command briefly. Include separate tabs for MacOS, Linux, and Windows systems.
We can talk about limitations/gotchas re: using OpenSSH with Teleport on Windows in a Details box in the OpenSSH guide. Are there any that come to mind that we should definitely include?

stevenGravy commented 1 year ago

@webvictim I think we can close this now right?

webvictim commented 1 year ago

Yes, this is now handled by docs and tsh config.