Native Binary Installation

Install Mobazha as a single native binary — no Docker, no runtime dependencies. Works on Linux (x86_64 & ARM64), macOS (Apple Silicon & Intel), and Windows.

Official guide: https://mobazha.org/self-host (Native Binary tab) and https://mobazha.org/download

Quick Install

Security note: The install commands below download and execute a shell script from get.mobazha.org. Before running, you can review the script with curl -sSL https://get.mobazha.org/install | less. Only proceed if the user confirms they trust the source.

Linux & macOS

curl -sSL https://get.mobazha.org/install | bash

This downloads the mobazha binary (and the mobazha-launcher for auto-update) to ~/.local/bin/ and starts the store as a background service.

Windows

1. Go to https://mobazha.org/download
2. Download the .zip file for Windows
3. Extract the archive
4. Double-click mobazha-tray.exe to start

The Windows desktop app includes a system tray icon and auto-opens your browser to the store admin.

What the Installer Does

1. Detects your OS and architecture (linux/darwin, amd64/arm64)
2. Downloads the matching binary from GitHub Releases
3. Verifies the SHA-256 checksum
4. Places binaries in ~/.local/bin/ (or custom --dir)
5. Downloads the launcher binary (crash recovery + auto-update) if available
6. Registers and starts as a background service (unless --no-start is passed)

After install, the store is accessible at http://localhost:5102 (or http://<public-ip>:5102 for VPS).

Running Your Store

Foreground mode

mobazha start

The store API and Web UI are served on port 5102 by default: http://localhost:5102.

Background service (recommended)

The installer registers a service automatically. Manage it with:

mobazha service status     # Check if running
mobazha service stop       # Stop the service
mobazha service start      # Start the service
mobazha service install    # Re-install / re-register the service
mobazha service uninstall  # Remove the service

On Linux this uses systemd (user-mode when possible), on macOS it uses launchd.

With a custom domain

The native binary itself does not include a reverse proxy. To use a custom domain with HTTPS, deploy via the standalone Docker setup instead (see standalone-setup skill), or manually configure a reverse proxy (Caddy, Nginx) in front of port 5102.

Install Options

Backup

mobazha backup -o ~/mobazha-backup.tar.gz

Uninstall

Remove the binary and service (keeps your store data):

curl -sSL https://get.mobazha.org/install | bash -s -- --uninstall

Remove everything including data:

curl -sSL https://get.mobazha.org/install | bash -s -- --uninstall --purge

Platform Notes

macOS

• Installs via curl | bash, which bypasses Gatekeeper (no Apple Developer signing required)
• The launcher registers as a launchd LaunchAgent for auto-start on login
• Supports both Apple Silicon (arm64) and Intel (amd64)

Linux ARM64

• Works on Raspberry Pi 4+ and ARM VPS instances
• Same install command — the script auto-detects architecture

Running Behind NAT

• No port forwarding needed for basic operation
• Your store stays reachable via the Mobazha P2P network
• For a direct public URL, use the standalone Docker setup with a domain, or enable Tor overlay

After Installation

1. Open http://localhost:5102/admin (or http://<your-ip>:5102/admin for VPS)
2. Complete the Setup Wizard — set admin password, store name, visibility, region/currency (see store-onboarding skill for the full walkthrough)
3. Add products and start selling
4. (Optional) Connect your AI agent to the store via MCP — see store-mcp-connect skill

Troubleshooting

Binary not found after install

Ensure ~/.local/bin is in your PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

Permission denied

The installer needs write access to the install directory. Use --dir to specify a writable location, or run with appropriate permissions.

macOS "unverified developer" warning

This shouldn't happen with curl | bash install. If running a downloaded binary directly, use:

xattr -d com.apple.quarantine ./mobazha

Check service logs

# Linux
journalctl --user -u mobazha -f

# macOS
tail -f ~/Library/Logs/Mobazha/mobazha.log