Getting Started with Kudu Cloud

Creating Your Account

1. Visit cloud.usekudu.com and click Sign In
2. Authenticate with your WorkOS account (Google, Microsoft, or email)
3. On first login, a personal organisation is automatically created for you

Understanding Groups

Groups are how you organise your devices. Each group has its own API key, and every device that connects with that key is added to the group. Common ways to use groups:

• By team — Engineering, Marketing, Support
• By location — HQ, Remote, Data Center
• By environment — Production, Staging, Development
• By client — If you manage devices for multiple clients

Creating a Group

1. Go to Groups in the sidebar
2. Click Create Group
3. Give it a name and optional description
4. An API key is generated automatically — this is what your devices will use to connect

API keys are shown once when created. Copy it somewhere safe — you won't be able to see it again (though you can always regenerate one).

Connecting Your First Device

1. Install the Kudu desktop app on the machine you want to manage
2. Open Kudu and go to Settings > Cloud
3. Paste the API key from your group
4. Click Link

The device will appear in your Cloud dashboard within seconds. Once connected, it sends health reports every 30 minutes and telemetry every 60 seconds.

What Happens When a Device Connects

When a device first links to the cloud:

1. It registers with the dashboard, sharing its hostname and system information
2. The dashboard sends a batch of data-gathering commands to populate the device's profile — network config, installed apps, event logs, and more
3. A health score is calculated based on security posture, update status, and system condition
4. The device appears on your dashboard, ready for monitoring and management

Organisations

Organisations let you separate different fleets entirely — each has its own devices, groups, policies, and settings.

Roles

Role	What they can do
Owner	Full control — manage members, settings, billing, and all resources
Admin	Manage most resources — devices, policies, groups
Member	Standard access — view and interact with devices and dashboards

Inviting Team Members

1. Go to Organisation Settings in the sidebar
2. Click Invite Member
3. Enter their email and choose a role
4. They'll receive an invitation to join

Switching Organisations

If you belong to multiple organisations, use the dropdown in the sidebar to switch between them. Each organisation is completely isolated — devices, data, and settings don't cross boundaries.

What's Next

• Explore the dashboard — Learn your way around the device list, detail pages, and remote commands
• Set up alerts — Get notified when devices need attention
• Configure automation — Automate routine maintenance