The below example shows you how to download and run connectd on your machine. The example is for Mac OSX, but we have many other versions available.
# Download the most recent release (this is for OSX)wget https://github.com/remoteit/misc_bins_and_scripts/raw/master/connectd/connectd.x86_64-osx# Make it executablechmod u+x connectd.x86_64-osx# Move to somehwere on your PATHmv connectd.x86_64-osx /usr/local/bin/connectd
connectd -c \BASE_64_USER \BASE_64_PASSWORD \DEVICE_UID \BIND_PORT \ENCRYPTION_MODE \LOCAL_HOST_ADDRESS \MAX_OUTSTANDING
Your Base64 encoded username (probably your email)
Your Base64 encoded remote.it password
The ID (also called address) of the device you want to connect to
The port you want to bind the connection to on your local machine (eg 3000)
The level of encryption to use. Choices are:
NOTE: Please use mode 2. Modes 0 and 1 are not secure.
The address to bind to on your local network. This is normally either 127.0.0.1.
connectd -s -c \eW91cm5hbWVAZXhhbXBsZS5jb20= \ # Base64 encoded username/emailc3VwM3JzZWtyZXQh \ # Base64 encoded password80:00:00:00:00:00:00:F1 \ # Device ID on remote.itT3000 \ # Port to bind to, prefixed with "T"2 \ # Encryption mode = XXTEA127.0.0.1 \ # Localhost address12 # Max outstanding
-d run in daemon mode, meaning keep the connection running in the background
-s print out status information
To run merge the command into one line:
connectd -c bXluYW1lQGdtYWlsLmNvbQ== cGFzc3dvcmQ= 80:00:00:05:46:03:B0:1D 2 127.0.0.1 10
It it worked you will see output confirming:
...Starting Proxy on port 33000 on index 1.Proxy started.
Most of the parameters are the same as with a username and password except for the service_authhash and ip restriction settings indicated below:
connectd -peW91cm5hbWVAZXhhbXBsZS5jb20= \16509BA77F1AF0FBAA7BBB3B2B992ED90308CAB9 \ # service_authhash80:00:00:00:00:00:00:F1 \T3000 \2 \127.0.0.1 \0.0.0.0 \ # 0.0.0.0 allows all or enter and IP to restrict to10
To get an service_authhash from remote.it you need to use the login API
If running connectd with the
-s flag and connectd exits for any reason, it will emit a message on stdout in the format:
!!exit [CODE] : MESSAGE where the code is a numerical code (see below) and a message describing what happened.
process lifetime expired
shutdown packet received
termination from windows signal
(all platforms except windows)
Disabled By User Configuration
bad user specified (probably not possible at this time)
authentication error (may be multiple because of retry)
auto connect failed (Initiator p2p connect failed)
Initiate session create failed (initiator p2p connect failed !autoconnect)
Connection To remot3.it Service has Timed Out
cannot get UID from service (not a initiator side error)
Cannot Bind UDP Port (UDP P2P port)
Cannot Bind Proxy Port (initiator port)
connection to peer closed or timed out
connection to peer failed (failed p2p connect)
unknown reason (this should not happen)
user console exit
Please see our guide on troubleshooting connections: