Skip to main content
Fleets and devices are the core operational objects in Golain. Everything else — Omega, telemetry, SSH — attaches to a device inside a fleet within a project.

Fleets

Create a fleet

  1. Open your project → FleetsCreate fleet.
  2. Provide a name and optional description.
  3. Save.
Fleets are unique by name within a project. You can also create fleets via CLI:

List and delete

  • Console: fleet list shows device counts and metadata.
  • CLI: platform-tui fleets list · delete with platform-tui fleets delete <name-or-id> --yes

Devices

Register a device

  1. Open a fleet → DevicesAdd device.
  2. Set name and type (typically mqtt).
  3. Save and open the device detail page.
CLI equivalent:

Device detail

The detail view shows: Copy MQTT settings when configuring Omega or third-party MQTT clients. CLI:

Tags

Tags are project-scoped strings attached to devices. Console: device detail → Tags → add/remove. CLI:
Project-level tag CRUD: platform-tui tags list|create|delete.

Delete a device

Removing a device revokes its MQTT credentials and frees the name within the fleet. Confirm in UI or use:

Monitoring connectivity

  • Fleet view — aggregate online/offline counts.
  • Event stream — live connect/disconnect and MQTT access events.
  • platform-tui TUIStats & graphs screen shows Unicode gauge bars for fleet connectivity.

Edge enrollment

For Golain-managed certificate enrollment instead of manually copying MQTT passwords, open the fleet → CertificatesIssue certificate, download the bootstrap bundle, and follow JITR enrollment. JITR creates the device record for you — do not add the device here first, or enrollment fails with DEVICE_NAME_ALREADY_IN_USE.

Next steps

  • Omega — configure SQLite replication and download Omega bundles
  • Edge connect — bring devices online with Omega