Skip to main content

Installation

DeepState runs on macOS, Windows and Linux. It is a single desktop application; there is no server component to install and no account to create beyond your license key.

Getting the installer​

After purchasing at getdeepstate.app you receive an email with your license key and a download link. The link is a one-time token that stays valid for 24 hours and allows a handful of downloads.

If the link has expired, go to getdeepstate.app/download and enter your license key. Fresh links for every platform are generated on the spot.

PlatformFile
macOS, Apple silicon (M-series)DeepState-x.y.z-mac-arm64.dmg
macOS, IntelDeepState-x.y.z-mac-x64.dmg
Windows 10 / 11, 64-bitDeepState-x.y.z-win-x64.exe
Linux, any distributionDeepState-x.y.z-linux-x86_64.AppImage
Linux, Debian / UbuntuDeepState-x.y.z-linux-amd64.deb

Each file has a matching .sha512 checksum next to it if you want to verify the download.

macOS​

  1. Open the .dmg and drag DeepState into Applications.
  2. Launch it from Applications or Spotlight.

Not sure which chip you have? Apple menu → About This Mac. "Apple M…" means arm64; anything mentioning Intel means x64.

First launch

Builds are signed with a Developer ID certificate. If macOS shows "DeepState can't be opened because Apple cannot check it for malicious software", right-click the app → Open, or allow it under System Settings → Privacy & Security. You only have to do this once.

Windows​

  1. Run the .exe installer.
  2. Choose whether to install for the current user or all users, and where.
  3. Launch DeepState from the Start menu or the desktop shortcut it creates.

Windows builds are signed through Azure Trusted Signing. If SmartScreen still shows "Windows protected your PC" on a brand-new release, click More info → Run anyway; the warning disappears as the release accumulates reputation.

Linux​

AppImage (any distribution)​

chmod +x DeepState-x.y.z-linux-x86_64.AppImage
./DeepState-x.y.z-linux-x86_64.AppImage

The AppImage is self-contained. Tools such as AppImageLauncher can integrate it into your application menu.

Debian / Ubuntu​

sudo apt install ./DeepState-x.y.z-linux-amd64.deb

then launch DeepState from your application menu.

Secrets on Linux

API keys and tokens are encrypted with your desktop keyring (GNOME Keyring or KWallet through libsecret). If no keyring is available - for example on a bare window manager - DeepState falls back to storing secrets in plain text inside its config directory so they still persist between launches. Install a keyring if that matters to you.

First launch​

The first time DeepState starts it asks for your license key. Paste the key from your purchase email and click Activate. Keys look like PRO-XXXXX-XXXXX-XXXXX-XXXXX (the prefix matches your tier) or, for Enterprise members, SEAT-XXXX-XXXX-XXXX plus your email address. Activation needs an internet connection; after that the app re-validates in the background and keeps working offline for up to three days between checks. See Licensing.

You land on the board select screen with a default board already created. The Quick start picks up from here.

Updates​

DeepState checks for updates when it starts and every four hours after that. When one is available a notice appears in the app; nothing is downloaded until you accept it, and the update installs when you next restart. Releases are served from the same license-checked download service as the installer.

Occasionally a release is marked mandatory (for example after a security fix or a database format change); the app will ask you to update before continuing.

Where your data lives​

Everything DeepState knows is in one folder:

PlatformLocation
macOS~/Library/Application Support/deepstate/
Windows%APPDATA%\deepstate\
Linux~/.config/deepstate/

Inside: deepstate.db (all boards, nodes, connections, conversations), boards/<id>/media/ (images, videos and documents you added), config.json and secure-config.dat (settings and encrypted secrets), and custom-tools/. The full layout is described in Where data is stored, and Backup & restore covers moving it to another machine.

Uninstalling​

Remove the application the usual way for your platform (drag to Trash; Add or remove programs; sudo apt remove deepstate or delete the AppImage). Your data folder is left in place so you can reinstall later; delete it by hand if you want a clean slate. If you are moving to a new machine, deactivate your license first so the activation slot is freed.