gravitational/teleport
1
0
Fork 0
mirror of https://github.com/gravitational/teleport.git synced 2026-10-11 22:49:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Connect: Improve docs about dual-mode installations (#65267)

Browse Source 
* Connect: Improve docs about dual-mode installations

* Fix path

* Clarify app uninstalling
This commit is contained in:
Grzegorz Zdunek
2026-04-01 16:37:09 +00:00
committed by GitHub
parent ae9e3e7f54
commit 328db2c7a5
3 changed files with 29 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/pages/connect-your-client/teleport-clients/teleport-connect.mdx
+9
View File
@@ -49,6 +49,15 @@ To choose the mode explicitly, add `/allusers` (per-machine) or `/currentuser` (
$ "Teleport Connect Setup-(=teleport.version=).exe" /S /allusers
```
<Admonition
type="warning"
title="Avoid Dual Installations"
>
Having both per-user and per-machine installations may cause the Start Menu shortcut to point to a different instance than expected.
Before installing the app in a different mode, [uninstall](#uninstalling-teleport-connect) the existing installation.
</Admonition>
</TabItem>
</Tabs>
docs/pages/includes/uninstall-teleport-connect-windows.mdx
+13 -4
View File
@@ -1,5 +1,14 @@
You can uninstall Teleport Connect from the "Apps and Features" section of the Control Panel.
You can uninstall Teleport Connect from the "Programs and Features" section of the Control Panel.
For reference, Teleport Connect binaries are installed to:
* Per-machine install (default): `%PROGRAMFILES%\Teleport Connect`
* Per-user install: `%LOCALAPPDATA%\Teleport Connect`
For reference, Teleport Connect binaries are installed to:
* Per-machine install (default): `%PROGRAMFILES%\Teleport Connect`
* Per-user install: `%LOCALAPPDATA%\Programs\Teleport Connect`
To silently uninstall the app, open the Command Prompt and type:
```code
# For per-machine install (default):
$ "%PROGRAMFILES%\Teleport Connect\Uninstall Teleport Connect.exe" /S /allusers
# For per-user install:
$ "%LOCALAPPDATA%\Programs\Teleport Connect\Uninstall Teleport Connect.exe" /S /currentuser
````
web/packages/teleterm/src/ui/Vnet/VnetSliderStep.tsx
+7 -6
View File
@@ -95,9 +95,9 @@ export const VnetSliderStep = (props: StepComponentProps) => {
'missing-windows-service' && (
<ErrorText>
VNet system service is not installed. <br />
To use VNet, reinstall Teleport Connect selecting &apos;Anyone
who uses this computer&apos; option. Administrator privileges
will be required.
To use VNet, uninstall Teleport Connect and install it again
selecting &apos;Anyone who uses this computer&apos; option.
Administrator privileges will be required.
</ErrorText>
)}
{installTimeRequirementsCheck.reason.kind ===
@@ -106,9 +106,10 @@ export const VnetSliderStep = (props: StepComponentProps) => {
The VNet system service version does not match the application
version. <br />
This can happen if Teleport Connect is installed both per-user
and per-machine. To use VNet, reinstall Teleport Connect
selecting &apos;Anyone who uses this computer&apos; option.
Administrator privileges will be required.
and per-machine. To use VNet, uninstall both Teleport Connect
installations and install it again selecting &apos;Anyone who
uses this computer&apos; option. Administrator privileges will
be required.
</ErrorText>
)}
{installTimeRequirementsCheck.reason.kind === 'error' && (