v3.4.0 StableLocal-First Native MySQL Client

macOS & Windows Setup & Connection Guide | VloamDb Manual

VloamDb is a native desktop MySQL client for macOS and Windows. This chapter covers installation, Gatekeeper verification, and first-time connection setup.

macOS Installation & Gatekeeper Verification

VloamDb distributes a Universal DMG image for macOS, natively compiled for both Apple Silicon (M1/M2/M3/M4) and Intel architectures.

1

Download DMG & Mount Disk Image

Download the latest VloamDb.dmg and double-click to mount the virtual volume.

2

Drag to Applications Folder

Drag the VloamDb application icon into the Applications shortcut on the right.

3

First Launch & Gatekeeper Permission

If macOS flags the binary as from an unverified developer, go to System Settings → Privacy & Security and click "Open Anyway", or right-click the app and choose "Open".

💡
Terminal One-Liner to Clear Quarantine

If macOS reports the app is damaged, run this command in Terminal to remove the quarantine flag:

zsh / bash
xattr -cr /Applications/VloamDb.app

Windows Installation & Portable Mode

VloamDb provides both a modern standard installer (.exe) and a zero-install portable zip archive for Windows 10/11 (x64).

Standard Setup Installer

Runs an automated setup that registers start menu shortcuts, uninstaller, and in-place upgrade hooks.

Zero-Install Portable Archive

Extract anywhere (or USB drive) and run. All config lives in the local directory without registry clutter.

🛡️
Windows SmartScreen Warning

On first launch, if Windows SmartScreen displays a warning, click "More info" and then "Run anyway".

Create First MySQL Connection

After launching VloamDb, click "New Connection" or press <code>⌘N</code> (macOS) / <code>Ctrl+N</code> (Windows) to open the connection drawer.

FieldDefaultDescription & Notes
Host / 地址127.0.0.1Hostname, IPv4/IPv6 address, or domain of MySQL instance
Port / 端口3306Standard MySQL TCP port
User / 用户名rootMySQL database user
Password / 密码-Stored securely in native OS Keychain or DPAPI
Environment / 环境标签Dev (开发)Select Dev, Staging, or Prod to activate safeguards

Click "Test Connection" to verify network and credentials. Once verified, click "Save & Connect" to launch your database workspace.