Skip to content
Constellation

Quick Start

Quick Start

This guide will get you posting telemetry in under 5 minutes.

1. Install the CLI

Run the installer:

Terminal window
curl -fsSL https://dev.constellation-io.com/install.sh | sh

Or install via pip:

Terminal window
pip install constellation-cli

2. Authenticate

Log in with your operator credentials:

Terminal window
constellation login

This opens your browser for authentication. After logging in, your credentials are stored locally at ~/.constellation/credentials.

Alternatively, set your token directly:

Terminal window
constellation config set token YOUR_API_TOKEN

3. Post Your First Telemetry

Post a single telemetry update:

Terminal window
constellation telemetry post \
  --node sat-001 \
  --type satellite \
  --snr 25.5 \
  --latency 12.3 \
  --throughput 45.6

Or post from a JSON file:

Terminal window
constellation telemetry post -f telemetry.json

Example telemetry.json:

{
  "node_id": "sat-001",
  "node_type": "satellite",
  "timestamp": "2026-01-16T20:00:00Z",
  "snr_db": 25.5,
  "latency_ms": 12.3,
  "throughput_gbps": 45.6,
  "utilization": 0.75,
  "queue_depth_gb": 15.2
}

4. Verify Your Data

Check that your telemetry was received:

Terminal window
constellation topology get

This returns the current network graph with your node’s latest metrics.

5. Set Up Automated Posting (Optional)

Configure a cron job to post telemetry automatically:

Terminal window
constellation daemon start --interval 60

This posts telemetry every 60 seconds. View daemon status:

Terminal window
constellation daemon status

Using cURL Directly

If you prefer raw HTTP calls:

Terminal window
# Set your token
export TOKEN="your-api-token"


# Post telemetry
curl -X POST https://api.constellation-io.com/api/v1/telemetry \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "node_id": "sat-001",
    "node_type": "satellite",
    "timestamp": "2026-01-16T20:00:00Z",
    "snr_db": 25.5,
    "latency_ms": 12.3,
    "throughput_gbps": 45.6
  }'

Response:

{
  "success": true,
  "message": "Telemetry data received successfully",
  "telemetry_id": "tel-sat-001-1705434000",
  "received_at": "2026-01-16T20:00:00.123Z"
}

Next Steps