open-how2 – Entdecke. Verstehe. Nutze.
Veröffentlicht am
How2-Host

NGINX installieren auf macOS – Schritt-für-Schritt-Anleitung

Autor
NGINX installieren auf macOS – Schritt-für-Schritt-Anleitung

Der moderne Webserver NGINX läuft nicht nur auf Linux und Windows, sondern auch hervorragend unter macOS. Gerade für Entwickler ist das interessant: Du kannst NGINX als lokalen Webserver, Reverse Proxy oder Testumgebung direkt auf deinem Mac nutzen – ohne virtuelle Maschinen oder Container.

In dieser Anleitung erfährst du Schritt für Schritt, wie du NGINX auf macOS installierst, startest, konfigurierst und testest.

Warum NGINX auf macOS?

NGINX ist leichtgewichtig, schnell und flexibel. Gerade auf macOS bietet es sich an für:

  • lokale Entwicklungsserver (z. B. PHP, Python, Node.js)
  • Reverse Proxy für APIs oder Microservices
  • Lern- und Testumgebungen
  • Performance-Vergleiche oder Websimulationen

Dank des Paketmanagers Homebrew ist die Installation auf macOS in wenigen Minuten erledigt.

Voraussetzungen

Bevor du beginnst:

  • Du benötigst macOS 12 (Monterey) oder neuer
  • Homebrew sollte installiert sein
  • Terminalzugriff mit Standardrechten reicht aus

Prüfe, ob Homebrew vorhanden ist:

brew -v

Falls nicht, kannst du Homebrew mit folgendem Befehl installieren:

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

Schritt 1: NGINX installieren

Öffne das Terminal und gib ein:

brew install nginx

Homebrew lädt automatisch alle Abhängigkeiten herunter und richtet NGINX ein. Nach der Installation erhältst du Hinweise, wo sich die Konfigurationsdateien befinden.

Standardpfade:

  • Konfiguration: /opt/homebrew/etc/nginx/nginx.conf
  • HTML-Dateien: /opt/homebrew/var/www
  • Logdateien: /opt/homebrew/var/log/nginx/

Schritt 2: NGINX starten

Nach der Installation kannst du NGINX manuell starten mit:

brew services start nginx

Oder temporär (ohne Autostart):

nginx

Prüfe, ob der Server läuft:

brew services list

Wenn der Status „started“ lautet, ist alles bereit.

Schritt 3: Test im Browser

Öffne Safari, Chrome oder Firefox und rufe auf:

http://localhost:8080

(Die Homebrew-Version von NGINX verwendet standardmäßig Port 8080, nicht 80.)

Wenn du die Seite “Welcome to nginx!” siehst, funktioniert dein Webserver korrekt.

Schritt 4: Eigene Website anlegen

Erstelle dein eigenes Projektverzeichnis:

mkdir -p /opt/homebrew/var/www/meinprojekt

Füge eine einfache Testseite hinzu:

echo "<h1>Hallo NGINX auf macOS!</h1>" > /opt/homebrew/var/www/meinprojekt/index.html

Passe die Konfiguration an, um dein Projekt zu aktivieren. Öffne die Konfigurationsdatei:

nano /opt/homebrew/etc/nginx/nginx.conf

Füge im Server-Block hinzu:

server {
    listen 8080;
    server_name localhost;
    root /opt/homebrew/var/www/meinprojekt;
    index index.html;
}

Speichern und schließen (CTRL + O, CTRL + X).

Lade NGINX neu:

nginx -s reload

Jetzt zeigt dein Browser deine eigene Seite an.

Schritt 5: Nützliche Befehle

Aktion Befehl
Start brew services start nginx
Stop brew services stop nginx
Neustart brew services restart nginx
Konfiguration testen nginx -t
Logs ansehen tail -f /opt/homebrew/var/log/nginx/error.log

Schritt 6: HTTPS für lokale Entwicklung

Für lokale Tests kannst du selbstsignierte Zertifikate mit OpenSSL erstellen:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
-keyout nginx.key -out nginx.crt

Dann fügst du im server-Block hinzu:

listen 8443 ssl;
ssl_certificate /Pfad/zertifikate/nginx.crt;
ssl_certificate_key /Pfad/zertifikate/nginx.key;

Rufe im Browser auf:

https://localhost:8443

Schritt 7: Automatischer Start beim Login (optional)

Wenn du NGINX automatisch starten möchtest:

brew services start nginx

Dadurch startet der Dienst bei jedem macOS-Neustart automatisch im Hintergrund.

Die Installation von NGINX auf macOS ist unkompliziert, schnell und ideal für Entwickler, die lokale Test- oder Proxy-Umgebungen benötigen. Mit Homebrew erledigst du Installation, Start und Wartung mit minimalem Aufwand.

Ob für Webentwicklung, API-Tests oder Performance-Vergleiche – NGINX ist auch auf dem Mac eine professionelle Lösung für lokale Serverprojekte.