Deployment Paths

Installation Guide (Docker, macOS, Windows, Desktop)

Choose the install format based on system spec and deployment policy.

Docker (Recommended)

Use Docker Compose to start HMS + PostgreSQL with one command:

docker compose up -d --build

macOS Install

Use the one-click download button at /download or run distribution/install-macos.sh.

Windows Install

Use the one-click download button at /download or run distribution\\install-windows.ps1.

Desktop App Packaging

Embedded browser desktop app scaffolds live in desktop/electron. Build installers with npm run dist:mac or npm run dist:win after installing Node.js.

Set HMS_DESKTOP_URL to local or cloud endpoint before packaging if you want installers bound to a hosted environment.

Recommended System Specs

macOS

Minimum: Apple Silicon M1/Intel i5, 8 GB RAM, 20 GB storage.

Recommended: Apple Silicon M2+, 16 GB RAM, SSD storage.

Windows

Minimum: Windows 10/11 64-bit, Intel i5/Ryzen 5, 8 GB RAM, 20 GB storage.

Recommended: Windows 11, Intel i7/Ryzen 7, 16 GB RAM, SSD storage.

Activation

Installation starts in trial mode for 30 days. Enter activation key from the Pricing page to unlock after trial expiry.

Hosted Cloud Option

If you prefer hosted HMS instead of self-hosting, start from Cloud Hosting, then register or login on the cloud authentication page and subscribe to a monthly or yearly plan.