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
- Open your network in Expanso Cloud
- Click Add Node (in the Nodes tab)
- Copy the bootstrap token displayed
- Keep this window open -- you'll need the token below
Note: Bootstrap tokens are single-use and expire after 24 hours.
Install & Bootstrap
Choose the quickest path for your platform. For additional platforms (Windows, Android, Kubernetes) and advanced options like Docker Compose, see the full Installation guide.
- Linux / macOS
- Docker
# 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
docker run -d \
--name expanso-edge \
--restart unless-stopped \
-e EXPANSO_EDGE_BOOTSTRAP_TOKEN=YOUR_BOOTSTRAP_TOKEN \
ghcr.io/expanso-io/expanso-edge:nightly
Replace YOUR_BOOTSTRAP_TOKEN with the token from Step 1.
Verify Connection
- Return to Expanso Cloud
- Navigate to the Nodes tab in your network
- Your node should appear (usually named after your hostname)
- 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 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)
For system requirements and all installation options, see the Installation guide.