SocketXP Agent Download & Setup

Install the SocketXP agent and sign in to get started.

Step 1. Download

Linux(x86 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(x86 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

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

Windows

Click the link to begin download.

https://portal.socketxp.com/download/windows/socketxp.exe

Windows(32-bit)

Click the link to begin download.

https://portal.socketxp.com/download/windows32/socketxp.exe

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
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.eyJleHAiOjE1NDk1MT..." --iot-device-name "sensor12345" --iot-device-group "temp-sensor"

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

Connected to SocketXP Cloud Gateway.
Access the TCP service securely using the 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 to SocketXP Cloud Gateway.
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.