SocketXP Agent Download & Setup

Install the SocketXP agent and sign in to get started.

Step 1. Download

Identify your CPU architecture and OS type first:

Execute the below command in your device shell.

uname -om

Based on the above command output, choose an appropriate binary from the list below for your CPU architecture type


x86 64-bit

Copy and paste the below command into a shell.

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

x86 32-bit

Copy and paste the below command into a shell.

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

ARM (32-bit)

Copy and paste the below command into a shell.

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

ARM64 (aarch64, arm64, v8)

Copy and 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/linux/arm64/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin

MIPS (32-bit Big Endian)

Copy and paste the below command into a shell.

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

MIPSLE (32-bit Little Endian)

Copy and paste the below command into a shell.

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

MIPS64 (64-bit Big Endian)

Copy and paste the below command into a shell.

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

MIPS64LE (64-bit Little Endian)

Copy and paste the below command into a shell.

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

RISCv64

Copy and paste the below command into a shell.

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

Windows x86 64-bit (Intel, AMD)

Click the link to begin download.


Windows x86 32-bit

Click the link to begin download.

Identify your CPU architecture and OS type first:

Execute the below command in your device shell.

uname -om

Based on the above command output, choose an appropriate binary from the list below for your CPU architecture type


ARM 64-bit (Apple M1/M2 CPU)

Copy and paste the below command into a shell.

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

x86 64-bit (Intel CPU)

Copy and paste the below command into a shell.

curl -O https://portal.socketxp.com/download/darwin/amd64/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 Web Portal.

socketxp login <auth token> --iot-device-name "temp-monitor-12345" --iot-device-group "temp-monitor"

Visit the SocketXP web 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.

Got Questions?

Refer to our getting started guide and troubleshooting guide to find answers to your questions. If you are still stuck, please write to us at: [email protected].