Ce guide couvre les instructions d’installation dans un environnement de développement. Pour un guide de production, voir : Install Discourse in production with the official supported instructions
Vous souhaitez donc configurer Discourse sur Ubuntu ou Debian pour le modifier et le développer ?
Nous supposons que vous travaillez localement et que Ruby/Rails/Postgres/Redis ne sont pas installés sur votre système Ubuntu ou Debian. Commençons !
Prérequis
Nous suggérons d’avoir au moins 4 Go de RAM et 2 cœurs de CPU.
Compatibilité actuelle :
| OS | Compatibilité |
|---|---|
| Debian 11 | |
| Crostini (Linux sur ChromeOS) | |
| Ubuntu 22.04 ou ultérieur |
Installer les dépendances de Discourse
Vous aurez besoin des paquets suivants sur votre système :
- Git
- rbenv ou asdf
- ruby-build
- Ruby (dernière version stable)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- libvips
- MailHog**
- ImageMagick**
** optionnel
Maintenant que nous avons installé les dépendances de Discourse, passons à l’installation de Discourse lui-même.
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.
Configurer la base de données
Créez un rôle avec le même nom que votre nom d’utilisateur système Linux :
cd /tmp && sudo -u postgres createuser -s "$USER"
[/details]
Initialiser Discourse
Passez à votre dossier Discourse :
cd ~/discourse
Installez les gems nécessaires
source ~/.bashrc
bundle install
Installez les dépendances JS
pnpm install
Maintenant que vous avez installé avec succès les gems, exécutez ces commandes :
bin/rails db:create
bin/rails db:migrate
RAILS_ENV=test bin/rails db:create db:migrate
Démarrez rails et le bundler frontend :
bin/dev
Si les images ne s’affichent pas, utilisez cette commande à la place :
(vous pouvez également spécifier une IP si vous travaillez sur un serveur distant)
DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/dev
Vous devriez maintenant pouvoir naviguer vers http://localhost:3000 pour voir votre installation locale de Discourse.
Créer un nouvel administrateur
Pour créer un nouvel administrateur, exécutez la commande suivante :
bin/rails admin:create
Suivez les instructions, et un nouveau compte administrateur sera créé.
Configurer le courrier
Exécutez MailHog :
mailhog
Félicitations ! Vous êtes maintenant l’administrateur de votre propre installation Discourse !
Bonne programmation ! Et pour commencer, consultez le Guide du débutant pour créer des plugins Discourse.
Dernière vérification par @blake le 2023-04-03T06:00:00Z
Ce document est sous contrôle de version - suggérez des modifications sur github.