Getting StartedQuickstarts
Quickstarts
Framework-specific quickstarts for connecting to CloudSignal in under five minutes.
Pick the runtime that matches where your code runs. Each quickstart gets you connected, subscribed, and publishing in under five minutes.
Next.js
Server-side tokens with real-time React components
Python
paho-mqtt and aiomqtt for backend services
Node.js
The CloudSignal SDK for backend services and integrations
Before you start
You'll need:
| Requirement | How to get it |
|---|---|
| A CloudSignal account | Sign up free |
| An MQTT user | Create one in the dashboard under MQTT Users |
| Your organization ID | Found in Settings -> Organization |
Connection details
| Parameter | Value |
|---|---|
| MQTT over TLS | mqtts://mqtt.cloudsignal.app:8883 |
| MQTT over WSS | wss://connect.cloudsignal.app:18885/ |
| Username format | your_username@your_organization_id |
Quick test with MQTTX
Before writing code, validate your credentials with MQTTX:
- Open MQTTX
- Create a new connection:
- URL:
mqtts://mqtt.cloudsignal.app:8883 - SSL/TLS: enabled
- Username:
your_username@your_org_id - Password:
your_password
- URL:
- Click Connect
- Subscribe to
test/# - Publish to
test/hellowith the payloadHello CloudSignal!
If this works, you're ready to integrate into your application.
Choosing your approach
| Workload | Recommendation |
|---|---|
| Browser apps (React, Vue, and so on) | Connect to wss://connect.cloudsignal.app:18885/ with server-side tokens. Start with the Next.js quickstart. |
| Backend services (Node.js, Python, Go) | Connect to mqtts://mqtt.cloudsignal.app:8883 with permanent credentials. See Python or Node.js. |
| Embedded devices | Connect to mqtts://mqtt.cloudsignal.app:8883 with unique credentials per device. See the SDK catalog. |