The Connections view
- Current - existing connections. Click on a Connection in the center panel to see its status and details in the right panel.
- Others - shows connections to Services in your account made by other accounts (to shared Services) as well as peer to peer connections from one Device to a Service on another Device.
- Recent - connections which were made recently but aren't currently active are shown here, for ease of reconnecting.
Click on the "New Connection" button in the upper left corner.
You'll see this at the top of the center panel.
Click on the "down" arrow to display the list of Services in your account which are currently online. Select the one you wish to connect to.
Now click on the dark grey "Create Connection" button at the top of the right panel. Once the connection succeeds, the button will turn blue and display "Stop Connection". The Connection details will be shown below.
Click on the "Stop Connection" button to terminate the Connection.
- Info shows you the Service Details for the current Connection..
- Copy copies the launch string to the clipboard.
- Launch will open the associated application, if any, and attempt to complete the connection.
- Address shows the current URL and port for this connection.
Connection shows whether the connection is Idle or mode details is it is active.
When the connection is active:
- Connection Name - the name of the Connection
- Port - configured port for this connection
- Launch URL - the URL that will be launched when you click the "Launch" icon. This can be customized.
- Copy Command - the string that will be copied to the clipboard when you click on the "clipboard" icon. This can be customized.
Connections must be stopped in order to edit the following settings.
- Idle Timeout - how long to wait after there are no active tunnels before terminating the connection. This can help reduce data charges of your targets are on a cellular connection. Set to "0" to never terminate.
- Routing - what type of connection to make
- Proxy Only - only attempt a proxy connection.
- Peer to peer only - only attempt a peer to peer connection.
- Peer to peer with proxy failover - try a peer to peer connection first, then try a proxy connection if that fails.
- Local Network Sharing - see LAN Sharing
- Connection Logs - enable if needed in order to debug connections.
If connection logging is enabled, a button will appear called "Show Logs".
Click on "Show Logs" to open Explorer windows showing the log file locations. These can be copied to a support ticket if requested.
Once the Connection is started, you can launch many configured applications with a single mouse click on the "arrow" icon: . The behavior is slightly different on Mac/Linux and Windows OS.
- Launching works through your browser's "deep linking" feature.
- https/http connections open the link in your default web browser
- SSH connections open automatically in terminal
- VNC connections will open in the configured VNC or screen sharing application. Note that macOS screen sharing is based on VNC.
You may wish to customize the Launch URL to go by default to a specific page at the web server you are connecting to. One such example is the DNS filtering application "Pi-Hole", whose main dashboard is at /admin under the IP address:port.
If you edit and save the Launch URL as shown, then using the Launch button will take you to:
In some cases, you may wish to use the connection for something besides the default applications. For example you might want to use an SSH Connection in Filezilla or WinSCP. You can copy the launch string by clicking on the "clipboard" icon instead:
In this case, you may simply want the connection URL and port rather than the default connection string which is intended to copy/paste into your terminal.
The default Copy Command for an SSH Connection is:
To use this with WinSCP, change the Copy Command to:
Now, when you Copy the SSH String, the following will be placed in your clipboard.
This can be pasted into the Connection dialog of WinSCP. It may be necessary to move things around to suit the UI of the application you are using. Note that with remoteit Desktop, you can save the connection in your third party application and then use it again later without having to copy and paste it again and again.