SocketXP Agent Download & Setup

Install the SocketXP agent and sign in to get started.

Step 1. Download

Copy paste the below command into a shell.

curl -O https://portal.socketxp.com/download/darwin/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin

Linux(32-bit)

Copy paste the below command into a shell.

curl -O https://portal.socketxp.com/download/linux32/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin

Linux(64-bit)

Copy paste the below command into a shell.

curl -O https://portal.socketxp.com/download/linux/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin

Windows

Click the link to begin download.


Windows(32-bit)

Click the link to begin download.

ARM (32-bit)

Copy paste the below command into a shell.

curl -O https://portal.socketxp.com/download/arm/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin

ARM64 (aarch64, arm64, v8)

Copy paste the below command into a shell for 64-bit OS. Do not use this binary for Raspbian OS. Raspbian OS is still 32-bit only. So use the ARM 32-bit binary above for Raspbian OS.

curl -O https://portal.socketxp.com/download/arm64/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin

Copy paste the below command into a shell.

docker pull expresssocket/socketxp

You'll find more instructions on how to run SocketXP agent Docker container here.

Step 2. Authenticate

Execute the following command to connect the SocketXP agent with the SocketXP Cloud Gateway, using the unique auth-token provided to you in the SocketXP Portal.

socketxp login "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1NDk1MTg0MDAsImlkIjoiZ2F..."

Visit the SocketXP portal to get your auth token. Don’t have an account ? Sign up for free to receive your auth-token.

Step 3. Create secure tunnels

Once you have authenticated the SocketXP agent with the SocketXP Cloud Gateway, you can begin creating secure tunnels to your private localhost network services.

Usecase #1: IoT Remote SSH Access Over the Internet:

For example, to enable remote SSH access to your Raspberry Pi or IoT devices in your office or home network, execute the below command.

$ socketxp connect tcp://localhost:22 --iot-device-id DEV00032341234

TCP tunnel [test-user-3adekh4r] created.
Access the tunnel using SocketXP agent in IoT Slave Mode

Now you could remote SSH into your Pi or IoT device over the internet from the SocketXP Web Portal

Usecase #2: Public URL for your IoT Web Service:

For example, to remotely access a web service running on your localhost network (say, port 8080) over the internet, execute the below command. The command creates a secure HTTP tunnel to your localhost web service.

$ socketxp connect http://localhost:8080
Connected.
Public URL -> https://test-user-a29dfe42e3.socketxp.com

After you have successfully created the HTTP tunnel, use the public URL provided by SocketXP ( https://test-user-a29dfe42e3.socketxp.com ) to access your localhost web service from anywhere in the world.