QuraMate Logo QuraMate Docs
Getting started

Guide

Download & Installation

Choose the right installer, verify the release source, and handle first-launch prompts on desktop OSes.

Updated 2026-03-15 · 7 min read

Jump to another doc

Choose The Right Installer

Use the dedicated download page or the latest GitHub release to select the installer for your operating system.

  • macOS: universal ZIP for Apple Silicon and Intel
  • Windows: x64 EXE installer
  • Verify the release source before bypassing OS security warnings

Script Install Options

If your team prefers scripted setup, use one of these methods.

npm (CLI)

bash
npm i -g quramate
quramate --help

Homebrew (macOS)

If your environment has a QuraMate cask/tap, you can install with Homebrew:

bash
brew install --cask quramate

If brew cannot find quramate, use the direct GitHub release script below.

Direct Script: macOS Release

bash
curl -L "https://github.com/RealDewKJ/QuraMate/releases/latest/download/QuraMate-macOS-universal.zip" -o "$HOME/Downloads/QuraMate-macOS-universal.zip"
unzip -o "$HOME/Downloads/QuraMate-macOS-universal.zip" -d "$HOME/Downloads/QuraMate"
mv "$HOME/Downloads/QuraMate/QuraMate.app" "/Applications/QuraMate.app"

Direct Script: Windows Release (PowerShell)

powershell
$out = "$env:USERPROFILE\Downloads\QuraMate-amd64-installer.exe"
Invoke-WebRequest "https://github.com/RealDewKJ/QuraMate/releases/latest/download/QuraMate-amd64-installer.exe" -OutFile $out
Start-Process -FilePath $out

Install On macOS

Download the ZIP archive, extract it, and move QuraMate into your Applications folder.

If Gatekeeper blocks first launch, open System Settings and explicitly allow the app. Only do this when the download source is the official GitHub release.

Install On Windows

Run the EXE installer and keep the default path unless your team has a packaging standard.

If SmartScreen appears, verify that the installer came from the official GitHub release page before continuing.

First Launch Checklist

  • Start with a low-risk or local database first
  • Use read-only credentials for production investigation
  • Run a small SELECT with LIMIT before any write operation

After installation, continue with First Connection.