Dieser Leitfaden behandelt die Installationsanweisungen für eine macOS-Entwicklungsumgebung. Für Anleitungen zur Produktion siehe: Install Discourse in production with the official supported instructions
Du möchtest also Discourse auf macOS einrichten, um daran zu arbeiten und es zu entwickeln?
Wir gehen davon aus, dass auf deinem Mac noch kein Ruby/Rails/Postgres/Redis installiert ist. Los geht’s 
!
Discourse-Abhängigkeiten installieren
Du benötigst die folgenden Pakete auf deinem System:
- Git
- rbenv oder asdf
- ruby-build
- Ruby (neueste stabile Version)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- libvips
- MailHog**
- ImageMagick**
** optional
Starte dein Terminal neu
Da wir nun die Discourse-Abhängigkeiten installiert haben, können wir mit der Installation von Discourse selbst fortfahren.
Terminal neu starten
Beende deine Shell und starte sie neu, um sicherzustellen, dass die Pfade zu den installierten Paketen vom Terminal korrekt erkannt werden.
Discourse klonen
Klone das Discourse-Repository in den Ordner ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
~ steht für den Home-Ordner, der Quellcode von Discourse wird also in deinem Home-Ordner verfügbar sein.
Discourse initialisieren (Bootstrap)
Wechsle in deinen Discourse-Ordner:
cd ~/discourse
Installiere die benötigten Gems
bundle install
Installiere die JS-Abhängigkeiten
pnpm install
Führe als Nächstes diese Befehle aus, um deine lokale Discourse-Instanz einzurichten:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Starte die Rails- und Ember-Server. Du hast hier zwei Optionen.
Option 1: Verwende zwei separate Terminal-Tabs/-Fenster und führe Rails und den Frontend-Bundler separat aus:
bundle exec rails server
und
bin/dev --only ember
Option 2: Verwende nur ein Terminal-Tab/-Fenster:
bin/dev # startet Pitchfork und den Frontend-Bundler gemeinsam
Jetzt solltest du in der Lage sein, unter http://localhost:3000 auf deine lokale Discourse-Installation zuzugreifen. (Beachte, dass der erste Laden bis zu einer Minute dauern kann, da der Server hochgefahren wird.)
Du kannst auch versuchen, die Spezifikationen auszuführen:
bundle exec rake autospec
Alle (oder fast alle) Tests sollten bestanden werden.
Neuen Admin erstellen
Um einen neuen Admin zu erstellen, führe den folgenden Befehl aus:
RAILS_ENV=development bundle exec rake admin:create
Folge den Anweisungen, um ein Admin-Konto zu erstellen.
E-Mail konfigurieren
Starte MailHog:
mailhog
Glückwunsch! Du bist jetzt der Admin deiner eigenen Discourse-Installation!
Viel Spaß beim Hacken! Und um damit zu beginnen, siehe Einsteiger-Leitfaden zum Erstellen von Discourse-Plugins.
Dieses Dokument wird versioniert verwaltet – Vorschläge für Änderungen auf GitHub.