HomeDocumentationAPI Reference
Log In
These docs are for v17. Click to read the latest docs for v33.

Connecting via the PrivX GUI

To connect to targets via the PrivX GUI:

  1. Log into the PrivX GUI using your PrivX account.

  2. On the ​Home​ page under ​New Connection​​, provide target details (such as the target-host address) to receive suggestions about available targets, then select a target to connect to it. Your accessible targets are also listed and selectable on the ​Connections→Available Hosts​​ page.

    You may alternatively go to ​Connections→Manual Connection​ page and manually specify your target. The user must have the ​connections-manual​​ permission to use this method.

📘

Note

Connections via ​Connections→Available Hosts​ are authenticated according to the role-based rules and the enabled authentication methods. Connections via ​Connections→Manual Connection​​ always prompt for password.

You may need to adjust locale settings for keyboard commands to be transferred correctly.

📘

Note

Quickly access a recent target from the ​Home​ page by clicking an entry under ​Recent connections​​, or on the ​Connections→Connection History​​ page.

SSH GUI Usage

Open multiple terminals

  • On the tab bar, click ​+​​ to open additional terminals.

Copy-paste

  • On a Mac, you can select text and use Command-C and Command-V to copy-paste, or right-click and use the context menu.

  • On a Windows or Linux you can select text and right-click to use the context menu. Alternatively you can select some text, then press Ctrl-C or Ctrl-Insert to copy. Paste using Ctrl-V or Shift-Insert.

    📘

    Note

    To use applications that specifically require Ctrl-V for other things than pasting, enable ​Send Ctrl-V to server​ under terminal ​Settings​​. Enabling this setting also disables pasting with Ctrl-V.

  • On Chrome and Edge you can also use Ctrl-Shift-C to copy and Ctrl-Shift-V to paste.

  • The left Alt (option on a Mac) key also functions as the Meta key (for example in Emacs).

Find in terminal

Use the following commands to activate terminal-specific search:

  • On a Mac, use Command-F while focused in the terminal.

  • On Windows or Linux, use Ctrl-Shift-F while focused in the terminal.

Use arrow keys to navigate between next/previous matches. Press Esc or X to close the terminal-specific search.

Transfer files

You can upload, download, and remove files from the ​File Transfers​​ tab.

To change directory, click a ​directory​ or ​​​. You can perform additional actions on files via their ​​​​​​ menus.

  • ​​To download a file​​: Double-click the file, or perform a Download action via its ​​​​​​​​​​​​ menu.

  • ​​To upload a file​​: Drag-and-drop the file to the file-transfer view. Alternatively, click ​Upload​​ next to the file-transfer view and select the local file to upload.

Change text, locale and theme

From the ​Settings​​ tab, you can set the font size, character encoding, and the locale used for the connection. You can also switch between a dark and a light theme.

Open URLs

To open HTTP/HTTPS links in a new tab on Windows or Linux, hold ​Ctrl​ and double-click the link. To open links on Mac, hold ​Command​​ and double-click.

RDP GUI Usage

Copy-paste

When clipboard synchronisation is enabled, you can directly copy-paste between your host and the target host.

Otherwise, place the text into the ​Clipboard​ tab, then paste normally on the target host. Text copied from the target host is automatically made available in the ​Clipboard​​.

To check clipboard-synchronisation support, and to toggle it on/off, see Settings.

📘

Note

Clipboard synchronisation is only available on Edge, Safari, and Chrome browsers.

Transfer files

Upon connecting, PrivX automatically mounts a network drive called ​Transfers on PrivX​​ to the target host. File downloads and uploads must be performed via this network drive.

You can copy files from the target host to ​Transfers on PrivX​​, then download them from the ​Files​ tab. Similarly, you can upload files by placing them to ​Transfers on PrivX​ on the ​Files​​ tab, then move the file to another location on the target host.

  • ​​To download a file​​: Double-click the file, or perform a Download action via its ​​​ menu.

  • ​​To upload a file​​: Drag-and-drop the file to the file-transfer view. Alternatively, click ​Upload​​ next to the file-transfer view and select the local file to upload.

Set keyboard layout

To change your keyboard layout, go to the ​Settings​​ tab, select your layout, then restart the connection to apply the changes. Set this to match the keyboard layout defined for the server (not the client-side layout).

Fullscreen view

To toggle fullscreen view, click ​​.

📘

Note

You may need to re-establish the RDP connection after changing the screen size.

Send Special Commands

To send special commands such as Ctrl+Alt+Del, click ​Send Keys​​, then select the command to send.