dashboard getting started
This guide walks you through your first experience with the owlette dashboard - from login to seeing your first machine.
first login
email/password
- Navigate to your dashboard URL (e.g.,
https://owlette.apporhttps://dev.owlette.app) - Click Register and create an account
- After registration, you're automatically logged in
google oauth
- Click "Sign in with Google" on the login page
- Select your Google account
- You're automatically registered and logged in
passkey (passwordless)
If you've registered a passkey, click "Sign in with passkey" on the login page. Authenticate with your device's biometric (Touch ID, Windows Hello, or phone) - no password or 2FA code needed.
set up two-factor authentication
After your first login, you'll be prompted to set up 2FA:
- Open an authenticator app (Google Authenticator, Authy, 1Password, etc.)
- Scan the QR code displayed on screen
- Enter the 6-digit code from your authenticator
- Save your backup codes somewhere safe - you'll need them if you lose your device
2FA is optional but recommended
You can skip 2FA setup, but it adds an important layer of security for admin accounts.
create your first site
Sites are the top-level organizational unit - think of them as locations, departments, or projects.
- If you have no sites yet, click "create your first site". Otherwise open the site switcher, choose "manage sites", then click "new site".
- In "create new site", enter a "site name" (e.g., "NYC Gallery").
- Keep the generated "site ID" or open "customize site ID" to set one manually. The ID is permanent and used in URLs.
- Click "create site".
You're automatically assigned as the owner with full access.
add your first machine
- Click "add machine" on the dashboard.
- On the "enter code" tab, download or copy the agent installer link and run it on the target Windows machine.
- Enter the 3-word "pairing phrase" shown on that machine.
- Click "authorize". The success state reads "machine authorized", and the machine appears on the dashboard shortly.
For unattended or bulk installs, use the "generate code" tab instead. Click "generate code", then copy the generated "pairing phrase" or "silent install command". Generated pairing phrases expire in 10 minutes.
Within 30 seconds, the machine appears in your dashboard:
- Green Online indicator
- CPU, memory, disk metrics populating
- Agent version displayed
understanding the dashboard layout
machine cards
Each machine is displayed as a card showing:
- Machine name (hostname)
- Online/Offline status with last seen time
- System metrics - CPU, memory, disk, GPU percentages
- Process list - configured processes with status indicators
- Agent version
view modes
- Card View - Visual grid of machine cards with sparkline charts
- List View - Compact table with sortable columns
navigation
- dashboard - Main monitoring view
- cortex - AI chat for machine management
- deploy - Software deployment management
- roost - Content-addressed file sync, version publishing, and rollback at
/roosts - logs - Activity event viewer
- admin panel - User and system management for superadmins
next steps
- Add processes - Configure applications for monitoring
- Deploy software - Push installers to machines
- Set up alerts - Get notified when things go wrong
- Invite users - Add team members with role-based access
dashboard
The owlette web dashboard is a Next.js application that provides real-time monitoring and remote control of all your machines. Access it from any browser — desktop, tablet, or mobile.
machine monitoring
The dashboard provides real-time visibility into all your machines' health, performance, and process status.