macOS Installation¶

Docker Desktop is used for Stackvo installation on macOS. This guide detailedly explains Docker Desktop installation, system settings, and Stackvo configuration on both Intel and Apple Silicon (M1/M2/M3) Mac computers. Easy installation options with Homebrew are also available.

Docker Desktop Installation¶

1. Downloading Docker Desktop¶

# Open in browser:
https://desktop.docker.com/mac/main/arm64/Docker.dmg

# Or with Homebrew (recommended):
brew install --cask docker

# Open in browser:
https://desktop.docker.com/mac/main/amd64/Docker.dmg

# Or with Homebrew (recommended):
brew install --cask docker

2. Installing Docker Desktop¶

1. Open the DMG file
2. Drag Docker.app to Applications
3. Start Docker from Applications folder
4. It will ask for admin password on first launch

3. Docker Desktop Settings¶

After Docker Desktop opens:

Settings (⚙️) → Resources

Click on Apply & Restart button.

4. Docker Verification¶

# Version check
docker --version
docker compose version

# Test
docker run hello-world

Installation with Homebrew (Recommended)¶

# If Homebrew is not installed:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Docker Desktop + Required tools
brew install --cask docker
brew install git jq curl

# Start Docker Desktop
open -a Docker

Stackvo Installation¶

After Docker Desktop installation is complete, follow the Quick Start page to install Stackvo.

Summary:

# Clone repository
git clone https://github.com/stackvo/stackvo.git
cd stackvo

# Configuration
cp .env.example .env

# Start
./stackvo.sh generate
./stackvo.sh up

Installation Verification¶

# Container status
docker ps

In your browser:

• Stackvo Dashboard: https://stackvo.loc
• Traefik Dashboard: http://traefik.stackvo.loc

Common Issues¶

Docker Desktop Not Starting¶

# Completely close Docker Desktop
pkill -SIGHUP -f Docker

# Restart
open -a Docker

Rosetta 2 Required (Apple Silicon)¶

# Install Rosetta 2
softwareupdate --install-rosetta --agree-to-license

Port Conflict¶

# Find and stop conflicting process
sudo lsof -i :80
sudo kill -9 <PID>