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

Deploy Your Node​

There are two ways to deploy a node — both register it with your workspace using a bootstrap token. Pick whichever you prefer.

Option 1: Generate an install command (Nodes tab)​

Let Expanso Cloud build a ready-to-run install command for you:

  1. Open Expanso Cloud and go to the Nodes tab
  2. Click Add Node
  3. Choose how long the generated token should stay valid
  4. Copy the generated install command and run it on your machine

The command installs Expanso Edge and bootstraps the node. Then skip ahead to Verify Connection.

Option 2: Create a bootstrap token (Keys tab)​

Prefer to install Expanso Edge yourself? Create a token, then run the install commands below.

  1. Open Expanso Cloud and go to the Keys tab
  2. Create a bootstrap token, choosing how long it stays valid
  3. Copy the token, then run the commands below

For additional platforms (Windows, Android, Kubernetes) and advanced options like Docker Compose, see the full Installation guide.

# Install Expanso Edge
curl -fsSL https://get.expanso.io/edge/install.sh | bash

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

Replace YOUR_BOOTSTRAP_TOKEN with the token you copied.

Verify Connection​

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

Your node is connected and ready to run pipelines.

What's Next?​

Next step: Build Your First Pipeline

Troubleshooting​

Node not appearing?

  • Wait 30 seconds and refresh the page
  • Check the node's logs on the host (for a systemd install, journalctl -u expanso-edge; for Docker, docker logs <container>)
  • 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)

For system requirements and all installation options, see the Installation guide.