Discourse is an open source Internet forum software application. Discourse is different to existing forum software by including features recently popularized by large social networks. The application is written with Ember.js and Ruby on Rails. The backend database management system used by Discouse is PostgreSQL.
This tutorial will guide you to setup discourse using the official Docker image. The Docker container contains everything that is required to run Discourse and makes it much more easier to deploy, administer and upgrade the software.
1 . Log into your instance using SSH.
2 . Update the
apt packet cache and upgrade the software already installed on the instance to the latest version available in Ubuntu’s Repositories:
apt update && apt ugprade -y
3 . Install packages required for Discourse:
apt install -y git netcat
4 . Clone the Discouse Docker repository into the local directory
git clone https://github.com/discourse/discourse_docker.git /var/discourse
5 . Enter the locally cloned repository:
6 . Run the Discourse setup:
Important: It is required that:
- a valid (sub-)domain is pointed to your instance. Discourse will not work from an IP address. If you do not have a domain name yet, you can order one now. Create a sub-domain like
forum.mydomain.comfor your Discourse instance.
- you have a SMTP server available to send out emails from Discourse. You can either configure an own SMTP server or use a STMP service like SendInBlue or Mailjet. Make sure that the instances SMTP ports are enabled. Discourse will not work if it can not send emails.
7 . Answer the following questions:
Hostname for your Discourse? [discourse.example.com]: Email address for admin account(s)? [email@example.com,firstname.lastname@example.org]: SMTP server address? [smtp.example.com]: SMTP port? : SMTP user name? [email@example.com]: SMTP password? [pa$$word]: Let's Encrypt account email? (ENTER to skip) [firstname.lastname@example.org]:
8 . Once all details are entered, a
app.yml configuration file is being generated on your behalf before bootstrapping the installation. Please note that the installation of Discourse may take up to 10 minutes depending on your instance type.
1 . Once the installation is complete, open your web browser and go to your discourse subdomain (i.e.
https://discourse.example.com). The configuration wizard displays. Click Register to create the first (admin) user:
2 . Enter an identifier and a secret password for the new user. Make sure that your email address is valid, as you will receive a confirmation link in this mailbox. Click Register to continue:
3 . Check your email inbox and click on the link to confirm your email address and finish the creation of the admin user.
1 . Once you have validated your email address, the Discourse configuration wizard displays. Choose the language for the application and click Next:
2 . Complete the wizard to customize your community towards your needs.
3 . Your Discourse community is ready now: