How to Install Discourse on Ubuntu 14.04

Discourse is a modern, open-source discussion and forum system. Visit the official site for a demo and a breakdown of the current feature set. This tutorial will teach you how to set up Discourse with Docker on Ubuntu 14.04.

Create A New AKWLEB HOST VPS

1GB of RAM is the minimum amount, although it is recommended to use at least 2GB of RAM. Always select the latest 64-bit LTS distribution.

Access Your AKWLEB HOST VPS

Connect to your server using SSH via the Terminal on Mac or PuTTY on Windows.

ssh root@123.456.7.8

Replace 123.456.7.8 with your Server IP.

You will be prompted to type Yes or No to add the server’s RSA fingerprint to your list of known hosts. Type Yes and hit Enter.

Set Up Swap (Only For 1GB Install)

  1. Create an empty swap file: sudo install -o root -g root -m 0600 /dev/null /swapfile

  2. Write out a 1GB file named: swapfile: dd if=/dev/zero of=/swapfile bs=1k count=1024k

  3. Tell Linux that this is the swap file: mkswap /swapfile

  4. Activate it: swapon /swapfile

  5. Add it to the system table so that it is available after reboot: echo "/swapfile swap swap auto 0 0" | sudo tee -a /etc/fstab

  6. Set the swappiness so that it is only used as an emergency buffer: sudo sysctl -w vm.swappiness=10

Install Docker/Git

Run the following command: wget -qO- https://get.docker.io/ | sh

Install Discourse

Make a folder called discourse in the /var directory: mkdir /var/discourse

Clone the official Discourse git repository in /var/discourse: 

git clone https://github.com/discourse/discourse_docker.git /var/discourse

Go into the Discourse directory: cd /var/discourse

Make a copy of the config file as app.yml: 

cp samples/standalone.yml containers/app.yml

Edit The Discourse Configuration

Edit the app.yml file: nano app.yml

Set DISCOURSE_DEVELOPER_EMAILS to your email address.

Set DISCOURSE_HOSTNAME to your web address to access Discourse (example: discourse.aklwebhost.com).

Enter your email credentials in DISCOURSE_SMTP_ADDRESS, DISCOURSE_SMTP_PORT, DISCOURSE_SMTP_USERNAME, and DISCOURSE_SMTP_PASSWORD. Be sure to remove the # (hashtag) before editing the following strings.

If you are running only 1GB of RAM, set UNICORN_WORKERS to 2 and db_shared_buffers to 128MB so that you have more memory room.

Save the file and exit.

It is important to note that you must have your email settings set up properly – otherwise, you’ll have a broken site!

Bootstrap Discourse

Run: ./launcher bootstrap app

You may be asked a question during the installation about SSH keys. Type Yes.

Once the bootstrap process completes, start Discourse: ./launcher start app

Setup Complete

Congratulations – you now have your instance of Discourse up and running!

To access it, simply type in what you set for DISCOURSE_HOSTNAME in the configuration file.

Enjoy!