Installation

MamaSQL ships as a self-contained Windows app, or as a web app you run anywhere with Docker. The database drivers are bundled — there's nothing else to install.

Windows app

Download the standalone MamaSQL.exe from the Releases page and run it — no installer, no wizard. It uses the WebView2 runtime that ships with Windows 10 and 11.

CI rebuilds the executable on every push to main, so the latest build is always on the Releases page.

Run with Docker (any OS)

Not on Windows, or prefer the web version? Run it with Docker on macOS, Linux or Windows. This starts the web UI, the engine bridge that opens PostgreSQL/MySQL sockets for the browser, and two demo databases.

# Start web UI + engine bridge + demo databases
$ docker compose up -d

# Open http://localhost:5001 — stop with: docker compose down

Build from source

To run the app from source you'll need Node 18+, and for the desktop build, Rust (stable) with the MSVC C++ build tools on Windows:

$ npm install
$ npm run tauri dev      # desktop app (Vite + Rust)
$ npm run dev:all        # or web app + engine bridge

System requirements

How you run it	Requirements
Windows app	Windows 10 or 11 (64-bit) · WebView2 (ships with Windows)
Docker (web)	Docker Engine + Compose · macOS, Linux or Windows
From source	Node 18+ · Rust (stable) + MSVC build tools

Updating MamaSQL

For the Windows app, download the latest MamaSQL.exe from the Releases page. With Docker, pull the newest images and restart: docker compose pull && docker compose up -d.