Ce guide couvre les instructions d’installation pour un environnement de développement macOS. Pour les guides de mise en production, consultez : Install Discourse in production with the official supported instructions
Vous souhaitez installer Discourse sur macOS pour le développer et y apporter des modifications ?
Nous supposerons que Ruby, Rails, Postgres et Redis ne sont pas installés sur votre Mac. Commençons 
!
Installer les dépendances de Discourse
Vous aurez besoin des packages suivants sur votre système :
- Git
- rbenv ou asdf
- ruby-build
- Ruby (dernière version stable)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- MailHog**
- ImageMagick**
** facultatif
redémarrez votre terminal
Maintenant que nous avons installé les dépendances de Discourse, passons à l’installation de Discourse lui-même.
Redémarrez votre Terminal
Quitter votre shell et le redémarrer garantit que les chemins d’accès aux packages installés sont correctement pris en compte par le Terminal.
Cloner Discourse
Clonez le dépôt Discourse dans le dossier ~/discourse :
git clone https://github.com/discourse/discourse.git ~/discourse
~ indique le dossier personnel, le code source de Discourse sera donc disponible dans votre dossier personnel.
Initialiser Discourse
Passez dans le dossier Discourse :
cd ~/discourse
Installez les gems nécessaires :
bundle install
Installez les dépendances JS :
pnpm install
Ensuite, exécutez ces commandes pour configurer votre instance locale de Discourse :
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Démarrez les serveurs Rails et Ember. Vous avez deux options.
Option 1 : en utilisant deux onglets/fenêtres Terminal séparés, exécutez Rails et Ember CLI séparément via :
bundle exec rails server
et
bin/ember-cli
Option 2 : en utilisant un seul onglet/fenêtre Terminal :
bin/ember-cli -u # lancera le serveur Pitchfork en arrière-plan
Vous devriez maintenant pouvoir naviguer vers http://localhost:4200 pour voir votre installation locale de Discourse. (Notez que le premier chargement peut prendre jusqu’à une minute car le serveur doit se réchauffer.)
Vous pouvez également essayer d’exécuter les tests :
bundle exec rake autospec
Tous (ou presque tous) les tests devraient passer.
Créer un nouvel administrateur
Pour créer un nouvel administrateur, exécutez la commande suivante :
RAILS_ENV=development bundle exec rake admin:create
Suivez les invites pour créer un compte administrateur.
Configurer la messagerie
Exécutez MailHog :
mailhog
Félicitations ! Vous êtes maintenant l’administrateur de votre propre installation Discourse !
Bon développement ! Pour commencer, consultez le Guide du débutant pour créer des plugins Discourse.
Ce document est sous contrôle de version - proposez des modifications sur GitHub.