Skip to content

Edge claim expiry

Symptoms

Section titled “Symptoms”
  • CLI shows expired on claim-status
  • Management rejects code as expired or invalid
  • Device never reaches consumed state

Causes

Section titled “Causes”
  • Claim TTL (~24h) elapsed before POST /internal/devices/assign
  • Wrong code entered (typo; codes are XXX-XXX, case-insensitive)
  • Claim already consumed — need --new for fresh announce

Resolution

Section titled “Resolution”
  1. On device: monozu edge register (or --new if old claim is stuck).
  2. Enter new code in Management promptly.
  3. Keep CLI running until claim-complete succeeds.

Anti-patterns

Section titled “Anti-patterns”
  • Sharing claim code in chat — treat like a one-time pairing secret visible only at device.
  • Re-announce from different network IP for same hardware — rejected by design.

Debug

Section titled “Debug”
  • Backend: device_claims table status, expires_at
  • Rate limits on announce — ClaimAnnounceRateLimit middleware
Section titled “Related”