Skip to main content

Installation

DeepState is available for macOS, Windows, and Linux. All versions are code-signed and notarized for secure installation.

Downloading DeepState​

After purchasing a license at getdeepstate.app, you'll receive an email with a download link. You can also access your downloads from the download page using the token from your email.

macOS Installation​

Apple Silicon (M1/M2/M3)​

  1. Download the DeepState-x.x.x-mac-arm64.dmg file
  2. Open the DMG file
  3. Drag DeepState to your Applications folder
  4. Launch DeepState from Applications

Intel Macs​

  1. Download the DeepState-x.x.x-mac-x64.dmg file
  2. Open the DMG file
  3. Drag DeepState to your Applications folder
  4. Launch DeepState from Applications
First Launch on macOS

On first launch, macOS may show a security prompt. Click "Open" to proceed. The app is notarized by Apple and safe to run.

Windows Installation​

  1. Download the DeepState-x.x.x-win-x64.exe installer
  2. Run the installer
  3. Follow the installation wizard
  4. Launch DeepState from the Start Menu or Desktop shortcut
Windows SmartScreen

If Windows SmartScreen shows a warning, click "More info" and then "Run anyway". The app is code-signed with an EV certificate.

Linux Installation​

  1. Download the DeepState-x.x.x-linux-x86_64.AppImage file
  2. Make it executable: 
    chmod +x DeepState-x.x.x-linux-x86_64.AppImage
  3. Run the AppImage: 
    ./DeepState-x.x.x-linux-x86_64.AppImage

Debian/Ubuntu (.deb)​

  1. Download the DeepState-x.x.x-linux-amd64.deb file
  2. Install with dpkg: 
    sudo dpkg -i DeepState-x.x.x-linux-amd64.deb
  3. Launch DeepState from your application menu

License Activation​

On first launch, you'll be prompted to enter your license key:

  1. Enter the license key from your purchase email
  2. Click "Activate"
  3. Your license will be validated and the app will unlock

Your license key format depends on your tier:

  • Personal/Pro: PER-XXXXX-XXXXX-XXXXX or PRO-XXXXX-XXXXX-XXXXX
  • Enterprise: ENT-XXXXX-XXXXX-XXXXX (master key, generates seat keys)

Automatic Updates​

DeepState checks for updates automatically on launch. When an update is available:

  1. You'll see a notification in the app
  2. Click to download the update
  3. Restart the app to apply the update

Updates are delivered through the same secure download system used for initial installation.

Data Storage​

DeepState stores all data locally on your machine:

PlatformData Location
macOS~/Library/Application Support/deepstate/
Windows%APPDATA%/deepstate/
Linux~/.config/deepstate/

This includes:

  • Database: SQLite file containing all your boards and nodes
  • Settings: Application preferences and AI provider configurations
  • Custom Tools: Your custom tool scripts (Pro/Enterprise only)
Data Privacy

All your investigation data stays on your machine. Only AI prompts are sent to your configured AI provider (and that's your own API key). License validation is the only external communication.

Uninstalling​

macOS​

  1. Drag DeepState from Applications to Trash
  2. Optionally delete data: rm -rf ~/Library/Application Support/deepstate

Windows​

  1. Use "Add or Remove Programs" in Settings
  2. Optionally delete data: %APPDATA%/deepstate

Linux​

# If installed via .deb
sudo dpkg -r deepstate

# Delete data
rm -rf ~/.config/deepstate

Troubleshooting​

App Won't Launch​

  1. Ensure you downloaded the correct version for your platform
  2. Check that your system meets the minimum requirements
  3. Try redownloading the installer

License Activation Failed​

  1. Verify you entered the key correctly (copy/paste recommended)
  2. Check your internet connection
  3. Ensure your license hasn't expired or been revoked
  4. Contact [email protected] if issues persist

Database Issues​

If the app crashes or data seems corrupted:

  1. Close DeepState completely
  2. Navigate to the data directory for your platform
  3. Backup the deepstate.db file
  4. Try launching again

For additional help, contact [email protected].