Skip to main content
Hologram Spacebridge lets you create authenticated SSH tunnels to devices on the Hologram cellular network.

​
Enable secure device tunneling

You can enable tunneling for a single SIM or for multiple SIMs from the Dashboard.
Note: You must configure your device’s network interface to support inbound connections.

​
Generate an SSH key and upload to the API

Run these commands from your local machine. 
ssh-keygen -f spacebridge.key -b 4096 -t rsa
Upload your public key (ends with .pub) to the Hologram API. Replace YOUR_HOLOGRAM_API_KEY with your Dashboard API key. 
PUBKEY=$(cat spacebridge.key.pub)
curl -X POST \
  -H "Content-Type: application/json" \
  -u apikey:YOUR_HOLOGRAM_API_KEY \
  -d '{"public_key":"'"$PUBKEY"'"}' \
  "https://dashboard.hologram.io/api/1/tunnelkeys"

​
Open the tunnel with SSH port forwarding

Replace link123 with your device’s link ID. 22 is the device port; 5000 is your local forwarded port. 
ssh -p 999 -L 5000:link123:22 -N -i spacebridge.key htunnel@tunnel.hologram.io -v

Enable/disable tunneling keys via API

View tunneling keys via API