getting started

---

step 1: create an account

1. Go to owlette.app
2. Click Register and create an account with email/password or Google sign-in
3. 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.

1. Click "new site" in the dashboard (or "Create Your First Site" from the empty state)
2. Enter a site name (e.g., "NYC Gallery", "Main Office")
3. The site ID is auto-generated from the name — expand "customize site ID" only if you want to set a specific ID
4. Click "create site"

---

step 3: install the agent

download

The dashboard header has two installer buttons side by side — pick the one that matches where you are:

• download — if you're already working on the machine you want to monitor, click this to download the latest installer directly.
• copy link — if you're remoting into the machine, click this to copy the installer link, then paste it into a browser on that machine to download it there — no file transfer needed.

install & connect

1. Run the installer as Administrator on your target machine
2. Follow the setup wizard
3. A console window displays a pairing phrase (3 random words), the authorization URL, and the prompt "press Enter to open the pairing page in your browser"
4. Press Enter only if you want to open the local browser, then select a site and click "Authorize"
5. Or authorize from a phone or another computer by opening the displayed URL and entering the pairing phrase
6. The agent receives credentials and connects — done

---

step 4: verify

Within 30 seconds of installation, your machine should appear in the dashboard:

---

step 5: add processes to monitor

Now that your machine is connected, tell owlette which applications to watch:

1. Click on your machine in the dashboard
2. Click "Add Process"
3. Enter the executable path (e.g., C:\Program Files\Derivative\TouchDesigner\bin\TouchDesigner.exe)
4. Give it a name (e.g., "TouchDesigner")
5. Enable Autolaunch to auto-start and auto-restart on crash
6. 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
• Sync files with roost — Publish versioned files and sync them to target machines
• 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
• Email us at support@owlette.app