Docker missing or not running
Only affects Docker mode. Install/start Docker Desktop, then use «Open Docker Desktop» in MacFullStack. Native mode works without Docker.
Stack won't start / port in use
Run Diagnostics, check logs. Change ports in Settings → Ports, Save and restart.
Web / PHP not responding
Native: confirm nginx and the project's PHP-FPM are running on Stack; check supervised process logs; ensure the PHP pin is installed or note the fallback warning.
Docker: Rebuild web, check the web container logs. First PHP version switch can take 5–10 minutes.
phpMyAdmin errors
Ensure phpMyAdmin is running. Open http://127.0.0.1:8080 (or your port).
HTTPS issues
brew install mkcert && mkcert -install- Enable HTTPS on Tools
- Refresh certificates + Sync vhosts
- Open
https://{name}.localhost
/etc/hosts
Orange hosts badge — run Sync vhosts (admin password may be required for aliases).
Xdebug
IDE on 9003; Docker host host.docker.internal; enable Xdebug on PHP/Tools.
MySQL ↔ MariaDB switch
Different data dirs/volumes — empty DB after switch is expected. Switch back to see old data.
migrate-runtime / .env
Redis is not copied. If DB connects fail after a mode switch, check DB_HOST / REDIS_HOST in .env (Runtime modes).
Share tunnel drops
Enable Keep Share running, or run macstack tools share keep-alive --enable. Intentional Stop stays down until you start again.
CLI not found
Check path in About MacFullStack or set MACSTACK_CLI.