Skip to main content

Deploy Your First Node

An edge node runs on your infrastructure and executes data pipelines. Let's deploy one to your network.

Generate Bootstrap Token​

  1. Open your network in Expanso Cloud
  2. Click Add Node (in the Nodes tab)
  3. Copy the bootstrap token displayed
  4. Keep this window open - you'll need the install command

Note: Bootstrap tokens are single-use and expire after 24 hours.

Install Expanso Edge​

Choose your platform:

# Download and install
curl -fsSL https://get.expanso.io/edge/install.sh | sh

# Bootstrap the node with your token
expanso-edge bootstrap --token YOUR_BOOTSTRAP_TOKEN

Replace YOUR_BOOTSTRAP_TOKEN with the token from Step 1.

Verify Connection​

  1. Return to Expanso Cloud
  2. Navigate to Nodes tab in your network
  3. You should see your node appear (usually named after your hostname)
  4. Status shows Connected (green)

🎉 Your node is connected!

What's Next?​

👉 Build Your First Pipeline

Troubleshooting​

Node not appearing?

  • Wait 30 seconds and refresh the page
  • Check daemon logs: expanso-edge logs
  • Verify network connectivity to cloud.expanso.io

Bootstrap failed?

  • Ensure token is correct (no extra spaces)
  • Generate a new token if expired
  • Check firewall allows outbound HTTPS

Node shows offline?

  • The daemon may have stopped - restart with expanso-edge run
  • Check system resources (CPU, memory, disk)