Datenpunkt: Homebrew nennt /opt/homebrew für Apple-Silicon-Macs und /usr/local für Intel-Macs als Standardpräfixe. Ihre konkrete Installation kann an einem anderen Ort liegen (Homebrew-FAQ zu den Standard-Installationsorten).

Symptom → schnellster Weg: brew wird im Terminal nicht gefunden → prüfen Sie zuerst, ob Homebrew installiert ist. Ist der Installationsordner vorhanden, kontrollieren Sie als Nächstes, ob Ihre Shell die passende Konfiguration lädt. Installieren Sie nicht vorschnell neu und ändern Sie keine Systemrechte.

Dieser Leitfaden richtet sich an Studierende, die Homebrew zum ersten Mal auf dem Mac eingerichtet haben und nun eine Fehlermeldung sehen.
Auch wenn Sie gerade von Windows wechseln und Kurswerkzeuge vorbereiten, erfahren Sie, warum ein vorhandenes Programm im Terminal nicht automatisch als Befehl verfügbar ist.
Nutzen Sie einen verwalteten Schul-Mac oder einen Remote-Mac, prüfen Sie außerdem zuerst, welche Änderungen Sie vornehmen dürfen.

Schritt 1: Installationsstatus und Fehlermeldung prüfen

Unterscheiden Sie zuerst, ob die Installation tatsächlich abgeschlossen wurde oder ob Homebrew installiert ist, aber im aktuellen Terminal nicht gefunden wird. Diese Unterscheidung entscheidet über den nächsten Schritt: Ein unvollständiger Installationsvorgang lässt sich nicht durch eine Änderung an der Shell-Konfiguration reparieren.

Notieren Sie die letzte Meldung des Installationsprogramms und die vollständige Fehlermeldung aus dem Terminal. „Befehl nicht gefunden“ bedeutet zunächst nur, dass die aktuelle Shell den Namen brew nicht über ihre Suchpfade auflösen kann. Es beweist für sich allein nicht, dass Homebrew fehlt.

Homebrew weist in der Installationsanleitung auf die Schritte nach der Installation hin. Dazu gehört, die Shell-Konfiguration entsprechend der Installationsausgabe zu aktualisieren. Wird dieser Schritt ausgelassen, kann Homebrew vorhanden sein, ohne dass das Terminal den Befehl direkt erkennt.

Beginnen Sie mit diesen Prüfungen:

  1. Öffnen Sie das Terminal, das Sie für Ihre Kursarbeit verwenden.
  2. Geben Sie brew --version ein.
  3. Wenn die Shell den Befehl nicht kennt, führen Sie command -v brew aus.
  4. Lesen Sie die vollständige Ausgabe. Ein leerer Pfad bedeutet, dass die Shell den Befehl in ihren aktuellen Suchorten nicht gefunden hat.
  5. Speichern Sie die Meldung, bevor Sie Einstellungen ändern.

Diese Befehle fragen den Zustand ab. Sie installieren nichts und erfordern keine Änderung an Administratorrechten. Die Homebrew-Manpage mit Informationen zu Präfix und shellenv hilft Ihnen, die Befehle und die nächsten Prüfungen einzuordnen.

Wichtig: Starten Sie die Installation nicht erneut, nur weil brew im Terminal fehlt. Prüfen Sie zuerst, was der ursprüngliche Installationsversuch gemeldet hat und ob der passende Installationsordner vorhanden ist.

Bereits installierte Homebrew-Version erkennen

Ein erfolgreicher Aufruf von brew --version zeigt, dass die Shell den Befehl findet und Homebrew eine Versionsausgabe liefert. Meldet das Terminal dagegen, dass der Befehl unbekannt ist, prüfen Sie den Pfad im nächsten Schritt. Die Fehlermeldung allein reicht nicht aus, um zwischen einer fehlenden Installation und einer nicht geladenen Shell-Konfiguration zu unterscheiden.

Falls der Installationsvorgang mit einer Fehlermeldung endete, notieren Sie diese genau. Führen Sie nicht einfach denselben Installationsbefehl erneut aus: Erst wenn klar ist, ob der Fehler beispielsweise beim Abruf, bei der Einrichtung oder beim Aktualisieren der Shell-Konfiguration auftrat, können Sie die passende Maßnahme wählen.

Schritt 2: Installationsort und ausführbare Datei abgleichen

Das Installationspräfix ist der übergeordnete Ordner, in dem Homebrew seine Dateien ablegt. Stellen Sie es sich als Ablageort eines Werkzeugs vor. Damit Sie das Werkzeug im Terminal direkt mit seinem Namen starten können, muss die Shell außerdem wissen, wo sie danach suchen soll. Diese Liste mit Suchorten heißt PATH.

Homebrew dokumentiert unterschiedliche Standardpräfixe für Apple-Silicon- und Intel-Macs. Die Angaben sind Standardwerte, keine Garantie für jede einzelne Installation. Eine angepasste Installation, eine frühere Konfiguration oder Vorgaben einer Schule können einen anderen Pfad ergeben. Vergleichen Sie deshalb den Standardpfad mit der Ausgabe Ihres Installationsvorgangs.

Wenn Ihr Mac ein Apple-Silicon-Modell ist, können Sie den dokumentierten Standardpfad mit /opt/homebrew/bin/brew --version prüfen. Auf einem Intel-Mac lautet der entsprechende Standardpfad /usr/local/bin/brew --version. Verwenden Sie diese Beispiele nur, wenn sie zu Ihrer Installation passen; die tatsächlichen Orte können abweichen.

  • Der Aufruf über den tatsächlichen vollständigen Pfad funktioniert: Homebrew ist vorhanden. Wahrscheinlich kennt die aktuelle Shell den Ordner noch nicht.
  • Der Aufruf über den vermuteten Standardpfad scheitert: Das beweist nicht, dass Homebrew fehlt. Vergleichen Sie den Pfad mit der Installationsausgabe und prüfen Sie, ob Sie einen anderen Ort verwenden.
  • Der Installationsvorgang wurde unterbrochen oder meldete einen Fehler: Klären Sie zuerst diese Ursache. Eine Pfadkorrektur kann eine unvollständige Installation nicht ersetzen.

Wenn Sie Homebrew bereits über den vollständigen Pfad starten können, lässt sich auch brew --prefix verwenden, um das Präfix auszugeben. Funktioniert dieser Aufruf noch nicht, verlassen Sie sich zunächst auf die Installationsmeldung und den dort angegebenen tatsächlichen Pfad. Die zuvor verlinkte Homebrew-Manpage erläutert, wie Präfix und shellenv zusammenhängen.

Ausgabe von command -v brew einordnen

Gibt command -v brew einen Pfad aus, hat die Shell eine ausführbare Datei mit diesem Namen gefunden. Vergleichen Sie diesen Pfad mit dem Installationsort. Eine Abweichung kann auf eine andere oder ältere Homebrew-Installation hinweisen. Ändern Sie in diesem Fall nicht sofort die Konfiguration, sondern klären Sie zuerst, welcher Pfad für Ihre Kursumgebung vorgesehen ist.

Bleibt die Ausgabe leer, kann die Shell den Befehl aktuell nicht finden. Der nächste Schritt ist dann nicht die Neuinstallation, sondern die Prüfung, welche Shell läuft und welche Startdatei sie beim Öffnen einer Sitzung einliest.

Schritt 3: Die passende Shell-Konfiguration finden

Eine Shell ist das Programm, das Ihre Eingaben im Terminal entgegennimmt und Befehle startet. Welche Shell verwendet wird, beeinflusst, welche Startdatei beim Öffnen einer Sitzung gelesen wird. In dieser Datei stehen Einstellungen, die für neue Terminal-Sitzungen gelten können.

Ermitteln Sie die aktuelle Shell mit echo "$SHELL". Sie können zusätzlich in den Terminal-Einstellungen nachsehen, ob beim Öffnen ein bestimmter Startbefehl ausgeführt wird. Die Apple-Anleitung zum Prüfen und Ändern der Standardshell erklärt, wo diese Einstellung zu finden ist. Für die Fehlersuche müssen Sie die Standardshell nicht ändern. Entscheidend ist zunächst, welche Shell Ihre Sitzung tatsächlich verwendet.

Die richtige Datei für die Shell-Konfiguration

Öffnen Sie die Startdatei, die zur tatsächlich verwendeten Shell und zur Homebrew-Installation passt. Die Homebrew-Installationsanleitung nennt die Konfiguration, die zu ihrem jeweiligen Installationsschritt gehört. Verwenden Sie diese konkrete Vorgabe, statt beliebige Konfigurationsdateien der Reihe nach zu bearbeiten.

Bei den dokumentierten Standardpräfixen lauten die entsprechenden Einträge:

eval "$(/opt/homebrew/bin/brew shellenv)"

eval "$(/usr/local/bin/brew shellenv)"

Diese Beispiele gehören zu unterschiedlichen Standardpfaden. Übernehmen Sie nicht beide vorsorglich und ersetzen Sie den Beispielpfad nicht durch einen vermuteten Ordner. Bei einer angepassten Installation muss die Zeile zum tatsächlichen Speicherort von brew passen. Die Installationsanleitung beschreibt, wie die Shell-Umgebung nach der Installation eingerichtet wird.

Prüfen Sie die Startdatei auf einen passenden brew shellenv-Eintrag:

  • Der Eintrag fehlt: Ergänzen Sie nur die Zeile, die zur Installation und zum tatsächlichen Pfad passt.
  • Der Eintrag zeigt auf einen nicht vorhandenen Ort: Ermitteln Sie zuerst den echten Installationsort.
  • Der Eintrag ist vorhanden und der Pfad stimmt: Prüfen Sie, ob Sie die richtige Datei bearbeitet haben und ob das Terminal eine neue Sitzung damit startet.
  • Das Gerät ist verwaltet oder die Datei lässt sich nicht ändern: Beenden Sie die Änderung und fragen Sie die zuständige Geräteverwaltung.

Wenn Sie unsicher sind, ob Ihr Terminal-Profil eine eigene Shell oder Startbefehle verwendet, hilft Apples Dokumentation zur Nutzung von Shells im Terminal. Verändern Sie nicht mehrere Dateien gleichzeitig. Sonst lässt sich später nur schwer nachvollziehen, welche Änderung die Wirkung hatte.

Sicherheitsgrenze: Kopieren Sie keine unbekannten Skripte aus Foren in Ihre Konfiguration. Überschreiben Sie auch nicht die gesamte Startdatei. Darin können weitere Einstellungen für Ihren Kurs oder Ihre Entwicklungsumgebung stehen.

Schritt 4: Die Konfiguration gezielt ergänzen

Sichern Sie die betroffene Konfigurationsdatei, bevor Sie sie ändern. Ergänzen Sie ausschließlich die Zeile, die Homebrew für Ihre tatsächliche Installation vorsieht. Wenn Sie nicht sicher zuordnen können, welche Datei zur laufenden Shell gehört, ändern Sie noch nichts. Eine Änderung in der falschen Startdatei bleibt beim nächsten Öffnen des Terminals oft wirkungslos.

brew shellenv richtet die Umgebung so ein, dass die Shell Homebrew und seine Werkzeuge finden kann. Die Reihenfolge ist deshalb wichtig: Ermitteln Sie zuerst den Pfad und ergänzen Sie danach die passende Zeile. Die Homebrew-Manpage erläutert die Funktion; die Installationsanleitung zeigt die vorgesehene Einrichtung nach der Installation.

Vermeiden Sie diese Abkürzungen:

  • Homebrew erneut installieren, ohne den Status zu prüfen: Sie wissen danach weiterhin nicht, ob die Ursache in der Installation oder in der Shell-Konfiguration lag.
  • Den Suchpfad pauschal ändern: Das kann andere Programme beeinflussen, ohne den ursprünglichen Fehler zu beheben.
  • Eine Startdatei vollständig ersetzen: Dabei können vorhandene Einstellungen verloren gehen.
  • Rechte oder Eigentümerschaft vorsorglich ändern: Das ist keine Standardlösung für einen Befehl, den die Shell nicht findet.

Wenn die Pfade unklar sind oder mehrere Homebrew-Einträge auftauchen, vergleichen Sie Ihre Beobachtungen mit den offiziellen Hinweisen zur Homebrew-Fehlerbehebung. Sie helfen Ihnen, Installations- und Pfadprobleme voneinander abzugrenzen, bevor Sie weitere Änderungen vornehmen.

Schritt 5: Ein neues Terminal öffnen und die Änderung prüfen

Schließen Sie das aktuelle Terminalfenster und öffnen Sie ein neues. So prüfen Sie, ob die Startdatei beim Beginn einer frischen Sitzung geladen wird. Dass ein Befehl nur im bereits geöffneten Fenster funktioniert, ist noch kein Nachweis für eine dauerhaft wirksame Konfiguration.

Führen Sie im neuen Fenster erneut command -v brew und danach brew --version aus. Gibt der erste Befehl einen Pfad aus und liefert der zweite eine Versionsausgabe, kann die Shell Homebrew über den Namen brew finden.

Wenn die Prüfung weiterhin scheitert, kontrollieren Sie gezielt:

  1. Läuft im neuen Fenster dieselbe Shell wie zuvor?
  2. Haben Sie die Startdatei dieser Shell bearbeitet?
  3. Verweist die shellenv-Zeile auf den tatsächlichen Installationsort?
  4. Öffnet Ihr Terminal-Profil eine andere Shell oder führt es eigene Startbefehle aus?
  5. Verhindert die Geräteverwaltung eine Änderung?

Wenn Sie vermuten, dass das Terminal beim Start eine abweichende Umgebung lädt, prüfen Sie die allgemeinen Einstellungen des Terminals. Bei unklaren Pfaden oder mehreren Installationen helfen die offiziellen Homebrew-Hinweise zur Fehlerbehebung. Erweitern Sie nicht vorsorglich die Berechtigungen, um eine Fehlermeldung zu umgehen.

Schritt 6: Den passenden nächsten Schritt auswählen

Nutzen Sie diese Entscheidungsbedingungen, bevor Sie etwas neu installieren oder die Umgebung wechseln:

  • Wenn der vollständige Pfad brew startet, aber der Aufruf brew allein nicht funktioniert: Ergänzen oder korrigieren Sie die passende Shell-Konfiguration. Öffnen Sie danach ein neues Terminal und prüfen Sie beide Befehle erneut.
  • Wenn weder der vollständige Pfad noch der normale Aufruf funktioniert: Vergleichen Sie die Installationsmeldung mit dem vermuteten Ort. Ist der Ordner nicht vorhanden, klären Sie zuerst, ob die Installation abgeschlossen wurde.
  • Wenn die Installationsausgabe einen Fehler oder Abbruch meldet: Beheben Sie zunächst die dort genannte Ursache. Folgen Sie anschließend der offiziellen Installationsanleitung, statt denselben Vorgang blind zu wiederholen.
  • Wenn ein verwalteter Schul-Mac Änderungen blockiert: Stoppen Sie die Selbsthilfe und bitten Sie die zuständige Stelle um eine freigegebene Entwicklungsumgebung.
  • Wenn beide Befehle im neuen Terminal funktionieren: Verwenden Sie Homebrew für Ihre nächste Kursaufgabe. Notieren Sie den funktionierenden Installationspfad, damit Sie ihn bei einer späteren Prüfung wiederfinden.

Ein eigener Mac gibt Ihnen die größte Kontrolle über Terminal und Shell-Konfiguration. Auf einem Schul-Mac kann die Umgebung bereits vorbereitet sein, Änderungen an Installationen oder Startdateien können jedoch eingeschränkt sein. Umgehen Sie diese Einschränkungen nicht. Ein Remote-Mac kann eine Alternative sein, wenn Ihre lokale Umgebung die nötigen Entwicklungswerkzeuge nicht bereitstellt und Ihre Kursaufgabe über eine Netzwerkverbindung bearbeitet werden kann. Prüfen Sie dabei, ob der Kurs lokale Geräte oder Schnittstellen voraussetzt und welche Zugriffsrechte für die Nutzung gelten.

Wenn Sie vor der Entscheidung für eine Umgebung erst Ihre Kursanforderungen und mögliche Zugriffsformen abgleichen möchten, können Sie die Mac-Umgebungen bei MACCOME prüfen. Das ist besonders sinnvoll, wenn ein verwaltetes Gerät notwendige Installationen blockiert: Klären Sie zuerst, ob ein anderer freigegebener Mac-Zugang die Kursaufgaben abdeckt, statt Einschränkungen zu umgehen.

Wenn brew lediglich wegen eines fehlenden Shell-Eintrags nicht erkannt wird, beheben Sie zuerst genau diesen Fehler nach der offiziellen Anleitung. Ist dagegen Ihr aktuelles Gerät für die Kursumgebung ungeeignet oder dürfen Sie es nicht entsprechend konfigurieren, vergleichen Sie Ihre Anforderungen mit einer zulässigen Mac-Umgebung, bevor Sie weitere Installationsversuche starten. Ein gemieteter Mac kann für eine begrenzte Lern- oder Projektphase sinnvoll sein, wenn Sie eine macOS-Umgebung benötigen, ohne sofort ein eigenes Gerät anzuschaffen. Für dauerhaft intensive Nutzung kann ein eigener Mac besser passen; bei einer Remote-Umgebung müssen Sie außerdem eine stabile Internetverbindung einplanen. Wenn diese Bedingungen zu Ihrer Situation passen, finden Sie bei MACCOME Informationen zu verfügbaren Mac-mini-Optionen.