Skip to main content

Logo Discourse

About​

Discourse is a platform for community discussion. Free, open, simple.

Installing plugins​

To install a plugin, open a Web terminal and run the following commands:

Bash
cd /app/code/plugins
git clone <plugin-repo>
chown -R cloudron:cloudron <plugin-dir>
cd /app/code
gosu cloudron:cloudron bundle exec rake plugin:install_all_gems
gosu cloudron:cloudron bundle exec rake db:migrate
gosu cloudron:cloudron bundle exec rake assets:precompile

Restart the application to double check everything works.

If the plugin modifies the posts in some way, you might want to rebake posts.

Install with care

Use caution when installing plugins since they might break your installation. The list of official plugins can be found here.

Changing root account email​

The email of the root account is root@cloudron.local. Discourse sends an activation email to the old email address to switch email. Use the rails console to switch the email.

Open a Web terminal and run the following commands:

Bash
cd /app/code
gosu cloudron:cloudron bundle exec script/rails console
# The following lines start with "discourse(prod)>" that indicates the rails console is active
u = User.find_by_username("root")
u.email = "YOUR_NEW_EMAIL_ADDRESS"
u.save!
exit

Changing root account password​

To change the password of the root account, open a Web terminal and run the following commands:

Bash
cd /app/code
gosu cloudron:cloudron bundle exec script/rails console
# The following lines start with "discourse(prod)>"" that indicates the rails console is active
u = User.find_by_username("root")
u.password = "YOUR_NEW_PASSWORD"
u.save!
exit

Changing domain​

When changing the domain of an existing discourse installation, Cloudron automatically rebuilds the assets. However, the posts in the forum are not re-written. To rebake the posts, open a Web terminal and run the following command:

Bash
cd /app/code
gosu cloudron:cloudron bundle exec ruby script/discourse remap old.domain.com new.domain.com

Rebaking posts​

To rebuild all posts (for example, to apply formatting provided by a newly installed plugin to old posts), open a Web terminal and run the following command:

Bash
cd /app/code
gosu cloudron:cloudron bundle exec rake posts:rebake

Importing settings​

Discourse allows importing settings from a file. This provides faster configuration of plugins or discourse itself.

For example, after installing the plugin translator, import a working configuration:

Example config file content for importing:

YAML
translator_enabled: true
translator_provider: LibreTranslate
translator_libretranslate_endpoint: https://com.libretranslate.cloudronapp.cloudron.example
translator_libretranslate_api_key: e356cb19-3f06-4120-af2f-fa86df56f278
max_translations_per_minute: 30

Upload this file to the Discourse app with the Web Terminal.

Import this file:

Bash
gosu cloudron:cloudron bundle exec rake site_settings:import </tmp/settings.yml

This will import the given settings directly into the discourse database.

Restart the app.

After the restart, you should see the configuration applied in the admin view for all site settings.

Incoming email setup​

  • set up a mail inbox for your discourse app E.g. forum@cloudron.example

  • enable pop3 for that mailbox

  • set the app as the owner of this mailbox

    Create Inbox

  • Set both the Mail FROM Address and Incoming mail to the same mailbox.

    Mail Setting

Use same mailbox

Discourse does not support having different mail from and incoming mail address

In Discourse, you'll need to enable email in in the administration settings.

Topic creation with unique category inbox name​

To enable creation of new topics via email, go to the settings page of a category and set a custom incoming email address.

Category Email Setup

For unique addresses per category, setup [mail aliases](email.md #mail-aliases) for forum@YourMailDomain.TLD. For a category named offtopic, create a [mail alias](email.md #mail-aliases) like forum@YourMailDomain.TLD. Create a wildcard [mail alias](email.md #mail-aliases) * to choose any category name freely.

Wildcard Alias