You can use the connectd_installer script to interactively configure remote.it on the current device to access a TCP service running on a different device on the same LAN.
At the command prompt, run
$ sudo connectd_installer
Assuming that you see the "Sign In Menu" shown above, type the numeral 1 followed by the ENTER key to log in.
If this is the first time you have run the installer on this device, or if you removed all previously installed services, you will have to supply a unique "Device Name" as shown below. If you've already set the Device Name, skip ahead to "Adding a New LAN Service".
Enter the Device Name. If it is valid and doesn't duplicate another Device or Service name in your account, it will be accepted and will take a few moments to register. After that you will see the Main Menu below the list of Installed Services. At this point, no services are installed.
Adding a new LAN Service
Choose option 2 to install a remote.it service to a TCP server application running on a different device on the same LAN. The installer will ask you for the IP address or mdns address of the device. Enter that information then press the ENTER key.
Next you will see the "Protocol Selection Menu". In this example we will demonstrate adding a remote.it service to connect to an SSH server running on TCP port 22 on your device.
We've done our best to supply you with the default port used by the most common TCP applications (22 for ssh, 80 for a web server, and 5900 for VNC), but here's your opportunity to change that if needed. We'll choose "y" to continue and use the default port of 22 for ssh.
When the new service finishes registration, you will see the "Installed remote.it Services" table:
This table shows:
- Service Name - the name you gave to this service, which must be unique in your account
- Protocol - the protocol you selected
- LAN Address - "localhost" for applications on this device, or an IP address or MDNS address if configured to connect to a TCP service on a different device on your LAN.
- Port - the port you selected
- Application - if an application was detected at the port you specified, you will see "OK" followed by the name of the application. In this example that application is the "dropbear" ssh server. If there is no service detected at that port, you will see "not detected". Note that if you set up a service for a LAN application instead, you will only see "OK" or "not detected" in this column - the application name cannot be determined on a separate device.
- Device Name - the name you assigned to your device
- Platform - identifies the architecture and OS specific daemon being used
- Hardware ID - an identifier which is assigned to all services on a given device which allows them to be grouped together in the remote.it User Interface.
At this point, you can add more services, remove a single remote.it service, or remove all remote.it services including the Device Name in one easy step (be careful! we do ask you if you're sure).
When you are done, choose option 5 to exit and return to the command prompt.