Overseer

Installation Guide for Overseer

Getting Started
•Last updated: February 16, 2026

Welcome to Overseer! This guide provides step-by-step instructions for installing Overseer, the native macOS system monitoring dashboard, on your Mac.

Installation Methods

Mac App Store (Recommended)

The easiest way to install Overseer is through the official Mac App Store:

  1. Open the Mac App Store on your macOS device
  2. Search for "Overseer" in the search bar
  3. Click "Get" or the price button ($19.99) to purchase and download
  4. Wait for installation - The app will automatically download and install
  5. Launch Overseer from your Applications folder, Launchpad, or Spotlight

Benefits of Mac App Store installation:

  • Automatic updates
  • Verified and secure distribution
  • Easy installation and removal
  • Family Sharing support
  • Apple's privacy and security guarantees

Direct Download (Alternative)

For enterprise deployments or testing purposes, you can download Overseer directly:

  1. Visit our download page at overseer.com/download
  2. Download the latest .dmg file
  3. Open the .dmg file by double-clicking it
  4. Drag Overseer to your Applications folder
  5. Eject the disk image after copying

Security Note: When downloading directly, ensure you verify the authenticity of the download using the provided checksums.

System Requirements

Before installing, verify your system meets these requirements:

Minimum Requirements

  • macOS: 13.0 (Ventura) or later
  • Processor: Intel Core i5 (8th generation) or Apple Silicon (M1)
  • Memory: 8 GB RAM
  • Storage: 200 MB available space
  • Display: 1280 × 800 resolution

Recommended Requirements

  • macOS: 14.0 (Sonoma) or later
  • Processor: Apple Silicon (M2 or newer)
  • Memory: 16 GB RAM or more
  • Storage: 500 MB available space (for historical data and cache)
  • Display: 1920 × 1080 resolution or higher

Monitoring Capabilities by Hardware

  • Apple Silicon (M1/M2/M3): Full support including GPU monitoring, energy efficiency metrics, and Neural Engine (when available)
  • Intel Macs: Complete monitoring support including CPU temperature, GPU utilization, and legacy hardware sensors
  • MacBooks: Battery health monitoring, thermal performance tracking, and energy impact analysis
  • Desktop Macs: Multiple storage device monitoring, external display support, and network performance optimization

First Launch & Permission Setup

After installation, launch Overseer for the first time:

  1. Locate Overseer in your Applications folder or use Spotlight (⌘ + Space, type "Overseer")
  2. Double-click to launch - You may need to grant permission for the app to run (first-time only)
  3. Grant macOS permissions - Overseer will request necessary permissions for system monitoring:

Essential Permissions for Monitoring

System Monitoring Permission (Privacy & Security → System Monitoring)

  • Required for: CPU, memory, GPU, and process metrics monitoring
  • Why needed: macOS requires explicit permission to access real-time system performance data
  • How to grant: Click "Allow" when prompted, or go to System Settings → Privacy & Security → System Monitoring

Disk Access Permission (Privacy & Security → Files and Folders)

  • Required for: Disk usage monitoring, I/O performance tracking, and SMART status reading
  • Why needed: To monitor storage health and performance without accessing personal files
  • How to grant: Grant access when prompted

Network Access Permission (Privacy & Security → Network)

  • Required for: Network traffic monitoring, bandwidth usage tracking, and connection analysis
  • Why needed: To monitor network activity (does not inspect content)
  • How to grant: Allow when prompted

Optional Permissions

Accessibility Access (Privacy & Security → Accessibility)

  • Provides: Enhanced process monitoring and window information
  • Can be declined: Basic monitoring will still work without this permission

Screen Recording (Privacy & Security → Screen Recording)

  • Not required for Overseer's core functionality
  • Only needed if using screenshot-based monitoring features (not currently implemented)

Gatekeeper Warnings (Direct Download)

If you downloaded Overseer directly, you might see a security warning:

"Overseer" cannot be opened because the developer cannot be verified.

To resolve this:

  1. Go to System Settings → Privacy & Security
  2. Scroll down to the Security section
  3. Click "Open Anyway" next to the Overseer warning
  4. Confirm you want to open the application

Post-Installation Configuration

1. Verify Installation

  • Check that Overseer appears in your Applications folder
  • Verify the app launches without errors
  • Check the About menu (Overseer → About Overseer) for version information

2. Initial Setup Wizard

On first launch, Overseer will guide you through:

  • Dashboard customization: Choose which metrics to display
  • Alert configuration: Set up threshold alerts for CPU, memory, temperature, etc.
  • Theme selection: Choose Light, Dark, or System theme
  • Notification preferences: Configure macOS Notification Center alerts

3. Check for Updates

  • Mac App Store: Updates are automatic, but you can check manually in the App Store Updates tab
  • Direct Download: Check for updates in Overseer → Check for Updates

Troubleshooting Installation Issues

"App is Damaged" Error

If you see "Overseer.app is damaged and can't be opened":

# Open Terminal and run:
sudo xattr -cr /Applications/Overseer.app

Insufficient Permissions for Monitoring

If Overseer shows limited or no system metrics:

  1. Go to System Settings → Privacy & Security
  2. Navigate to System Monitoring, Files and Folders, and Network
  3. Ensure Overseer is checked in each category
  4. Restart Overseer after granting permissions

Installation Fails or App Won't Launch

If installation fails or the app won't launch:

  1. Restart your Mac and try again
  2. Check disk space - Ensure you have at least 500 MB free
  3. Verify macOS version - Check About This Mac → macOS version
  4. Check Console logs for error messages:
    • Open Console.app
    • Search for "Overseer" in logs
  5. Contact support if issues persist

Missing Hardware Sensors or Metrics

If certain metrics (GPU, temperature, etc.) are unavailable:

  1. Check macOS version - Some metrics require macOS 14.0+
  2. Verify hardware compatibility - Older Macs may have limited sensor availability
  3. Grant all permissions - Ensure System Monitoring permission is fully granted
  4. Restart Overseer after permission changes

Uninstallation

To remove Overseer from your system:

Mac App Store Version

  1. Open Finder → Applications
  2. Drag Overseer.app to the Trash
  3. Empty the Trash

Direct Download Version

  1. Remove the application from /Applications

  2. Remove preferences (optional):

    rm -rf ~/Library/Preferences/com.overseer.Overseer.plist
rm -rf ~/Library/Application\ Support/Overseer
rm -rf ~/Library/Caches/com.overseer.Overseer

  3. Remove historical monitoring data (optional):

    rm -rf ~/Library/Containers/com.overseer.Overseer/Data/Library/Application\ Support/Overseer

  4. Remove Keychain entries (optional) - Open Keychain Access and search for "Overseer"

Next Steps

Now that Overseer is installed:

  1. Explore the Dashboard - Familiarize yourself with the monitoring interface
  2. Configure Alerts - Set up notifications for system events
  3. Customize Views - Arrange metrics to match your workflow
  4. Check System Health - Review your Mac's performance baseline

Need help? Check our FAQ or contact support.

Back to categoryBack to Documentation

Was this helpful?

Help us improve this documentation by providing feedback.

Report IssueContact SupportEdit this page