Installation#
QueryMind is available for macOS, Windows, and Linux. Follow the instructions for your operating system.
Download#
Visit the Dashboard to download the latest version of QueryMind for your platform.
macOS#
System Requirements#
- macOS 12 (Monterey) or later
- Apple Silicon (M1/M2/M3/M4)
Install via Homebrew (Recommended)#
The easiest way to install QueryMind on macOS is via Homebrew:
brew tap QueryMind-dev/querymind
brew install --cask querymind
To upgrade to the latest version:
brew upgrade --cask querymind
To uninstall:
brew uninstall --cask querymind
Note: Homebrew installation is currently available for Apple Silicon Macs only.
Manual Download#
Alternatively, download the .dmg file directly from the Dashboard:
| Chip Type | File |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | QueryMind-x.x.x-arm64.dmg |
Installation Steps (Manual Download)#
- Download the
.dmgfile for your Mac - Open the downloaded
.dmgfile - Drag QueryMind to your Applications folder
- Launch QueryMind from Applications
Verified & Secure#
QueryMind is officially signed and notarized by Apple. This means the app has been verified by Apple for security and is safe to use on your Mac.
Keychain Access Prompt#
When you first launch QueryMind or after an app update, you will see a macOS Keychain access prompt asking for your Mac password.
Why does this happen?
QueryMind securely stores sensitive data (database passwords, authentication tokens) in the macOS Keychain. This requires your permission to access the encrypted storage.
What to do:
- First launch: A Keychain access prompt will appear asking for your Mac password
- Click "Always Allow": This prevents repeated prompts for the same action
- After each app update: The prompt will appear once again — this is normal behavior
Visual guide:
┌─────────────────────────────────────────────────────────────┐
│ "QueryMind wants to use your confidential information" │
│ │
│ [ Deny ] [ Allow ] [ Always Allow ] ← Click this │
└─────────────────────────────────────────────────────────────┘
Note: Due to macOS security, each app update changes the code signature. This means the Keychain prompt will appear once after every update.
Windows#
System Requirements#
- Windows 10 or later
- 64-bit processor
Installation Steps#
- Download the
.exeinstaller (QueryMind-Setup-x.x.x.exe) - Run the installer
Windows SmartScreen Warning#
When you run the installer, Windows may show a SmartScreen warning saying "Windows protected your PC".
Why does this happen?
QueryMind is a new application and hasn't yet built up a reputation with Microsoft SmartScreen. This is normal for new software and doesn't mean the app is unsafe.
How to proceed:
- SmartScreen appears: You'll see "Windows protected your PC" message
- Click "More info": Click the blue "More info" link
- Click "Run anyway": Click the "Run anyway" button to proceed
Visual guide:
┌─────────────────────────────────────────────────────────────┐
│ Windows protected your PC │
│ │
│ Microsoft Defender SmartScreen prevented an unrecognized │
│ app from starting. │
│ │
│ More info ← Click this first │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ Windows protected your PC │
│ │
│ App: QueryMind-Setup-x.x.x.exe │
│ Publisher: Unknown publisher │
│ │
│ [ Don't run ] [ Run anyway ] ← Then click this │
└─────────────────────────────────────────────────────────────┘
- Follow the installation wizard prompts to complete setup
Ubuntu / Debian#
System Requirements#
- Ubuntu 20.04+ / Debian 10+
- 64-bit processor
Download#
Download the .deb package from the Dashboard — select "Ubuntu/Debian (.deb)" from the dropdown menu.
| File Format | Example |
|---|---|
.deb | QueryMind-x.x.x-amd64.deb |
Installation Steps#
- Download the
.debpackage - Install using
dpkg:
sudo dpkg -i QueryMind-*-amd64.deb
- If you encounter dependency issues, run:
sudo apt-get install -f
- Launch QueryMind from your application menu or run:
querymind
Uninstall#
sudo apt-get remove querymind
Linux (Other Distributions)#
System Requirements#
- 64-bit Linux distribution
- GLIBC 2.17 or later
Download#
Download the .AppImage file from the Dashboard — select "Linux (AppImage)" from the dropdown menu.
| File Format | Example |
|---|---|
.AppImage | QueryMind-x.x.x-x86_64.AppImage |
Installation Steps#
- Download the
.AppImagefile - Make it executable:
chmod +x QueryMind-*.AppImage
- Run the application:
./QueryMind-*.AppImage
Tip: You can integrate the AppImage into your system using AppImageLauncher for better desktop integration.
Auto-Updates#
QueryMind automatically checks for updates and notifies you when a new version is available.
- Automatic notification: You'll see an update prompt when a new version is ready
- Manual check: Go to Settings > About to check for updates
macOS users: After an auto-update, the Keychain prompt will appear once. Click "Always Allow" to continue.
Troubleshooting#
macOS: "App is damaged" error#
This typically means the app wasn't downloaded correctly. Try:
- Delete the app and re-download
- If using Safari, try downloading with Chrome or Firefox
Windows: Installer blocked by antivirus#
Some antivirus software may flag new applications. You can:
- Temporarily disable your antivirus during installation
- Add an exception for the QueryMind installer
- Download from the official Dashboard only
Ubuntu/Debian: Missing dependencies#
If the .deb installation fails due to missing dependencies:
sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils libatspi2.0-0 libsecret-1-0
Then retry the installation:
sudo dpkg -i QueryMind-*-amd64.deb
Linux AppImage: FUSE required#
If you see a FUSE-related error when running the AppImage:
# Install FUSE (Ubuntu/Debian)
sudo apt-get install fuse libfuse2
# Or extract and run without FUSE
./QueryMind-*.AppImage --appimage-extract
./squashfs-root/querymind
Next Steps#
After installation: