You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Download the latest release from [GitHub](https://github.com/pomerium/desktop-client/releases).
73
73
74
74
- **Windows**: The installer `.exe` file will install and open the Desktop Client. Right click on the system tray icon to interact with it.
75
75
- **Linux**: We provide Linux binaries as `.AppImage` files, which can be executed in place or managed with a tool like [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher). Interact with the client from the system tray icon.
76
76
- **macOS**: Open the `dmg` and move the binary to **Applications**. Interact with the client from the system tray icon.
77
77
78
-
<details>
79
-
<summary>Autostart Pomerium Desktop</summary>
80
-
81
-
If you want Pomerium Desktop to start automatically when you log in to your computer, follow the steps below for your operating system.
82
-
83
-
<Tabs>
84
-
<TabItem value="windows" label="Windows">
85
-
86
-
#### Autostart for all users
87
-
88
-
Copy the shortcut for the Pomerium Desktop app into `C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup`.
89
-
90
-
#### Autostart for your user
91
-
92
-
Copy the shortcut for the Pomerium Desktop app into `C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup`, replacing `username` with your username.
93
-
94
-
---
95
-
96
-
Windows 11 also offers a GUI method, documented by [windowscentral.com](https://www.windowscentral.com/how-launch-apps-automatically-during-login-windows-11)
97
-
98
-
</TabItem>
99
-
<TabItem value="mac" label="MacOS">
100
-
101
-
1. From **System Preferences**, select **Users & Groups**.
102
-
103
-
1. Click **Login Items** near the top, then the **+** button towards the bottom of the window.
104
-
105
-
1. Select Pomerium Desktop from the Applications folder.
106
-
107
-
</TabItem>
108
-
<TabItem value="gnome" label="Linux (Gnome)">
109
-
110
-
The easiest way to autostart user applications in the Gnome Desktop Environment is by using the Tweaks application. Gnome documents this process well, so we won't replicate it here. See [Gnome's documentation](https://help.gnome.org/users/gnome-help/stable/shell-apps-auto-start.html) for more information.
111
-
112
-
</TabItem>
113
-
<TabItem value="kde" label="Linux (KDE)">
114
-
115
-
KDE's documentation covers auto-starting applications well: see [System Settings/Autostart](https://userbase.kde.org/System_Settings/Autostart) from the KDE UsersBase Wiki for more information.
116
-
117
-
</TabItem>
118
-
</Tabs>
119
-
120
-
</details>
121
-
122
78
### Add a Connection
123
79
124
-

80
+

125
81
126
-
**Name**: A local name for the route.
82
+
**Name**: A local name for the route
127
83
128
84
**Destination**: Matches the [From](/docs/reference/routes/from) value of the route, without the protocol. Always include the port specified in the route, and do not include the `https://` protocol.
129
85
130
86
**Local Address**: The local address and port number from which to access the service locally. If left blank, the client will choose a random port to listen to on the loopback address.
131
87
132
-
In most cases, you only need to specify the port (ex: `:2222`), and the client will listen on all available local addresses.
133
-
134
-
**Tags**: Use tags to sort and organize your TCP routes.
88
+
**Tags**: Customizable tags to sort and organize TCP routes
135
89
136
90
:::note Long-lived connections behavior
137
91
@@ -141,18 +95,20 @@ In most cases, you only need to specify the port (ex: `:2222`), and the client w
141
95
142
96
---
143
97
144
-
#### Advanced Settings
98
+
### Advanced Settings
99
+
100
+

145
101
146
102
**Pomerium URL**: The Pomerium Proxy service address. This is required if the **Destination URL** can't be resolved from DNS or a local `hosts` entry, or if the Proxy service uses a non-standard port.
147
103
148
104
**Disable TLS Verification**: Allows untrusted certificates from the Pomerium gateway
149
105
150
-
**Client Certificate & Certificate Key File or Text**: For routes that require client certificates for [mTLS](/docs/concepts/mutual-auth.md), you can provide the certificate and key file to the Pomerium Desktop client.
106
+
**Client Certificates**: The client certificates options allow you to **set client certificates manually** or to [**search the OS certificate store**](/docs/capabilities/tcp#client-certificates) for trusted CA names. Use these options to add client certificates to routes that enforce [mTLS](/docs/concepts/mutual-auth).
0 commit comments