Skip to content

Connect: Improve docs about dual-mode installations #65267

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gzdunek merged 3 commits into from
Apr 1, 2026
Merged

Connect: Improve docs about dual-mode installations #65267

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
04ff55b
Connect: Improve docs about dual-mode installations
gzdunek Apr 1, 2026
ccf5741
Fix path
gzdunek Apr 1, 2026
7412db6
Clarify app uninstalling
gzdunek Apr 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions docs/pages/connect-your-client/teleport-clients/teleport-connect.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down
17 changes: 13 additions & 4 deletions docs/pages/includes/uninstall-teleport-connect-windows.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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`

Comment thread
gzdunek marked this conversation as resolved.
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
Comment thread
gzdunek marked this conversation as resolved.

# For per-user install:
$ "%LOCALAPPDATA%\Programs\Teleport Connect\Uninstall Teleport Connect.exe" /S /currentuser
````
13 changes: 7 additions & 6 deletions web/packages/teleterm/src/ui/Vnet/VnetSliderStep.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 ===
Expand All @@ -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' && (
Comment thread
gzdunek marked this conversation as resolved.
Expand Down
Loading