Skip to content
Discourse package for YunoHost
Shell
Branch: master
Clone or download
JimboJoe Merge pull request #44 from YunoHost-Apps/testing
Upgrade to upstream version 2.3.5
Latest commit 63605a0 Oct 12, 2019

README.md

Discourse for YunoHost

Integration level Install Discourse with YunoHost

This package allows you to install discourse quickly and simply on a YunoHost server. If you don't have YunoHost, please see here to know how to install and enjoy it.

Disclaimer

This package installs Discourse without Docker, for several reasons (mostly to support ARM architecture and low-profile servers, to mutualize nginx/postgresql/redis services and to simplify e-mail setup). As stated by the Discourse team:

The only officially supported installs of Discourse are Docker based. You must have SSH access to a 64-bit Linux server with Docker support. We regret that we cannot support any other methods of installation including cpanel, plesk, webmin, etc.

So please have this in mind when considering asking for Discourse support.

Moreover, you should have in mind Discourse hardware requirements:

  • modern single core CPU, dual core recommended
  • 1 GB RAM minimum (with swap)
  • 64 bit Linux compatible with Docker
  • 10 GB disk space minimum

Finally, if installing on a low-end ARM device (e.g. Raspberry Pi):

  • installation can last up to 3 hours,
  • first access right after installation could take a couple of minutes.

Overview

Discourse is the 100% open source discussion platform built for the next decade of the Internet. Use it as a:

  • mailing list
  • discussion forum
  • long-form chat room

To learn more about the philosophy and goals of the project, visit discourse.org.

Shipped version: 2.3.5

Screenshots

Boing Boing

Mobile

Configuration

Use the admin panel of your discourse to configure this app.

Configuring "Reply-By-Email"

  • You should create a dedicated Yunohost user for Discourse whose mailbox will be used by the Discourse application. You can do this with yunohost user create response, for example. You should ensure that the email address is configured to be on your Discourse domain.

  • You should then configure your Discourse /var/www/discourse/config/discourse.conf file with the correct SMTP configuration values. Please see this comment for an explanation of what values to change. Please be aware, when you update the application, you will have to re-apply this configuration.

  • You must enable the Pop3 configuration for Dovecot. See this thread on how to do that. You can validate your configuration with systemctl restart dovecot && dovecot -n. Don't forget to open the ports you need (995 is the default). You can validate that with nmap -p 995 yunohostdomain.org.

  • You should then configure the Pop3 polling in the Discourse admin interface. Please see this comment for how to do so. You will need to follow step 5 in that comment. You can specify your main Yunohost domain for the pop3_polling_host.

You should now be able to start testing. Try using the /admin/email "Send Test Email" and then view the "Sent" or "Skipped" etc. tabs. You should see a report on what happened with the email. You may also want to look in /var/www/discourse/log/production.log as well as /var/www/mail.err. You should perhaps also use Rainloop or another Yunohost email client application to quickly test that both your user and the dedicated Yunohost Discourse user (response@...) is receiving mail.

"Reply-By-Email" and mail forwarding

If you use the administration UI in YunoHost to setup a mail forwarding address for your users then you may face the problem whereby your users are replying by email from the forwarded email address and the Discourse software is not able to understand how to receive that email.

For example, your user has email address foo@myyunohostdomain.org and all mail is forwarded to foo@theirexternalmail.com. Discourse receives replies from foo@theirexternalmail.com but cannot understand how to deliver this to the user account with foo@myyunohostdomain.org configured.

Their is on-going work to allow for multiple email addresses for one user in Discourse development but at current major version (2.3 as of 2019-08-06), there is no web interface for this functionality. It is possible to set it up via the command-line interface but it is experimental and you should not undertake this work unless you take some time to understand what it is you are going to do.

Here's how to setup a secondary mail address for a user account:

$ cd /var/www/discourse
$ RAILS_ENV=production /opt/rbenv/versions/2.6.0/bin/bundle exec rails c
$ UserEmail.create!(user: User.find_by_username("foo"), email: "foo@theirexternalmail.com")

Discourse can now receive mail from foo@theirexternalmail.com and give it to the user account with mail address foo@myyunohostdomain.org.

Documentation

  • Official documentation: https://www.discourse.org/
  • YunoHost documentation: There no other documentations, feel free to contribute.

YunoHost specific features

  • Integration with YunoHost users and SSO:
    • LDAP integration: on the login pop-up, you can choose "Login with LDAP" and use your YunoHost credentials
    • private mode: Forum only accessible by YunoHost users
    • public mode: Visible by anyone

Multi-users support

Supported, with LDAP and SSO.

Login Popup

Default administrator and YunoHost users must login using LDAP:

  • click on the "with LDAP" button
  • use your YunoHost credentials

When disabling Local Login and other authentication services, clicking the Login or Sign Up button will directly bring up the LDAP Login popup.

Disable Local

LDAP Login Popup

Supported architectures

  • Tested on x86_64
  • Tested on ARM

Limitations

Known problems

  • In the administration dashboard, The installed version is shown as unknown (due the fact that we don't use git for installation); you can safely ignore that as the YunoHost package will be maintained.
  • On ARM devices, default generated avatars are missing the profile initials (they are only a plain discus)

Known non-impacting log messages

fatal: Not a git repository (or any of the parent directories): .git

bash: BASH_XTRACEFD: 7: invalid value for trace file descriptor

How-tos

Install plugins

cd /var/www/discourse
sudo -i -u discourse RAILS_ENV=production bin/rake --trace plugin:install repo=https://github.com/discourse/discourse-solved (for example)
sudo -i -u discourse RAILS_ENV=production bin/rake --trace assets:precompile
systemctl restart discourse

Links


Developers info

Please do your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/discourse_ynh/tree/testing --debug
or
sudo yunohost app upgrade discourse -u https://github.com/YunoHost-Apps/discourse_ynh/tree/testing --debug
You can’t perform that action at this time.