The Devices Page

Overview

"Devices" is the default page in remote.it that you see each time you log in.

It gives you a sortable and filterable view of all of the devices registered to your account.

In this article, we will be going over:

  1. Accessing the Devices page from the menu
  2. Connecting to a remote.it Service in the Web Portal
  3. The Actions Menu
  4. Search and Filter Modes

 

1. Access the Devices page from the menu

To get to "Devices" from other pages within remote.it, click on "Devices" in the menu at the left side of the screen.

wp_3.png

 

The Device List's first seven columns

wp_4.png
  1. checkbox used to select devices for bulk actions like sharing, deleting or running a script

  2. "Status" icon which is a green check your device has been detected by our server (online) and a grey dash otherwise (offline).

  3. Device Name which was entered either when using the interactive installer, or set by one of the bulk registration methods. Click on the Device Name to open the Services Dialog which shows the links to individual services on your device.

  4. Sharing Status.

  5. Hardware ID (HWID) shared by all the Services on a Device.

  6. The device's internal (LAN) IP address.

  7. The device's external (public) IP address.

 

The Status Columns

The 5 status columns A through E can be used to get information from Devices using Device Scripting.

wp_5.png

 

Category Columns

The Category columns contain optional user-specified information entered with during Bulk Registration or set manually using the "Actions" menu "Set Category" action.

wp_6.png

 

2. Connecting to a remote.it Service in the Web Portal

Quick Connect

Once you're on the Devices page, you will see all of the Devices associated with your account. There will be a Connect button to the left of the Device name. If the Devices is online, this button will be green, otherwise you will see "Offline" against the background.

Click on the "Connect" button and a drop-down menu of all that Device's Services will appear. Click on the desired Service to initiate the connection. Skip ahead to "Connection Dialog".

wp_7.PNG

 

Advanced Connect

When you click on the Device Name on the Devices page, you'll see the Device Services Dialog. This also shows additional information about your Services which

wp_8.png

 

Connection dialog

For non-web connections, the connection will return a hostname and port value which can be used on a command line or in a GUI application depending on what you are doing. The example below is for an SSH connection.

wp_9.png

Reverse proxy: For web applications made using the remote.it web portal, the reverse proxy URL opens automatically in a new browser tab. Reverse proxy connections do not remap the port value.

wp_10.png

See the "Applications" section for more detail about using remote.it proxy connections with different types of applications.

 

3. The Actions Menu

The following is a summary of available Actions in remote.it. In the Devices view, Devices must first be selected to apply any Actions. Use the checkbox in the leftmost column to select Device(s) first, then apply an Action to the selected Devices. Actions may be applied to one or more Devices.

The following Actions are available in remote.it and described below:

  1. Share
  2. Unshare
  3. Execute Script
  4. Set Category
  5. Clear Status
  6. Transfer Device
  7. Delete
  1.  
wp_11.png

Share

Sharing allows any Device to be shared with one or more remote.it users. Enabling remote.it Sharing grants permission to access a device(s) in your account. This is useful for allowing teams of people (each with their own login credentials) to have access to a single device. The device owner has complete control of what other remote.it accounts may connect. In order to share access to a device in your account, the other user must have a valid remote.it user account. Once the device is shared, the Share column icon will change indicating that Device is shared to another user. See the sample screenshot below.

Note:

There is a delay from the time you Share a device(s) to another user until the device appears in their Manage Devices view. Please be patient and check your email for confirmation that the request was received and is being executed. It might take as long as 5-10 minutes after receipt of email notification until the Share status is updated and shown in the remote.it Manage Devices grid.

 

Unshare

When a shared Device is no longer meant to be Shared, use this Action to remove the sharing privileges previously granted.

Note:

There is a delay from the time you remove Sharing from a device(s) until the device disappears from the other User's Manage Devices view. Please check your email for confirmation that the Remove Sharing request was received and is being executed. It might take as long as 5-10 minutes after receipt of email notification until the Share status is updated and shown in the remote.it Manage Devices grid.

 

Execute a Script

Scripts may be used to perform specific actions on your devices if they support scripts. The Status columns can be updated to reflect the Script actions that were performed.

 

Set Category

Category columns allow you to add additional arbitrary information to the selected Devices. Once you add the details, the Category columns can be used to Sort and Group Devices. Example: Add "San Francisco" to selected Devices in Category A column. Now you can sort, group or filter devices by "San Francisco".

 

Clear Status

After running a Script which writes status info into the Status Columns, you may choose to Clear a Status Column if it is no longer required. Clear Status does not impact the Script that was previously executed. It simply clears the Status Column.

 

Transfer Device

Transfer the selected device(s) to another remote.it account. After the transfer is completed, you will no longer see the Device in your account, and it will appear in the selected Contact's account.

Note:

Device transfer can be performed only on the owner's device. Devices shared from other accounts can not be transferred. Also, please be aware that the share information will be cleared with the transfer. 

Finally, transfers cannot be undone, so make sure you have selected the correct device(s) and the correct account to receive the device(s).

 

Delete

Remove Device(s) from your device list. The Device must be offline to remove it from the Device list. Please note this Action does NOT remove (uninstall) any software from your device. In order to uninstall or remove all remote.it software from your device, use the Debian dpkg utility:

If you installed the remoteit package

sudo dpkg --purge remoteit

 

If you installed the connectd package

sudo dpkg --purge connectd

 

If you wish to re-install Services on a device which was deleted from your account using the web portal Actions menu, see this Help Article.

 

4. Search and Filter Modes

Accounts with a large number of devices can speed up access using this mode.

The standard "Devices" page in remote.it works well if you have up to a few dozen devices, but beyond that it becomes difficult to find a specific device without scrolling around. Make your life easier by using the Search/Filter mode.

 

Filter mode

Filter mode finds the entered string anywhere in the Device Name and is not case sensitive. This mode is the default mode of your account. Filter mode is enabled when "Device Search Only" is not checked, as shown here:

wp_12.png

This example shows the filter term "timer" matching a single Device Name, "Game Timer Pi 70".

wp_13.png

This shows the filter term "device" matching a number of Device Names.

wp_14.png
wp_15.png

As you are typing in a Filter term, it does not become active until the third character you enter.

 

Search mode

Search mode doesn't display any Devices until you enter the term which you wish to be matched in the Filter box.

First, you must select the "Device Search only" checkbox:

wp_16.png

Note that no Devices are shown.

wp_17.png

Enter a search term and press Enter.

wp_18.png
 

To match a string anywhere in the Device Name, add an asterisk at the beginning of the search term.

If there is no match, you'll see this warning:

wp_19.png

If there are more than ten matches for the search term, you'll see:

wp_20.png

If this happens, add additional characters to the search term to narrow it down.

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