discourse-standalone

Example:

# Install Discourse.
- discourse-standalone:
    hostname: friends.of.freckles.io
    admin_emails:
    - hello@frkl.io
    discourse_smtp_address: smtp.postmarkapp.com
    discourse_smtp_port: 587
    discourse_smtp_user_name: uuid-uuid-uuid-uuid...
    discourse_smtp_password: super-secret-password...

Description

Install and configure a discourse instance.

This uses the '30 minute guide' from the official Discourse GitHub repository.

Variables

Name Type Default Description

admin_emails

list --

The first email will also be set as the letsencrypt contact email. Required

discourse_smtp_address

string --

The SMTP server address. Required

discourse_smtp_password

string --

The SMTP password. Required

discourse_smtp_port

integer --

The SMTP port. Required

discourse_smtp_user_name

string --

The SMTP user name. Required

hostname

string --

The discourse hostname. Required

discourse_plugins

list []

A list of discourse plugin urls.

discourse_smtp_enable_start_tls

boolean True

Whether to use START_TLS when connecting to the SMTP server.

discourse_version

string stable

The version of discourse.

set_from_email

string --

This only needs to be set/run once, at install time. Needs to be an address that is supported by your smtp settings.

use_https

boolean True

Whether to use https with letsencrypt.

Examples

Example 1

Install Discourse.

Code
- discourse-standalone:
    hostname: friends.of.freckles.io
    admin_emails:
    - hello@frkl.io
    discourse_smtp_address: smtp.postmarkapp.com
    discourse_smtp_port: 587
    discourse_smtp_user_name: uuid-uuid-uuid-uuid...
    discourse_smtp_password: super-secret-password...
Description

This needs mail setup beforehand (refer to Discourse documentation for this).

Command-line

frecklecute --community discourse-standalone --help

Usage: frecklecute discourse-standalone [OPTIONS]

  Install and configure a [discourse](https://discourse.org) instance.

  This uses the ['30 minute
  guide'](https://github.com/discourse/discourse/blob/master/docs/INSTALL-
  cloud.md) from the official [Discourse GitHub
  repository](https://github.com/discourse/discourse).

Options:
  --admin-email EMAIL             A list of email addresses that will be
                                  admins after install.  [required]
  --discourse-smtp-address DISCOURSE_SMTP_ADDRESS
                                  The SMTP server address.  [required]
  --discourse-smtp-password DISCOURSE_SMTP_PASSWORD
                                  The SMTP password.  [required]
  --discourse-smtp-port DISCOURSE_SMTP_PORT
                                  The SMTP port.  [required]
  --discourse-smtp-user-name DISCOURSE_SMTP_USER_NAME
                                  The SMTP user name.  [required]
  --hostname HOSTNAME             The discourse hostname.  [required]
  --discourse-plugins PLUGIN      A list of discourse plugin urls.
  --start-tls / --no-start-tls    Whether to use START_TLS when connecting to
                                  the SMTP server.
  --discourse-version DISCOURSE_VERSION
                                  The version of discourse.
  --set-from-email SET_FROM_EMAIL
                                  A custom 'from' email address (e.g.
                                  noreply@example.com).
  --use-https / --no-use-https    Whether to use https with letsencrypt.
  --help                          Show this message and exit.