How to use the Discourse One-Click Application on DigitalOcean
Discourse is a popular piece of discussion forum software written in Ruby on Rails. Discourse provides a number of built in improvements over previous generation forum software including mobile support, oAuth authentication options, a user trust system, notifications and many other features.
DigitalOcean's Discourse one-click application image provides an easy way to get started with a Discourse forum. This tutorial will walk you through creating and setting up a new Discourse droplet.
Based on Ubuntu 14.04, the Discourse One-Click Application Image uses the official Discourse Docker container to provide all the components required to run Discourse which includes
- Ruby on Rails
- Nginx Web Server
- PostgreSQL Database Server
When launching your new Droplet you will be prompted for several pieces of information that are used to configure Discourse. Before beginning you should have the following information available:
- An email address to use for the administrator account.
- SMTP credentials to allow Discourse to send email
- A hostname (domain or subdomain) for your forum.
You can find more information on setting up a hostname on your DigitalOcean account here.
The SMTP credentials you provide are critical for account creation and notifications in discourse. If you have an existing mail server you can provide those credentials, otherwise there are several providers where you can set up a free (but limited) SMTP account such as: SparkPost (10k emails/month) Mailgun (10k emails/month), Mailjet (200 emails/day) or Mandrill, and use the credentials provided in the dashboard.
Create a Discourse Droplet
To get started, log into the DigitalOcean Control Panel.
Then click the Create Droplet button.
At the droplet creation page, specify your new droplet's hostname and select a droplet size. Discourse requires a droplet with at least 2GB of RAM.
Select your desired region
Now, in the Select Image section, click the Applications tab and choose the Discourse on 14.04 image:
Next, select any additional settings, such as private networking, IPv6, or backups.
Finally, select which SSH keys, if any, you want to use for accessing your new Droplet, and click the Create Droplet button.
Your Discourse droplet will now be created. For more details about creating Droplets, check out this tutorial: How to Create your First DigitalOcean Droplet.
Access your new Droplet
Before you begin using your new Discourse forum you will first need to log into your droplet via SSH in order to complete the setup.
If you haven't used SSH or PuTTY before, you may want to refer to this tutorial for more details: How To Connect To Your Droplet with SSH.
On your computer, open a terminal and log into your droplet as
root with this command (substitute your droplet's IP address):
- ssh firstname.lastname@example.org
If you are prompted for a password, enter the password that was emailed to you when the Droplet was created. Alternatively, if you set up the Droplet with SSH keys, the keys will be used for authentication instead.
Once you are connected to your droplet via SSH you will be prompted to complete the configuration of your new Discourse forum.
Once you provide these details, Discourse will be configured and you can visit your Droplet's IP or hostname via a web browser.
Now that you have your new Discourse forum up and running you may want to learn about ways to customize or extend it. The official discourse forums include a howto section with lots of great ways to get the most out of your Discourse installation.