Download & Install the SocketXP Agent

Easily set up the SocketXP agent to unlock secure IoT connectivity. Install, sign in, and start managing your devices effortlessly.

Step 1: Download & Install the SocketXP Agent

Identify your CPU architecture and OS type first:

Execute the below command in your device shell.

uname -om
Copy Copy

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 -LO https://portal.socketxp.com/download/linux/amd64/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
x86 32-bit:

Copy and paste the below command into a shell.

curl -LO https://portal.socketxp.com/download/linux/386/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
ARM (32-bit):

Copy and paste the below command into a shell.

curl -LO https://portal.socketxp.com/download/linux/arm/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
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 -LO https://portal.socketxp.com/download/linux/arm64/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
MIPS (32-bit Big Endian):

Copy and paste the below command into a shell.

curl -LO https://portal.socketxp.com/download/linux/mips/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
MIPSLE (32-bit Little Endian):

Copy and paste the below command into a shell.

curl -LO https://portal.socketxp.com/download/linux/mipsle/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
MIPS64 (64-bit Big Endian):

Copy and paste the below command into a shell.

curl -LO https://portal.socketxp.com/download/linux/mips64/socketxp && chmod +wx socketxp && sudo mv socketxp /usr/local/bin
Copy Copy
MIPS64LE (64-bit Little Endian):

Copy and paste the below command into a shell.

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

Copy and paste the below command into a shell.

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

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"
Copy Copy

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].