🚀 Launch Special: Save 30% on Macka Pro Lifetime with coupon LAUNCH30 — Own Pro forever! Claim Offer →
Getting Started

Quick Start & Architecture

Install Macka.ai on macOS Apple Silicon in under 60 seconds with isolated ~/.macka runtime.

1. Install Macka.ai

Download Macka_2.x_aarch64.dmg from https://macka.ai, drag Macka.app to /Applications, and launch.

2. Isolated Runtime Layout (~/.macka)

Macka.ai never pollutes /usr/local or system Homebrew configs. Everything lives cleanly inside ~/.macka:

  • ~/.macka/etc/ — NGINX vhosts, PHP-FPM pools, MySQL/MariaDB configs, state.json
  • ~/.macka/ssl/ — Macka.ai Root CA & 397-day leaf fullchain certificates
  • ~/.macka/db/ — Isolated MySQL 8.4, MariaDB 11.4, PostgreSQL 17, MongoDB 8 data directories
  • ~/.macka/logs/ — Service & Worker logs for AI Error Doctor
  • ~/.macka/backups/ — Atomic SQL & config snapshots

3. First Website in 1 Click

Open Websites → Add Website, choose a domain (e.g. app.test), pick PHP 8.4 or Reverse Proxy, and Macka.ai automatically issues a trusted HTTPS certificate and reloads NGINX.