This brief tutorial shows students and new users how to install Discourse Forum software on Ubuntu 18.04 | 16.04.
Discourse is a modern, open-source discussion and forum solutions for the modern web that powers discussions on thousands of sites to drive user engagement.
With Discourse, webmasters and website owners can create a customizable hub of questions and interesting ideas that are searchable and integrates with popular services to enhance the platform.
When looking for a next generation forum platform that’s powerful and mobile-friendly, you might want to take a look at Discourse software. It’s simple, efficient and makes online discussion easy and fun… Discourse is built with Ruby on Rails, Ember.js and require Redis database software.
Individuals and webmasters can use Discourse Forums software to set up communities in minutes to stay in touch with group of people or ideas.
For more about Discourse, please visit its homepage.
To get started with installing Discourse Forum Software, please follow the steps below:
Step 1: Install Docker
The first requirement for Discourse forum software is to get Docker installed. to do that, run the commands below.
sudo apt update
sudo apt install git
After that, run the command below to download Docker and install it
wget -qO- https://get.docker.io/ | sh
After running the command above, Docker should be install and ready for Discourse.
Step 2: Download and Install Discourse
After installing Docker above, follow the steps below to download and install Discourse. First create a home directory download its content to. For this tutorial, we’re going to create a new folder call discourse in the /var directory. /var/discourse.
sudo mkdir /var/discourse
After that, run the commands below to download Discourse content into the /var/discourse directory.
sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse
Next, create a new Discourse environment file ( app.yml ) by copying its sample file to create a new one.
sudo cp /var/discourse/samples/standalone.yml /var/discourse/containers/app.yml
When you’re done, run the commands below to open the new app.yml file and edit it to match your environment
sudo nano /var/discourse/containers/app.yml
Make the highlighted changes and save the file.
## TODO: The domain name this Discourse instance will respond to
## Required. Discourse will not work with a bare IP number.
DISCOURSE_HOSTNAME: 'forum.example.com'
## TODO: List of comma delimited emails that will be made admin and developer
## on initial signup example 'user1@example.com,user2@example.com'
DISCOURSE_DEVELOPER_EMAILS: 'admin@example.com,superadmin@example.com'
## TODO: The SMTP mail server used to validate new accounts and send notifications
# SMTP ADDRESS, username, and password are required
# WARNING the char '#' in SMTP password can cause problems!
DISCOURSE_SMTP_ADDRESS: smtp.gmail.com
DISCOURSE_SMTP_PORT: 587
DISCOURSE_SMTP_USER_NAME: admin@example.com
DISCOURSE_SMTP_PASSWORD: pa$$word1
DISCOURSE_SMTP_ENABLE_START_TLS: true # (optional, default true)
## If you added the Lets Encrypt template, uncomment below to get a free SSL certificate
#LETSENCRYPT_ACCOUNT_EMAIL: me@example.com
Save the file and exit:
Step 3: Launch Discourse App
After all the setup above, your server should be ready. All you need to do is start up Discourse app and begin using.
To do that, run the commands below:
cd /var/discourse
./discourse-setup
Next, open your browser and browse to the hostname you defined above and you should see Discourse setup page.
Register and create an admin account. An activation mail to will be sent to the address you enter. You’ll want to follow the instructions in the email to activate your account.
After that, login and begin setting up your forum platform.
Whenever you edit the configuration file, run the commands below from Discourse directory to rebuild Discourse.
sudo ./launcher rebuild app
That’s it!
Conclusion:
This post shows you how to setup Discourse forum software on Ubuntu 18.04 | 16.04. If you find any error above, please use the comment form below to report it.