Device Onboarding
This guide walks through bringing a device online in Roboticks using a capsule.What you need
- Capsule file (contains backend URL, environment, device identity/keys).
- Device with outbound internet to the Roboticks backend.
- Correct time on the device (NTP) to avoid auth failures.
Steps
- Flash the capsule to the device.
- Boot the device.
- In the web app, open Fleet and select the environment (Production/Testing/Development).
- Wait for the device to appear Online. If it stays Offline, see Troubleshooting.
- (Optional) Start a session from the device or UI; confirm it shows under Sessions.
Capsule contents (typical)
- Device: DSN, type, environment.
- Backend: URL, account/fleet ID, registration token (time-limited).
- Certificates: CA, client cert/key paths (or placeholders if fetched on first boot).
- Composition: module list/version.
Flow
Troubleshooting
- Offline: check network/DNS, backend URL, environment value, token expiry, device clock.
- Not listed: capsule DSN mismatch or registration failed—reissue capsule/token.
- Flapping status: unstable network or heartbeats dropping—check device logs.