Connections

The Connections view

You can initiate a connection to a remote Service using the "Connections" view, which is equivalent to the "Devices" page at the remote.it portal.
  • 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.

 

mceclip1.png

 

Making a New Connection

Click on the "New Connection" button in the upper left corner.

mceclip2.png

You'll see this at the top of the center panel.

mceclip3.png

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.

mceclip4.png

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.

 

mceclip5.png

Connection Details

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.

mceclip1.png

When the connection is active:

mceclip2.png

  • 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.

mceclip3.png

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.

mceclip4.png

If connection logging is enabled, a button will appear called "Show Logs".

mceclip5.png

Click on "Show Logs" to open Explorer windows showing the log file locations.  These can be copied to a support ticket if requested.

Launching a Connection

mceclip1.png

Once the Connection is started, you can launch many configured applications with a single mouse click on the "arrow" icon: mceclip0.png.  The behavior is slightly different on Mac/Linux and Windows OS.

macOS/Linux

  • 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.

Windows

  • https/http connections open the link in your default web browser
  • SSH connections open automatically in PuTTY which must be installed.
  • VNC connections will open in the RealVNC Viewer application which must be installed.
Customizing the Launch URL

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.

mceclip3.png

If you edit and save the Launch URL as shown, then using the Launch button will take you to:

mceclip4.png

Copying the Launch String

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:

mceclip2.png

Customizing the Launch String

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:

mceclip1.png

To use this with WinSCP, change the Copy Command to:

mceclip2.png

Now, when you Copy the SSH String, the following will be placed in your clipboard.

mceclip3.png

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.

mceclip4.png

mceclip2.png

Was this article helpful?
0 out of 0 found this helpful