Ce guide couvre les instructions d’installation dans un environnement de développement. Pour un guide de production, consultez : Install Discourse in production with the official supported instructions
Vous souhaitez installer Discourse sur Ubuntu ou Debian pour le développer et le modifier ?
Nous supposerons que vous travaillez localement et que Ruby, Rails, Postgres et Redis ne sont pas installés sur votre système Ubuntu ou Debian. C’est parti !
Prérequis
Nous recommandons au moins 4 Go de RAM et 2 cœurs CPU.
Compatibilité actuelle :
| Système d’exploitation | Compatibilité |
|---|---|
| Debian 11 |  |
| Crostini (Linux sur ChromeOS) | |
| Ubuntu 22.04 ou ultérieur | |
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**
** optionnel
Maintenant que les dépendances de Discourse sont installées, passons à l’installation de Discourse lui-même.
Cloner Discourse
Cloner 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 portant le même nom que votre nom d’utilisateur Linux :
cd /tmp && sudo -u postgres createuser -s "$USER"
Initialiser Discourse
Passez dans le dossier Discourse :
cd ~/discourse
Installez les gems nécessaires :
source ~/.bashrc
bundle install
Installez les dépendances JS :
pnpm install
Maintenant que les gems sont installées avec succès, 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 n’apparaissent pas, utilisez cette commande à la place :
(vous pouvez également spécifier une adresse 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 invites et un nouveau compte administrateur sera créé.
Configurer la messagerie
Lancez 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.
Dernière révision par @blake le 2023-04-03T06:00:00Z
Ce document est sous contrôle de version - proposez des modifications sur GitHub.