macOS Kurulumu¶

macOS'ta Stackvo kurulumu için Docker Desktop kullanılır. Bu kılavuz, hem Intel işlemcili hem de Apple Silicon (M1/M2/M3) Mac bilgisayarlarda Docker Desktop kurulumu, sistem ayarları ve Stackvo yapılandırmasını detaylı olarak açıklamaktadır. Homebrew ile kolay kurulum seçenekleri de mevcuttur.

Sistem Gereksinimlerini Kontrol Ettiniz mi?

Kuruluma başlamadan önce Sistem Gereksinimleri sayfasını kontrol edin.

Docker Desktop Kurulumu¶

1. Docker Desktop İndirme¶

Apple Silicon (M1/M2/M3)Intel

# Tarayıcıda açın:
https://desktop.docker.com/mac/main/arm64/Docker.dmg

# Veya Homebrew ile (önerilir):
brew install --cask docker

# Tarayıcıda açın:
https://desktop.docker.com/mac/main/amd64/Docker.dmg

# Veya Homebrew ile (önerilir):
brew install --cask docker

2. Docker Desktop Kurulumu¶

DMG dosyasını açın
Docker.app'i Applications'a sürükleyin
Applications klasöründen Docker'ı başlatın
İlk açılışta admin şifresi isteyecek

İlk Başlatma

Docker Desktop ilk başlatmada birkaç dakika sürebilir.

3. Docker Desktop Ayarları¶

Docker Desktop açıldıktan sonra:

Settings (⚙️) → Resources

Kaynak	Minimum	Önerilen
CPU	2 cores	4 cores
Memory	4 GB	8 GB
Disk	20 GB	50 GB

Apply & Restart butonuna tıklayın.

4. Docker Doğrulama¶

# Versiyon kontrolü
docker --version
docker compose version

# Test
docker run hello-world

Homebrew ile Kurulum (Önerilir)¶

# Homebrew kurulu değilse:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Docker Desktop + Gerekli araçlar
brew install --cask docker
brew install git jq curl

# Docker Desktop'ı başlat
open -a Docker

Stackvo Kurulumu¶

Docker Desktop kurulumu tamamlandıktan sonra Stackvo'u kurmak için Hızlı Başlangıç sayfasını takip edin.

Özet:

# Repository klonla
git clone https://github.com/stackvo/stackvo.git
cd stackvo

# Konfigürasyon
cp .env.example .env

# Başlat
./stackvo.sh generate
./stackvo.sh up

Kurulum Doğrulama¶

# Container durumu
docker ps

Tarayıcınızda:

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

Kurulum Tamamlandı!

Hızlı Başlangıç sayfasına geçerek ilk projenizi oluşturabilirsiniz.

Yaygın Sorunlar¶

Docker Desktop Başlamıyor¶

# Docker Desktop'ı tamamen kapat
pkill -SIGHUP -f Docker

# Yeniden başlat
open -a Docker

Rosetta 2 Gerekli (Apple Silicon)¶

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

Port Çakışması¶

# Çakışan process'i bul ve durdur
sudo lsof -i :80
sudo kill -9 <PID>