Create Tunnel
🎬 Video Tutorial: Creating a Tunnel (3 mins)
📋 Step-by-Step: Creating a Tunnel
Log in to the Edge Signal platform
Navigate to the sidebar near the top of the SERVICES section where you’ll find the PROJECTS menu
Select the project containing the device to which you wish to connect
Navigate in the sidebar to the Remote Control dropdown menu, and select Tunnels
Open a new tunnel by clicking the New Session button (top right-hand corner)
A dialogue box will open showing all of the available devices on the left-hand side
Select the device to which you wish to connect
Use the default port listed, or another port of your choice
Note: If choosing a port other than the default, ensure this port is not currently in use on the host connecting machine
Enter the duration (mins) you would like the tunnel open (the default maximum duration is 12 hours)
Click the Create button
Once the tunnel has been created a dialogue box will open displaying an automatically generated command to run on your host connecting machine
Click the copy icon to copy the command to the clipboard
Open a terminal on your connecting machine (ensure you are running a recent version of macOS or Ubuntu
Run the command
Note: Running the command will open a local proxy on your host machine that is listening for connections on the specified port
Either a password authentication method or a public key-based authentication method can be used to connect
You now have successfully opened an SSH connection to the remote device, allowing you to run commands on the device such as checking status of the signal service
If another authorized user wishes to establish a connection with the device using this tunnel, they can click on the device info icon and select Rotate Access Token to generate a new command which can then be used to reach the device using the steps we just covered
Note: Only one user at a time can access a device via the open tunnel. Once a new user selects Rotate Access Token, the initial token expires immediately, and that connection is broken
Closing a Tunnel
The tunnel will close automatically when the duration you entered earlier expires. But should you want to close it immediately, simply click on the device tunnel info icon and click Delete in the Close tunnel dialogue box
Last updated
