Getting Started with Umoo

Umoo is an open-source IoT device management platform. The fastest way to get started is to sign up at console.umoo.yun — no installation required. This guide walks through the initial setup and your first device enrollment.

Sign Up

Head to console.umoo.yun and create a free account. The free tier includes up to 5 devices and all core features — no credit card required.

Create Your First Tenant

Umoo is multi-tenant by design. After signing up, create a new organization. Each organization is a fully isolated tenant with its own devices, groups, users, and configurations.

Enroll Your First Device

Navigate to the Devices section and generate a claim token. On your edge device, download the Umoo agent binary and run:

umoo-agent --server https://console.umoo.yun:8443 --token <claim-token>

The agent presents the claim token, receives its mTLS certificates, and registers with the platform. Within seconds, the device appears in your dashboard with its reported state.

What’s Next

With your first device online, you can explore device groups for organizing your fleet, shadow state for pushing configuration, and the monitoring dashboard for real-time telemetry. Check the full documentation for detailed walkthroughs of every feature.

Self-Hosting (Optional)

Prefer to run Umoo on your own infrastructure? You can self-host via Docker Compose, systemd, or Kubernetes. See the self-hosting guide for details.

Ready to get started?

Deploy Umoo in minutes and start managing your IoT fleet today.