Getting Started¶
Get your first machine monitored in under 5 minutes.
Step 1: Create an Account¶
- Go to owlette.app
- Click Register and create an account with email/password or Google sign-in
- Optionally set up two-factor authentication or register a passkey for fast biometric login
Step 2: Create a Site¶
Sites organize your machines — think of them as locations, departments, or projects.
- Click "Create Site" in the dashboard
- Enter a Site Name (e.g., "NYC Gallery", "Main Office")
- Enter a Site ID (e.g.,
nyc-gallery) — this is permanent - Click Create
Step 3: Install the Agent¶
Download¶
- Click the download button in the dashboard header to get the latest agent installer
- Transfer the installer to the Windows machine you want to monitor
Install & Connect¶
- Run the installer as Administrator on your target machine
- Follow the setup wizard
- A console window displays a pairing phrase (3 random words) and your browser opens automatically
- Select a site and click "Authorize"
- The agent receives credentials and connects — done
Bulk deployment
For deploying to many machines, use the /ADD= flag with a pre-authorized phrase from the dashboard. See Installation → Silent Install.
Step 4: Verify¶
Within 30 seconds of installation, your machine should appear in the dashboard:
| Check | What to Look For |
|---|---|
| Machine visible | Machine card appears in your site with a green "Online" indicator |
| Metrics flowing | CPU, memory, disk percentages updating |
| System tray | Owl icon visible in the Windows notification area |
Step 5: Add Processes to Monitor¶
Now that your machine is connected, tell Owlette which applications to watch:
- Click on your machine in the dashboard
- Click "Add Process"
- Enter the executable path (e.g.,
C:\Program Files\Derivative\TouchDesigner\bin\TouchDesigner.exe) - Give it a name (e.g., "TouchDesigner")
- Enable Autolaunch to auto-start and auto-restart on crash
- Click Save
The agent immediately begins monitoring the process. If it crashes, Owlette restarts it within 10 seconds.
What's Next?¶
You're up and running. Here's what else you can do:
- Configure process settings — Priority, visibility, launch delay, crash limits
- Deploy software remotely — Push installers to machines without physical access
- Distribute project files — Sync ZIP archives across your fleet
- Chat with your machines — Use Cortex AI to query and control machines via natural language
- Set up email alerts — Get notified when machines go offline or processes crash
- Add more machines — Scale out to your full fleet
- Invite team members — Add users with role-based site access
Need Help?¶
- Check the Troubleshooting guide for common issues
- Review Agent Troubleshooting for agent-specific problems
- Open an issue on GitHub