Diese Anleitung behandelt die Installationsanweisungen für eine macOS-Entwicklungsumgebung. Für Anleitungen zur Produktionsserver-Installation siehe: Install Discourse in production with the official supported instructions
Möchtest du Discourse auf macOS einrichten, um daran zu arbeiten und zu entwickeln?
Wir gehen davon aus, dass Ruby/Rails/Postgres/Redis noch nicht auf deinem Mac installiert sind. Fangen wir an 
!
Installation der Discourse-Abhängigkeiten
Du benötigst folgende Pakete auf deinem System:
- Git
- rbenv oder asdf
- ruby-build
- Ruby (aktuelle stabile Version)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- MailHog**
- ImageMagick**
optional
Starte dein Terminal neu
Nachdem wir die Discourse-Abhängigkeiten installiert haben, gehen wir zur Installation von Discourse selbst über.
Terminal neu starten
Beende deine Shell und starte sie neu, um sicherzustellen, dass die Pfade zu den installierten Paketen korrekt vom Terminal erkannt werden.
Discourse klonen
Klone das Discourse-Repository im Ordner ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
~ steht für den Home-Ordner, sodass der Discourse-Quellcode in deinem Home-Ordner verfügbar sein wird.
Discourse initialisieren
Wechsle in deinen Discourse-Ordner:
cd ~/discourse
Installiere die benötigten Gems:
bundle install
Installiere die JS-Abhängigkeiten:
pnpm install
Führe nun folgende 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 Möglichkeiten.
Option 1: Verwende zwei separate Terminal-Tabs/Fenster und starte Rails und Ember CLI separat über:
bundle exec rails server
und
bin/ember-cli
Option 2: Verwende nur ein Terminal-Fenster:
bin/ember-cli -u # startet den Pitchfork-Server im Hintergrund
Du solltest jetzt in der Lage sein, http://localhost:4200 aufzurufen, um deine lokale Discourse-Installation zu sehen. (Beachte, dass der erste Ladevorgang bis zu einer Minute dauern kann, da der Server erst initialisiert wird.)
Du kannst auch versuchen, die Tests auszuführen:
bundle exec rake autospec
Alle (oder fast alle) Tests sollten erfolgreich durchlaufen.
Neuer Administrator erstellen
Um einen neuen Administrator zu erstellen, führe folgenden Befehl aus:
RAILS_ENV=development bundle exec rake admin:create
Folge den Aufforderungen, um ein Administratorkonto zu erstellen.
E-Mail konfigurieren
Starte MailHog:
mailhog
Glückwunsch! Du bist jetzt Administrator deiner eigenen Discourse-Installation!
Viel Spaß beim Entwickeln! Um damit zu beginnen, lies die Anleitung für Anfänger zur Erstellung von Discourse-Plugins.
Dieses Dokument wird versionskontrolliert – schlage Änderungen auf GitHub vor.