Skip to content

Global configuration options

pcarranza edited this page Sep 14, 2014 · 3 revisions

Global configuration options

This page is a quick effort to gather all the global configuration options that can be set in the app.yml file.

Email configuration options

  • DISCOURSE_SMTP_ADDRESS: address of the SMTP server, if not set, drops to sendmail -i
  • DISCOURSE_SMTP_PORT: port of the SMTP server
  • DISCOURSE_SMTP_DOMAIN: the smtp domain
  • DISCOURSE_SMTP_USER_NAME: the username to use for SMTP authentication
  • DISCOURSE_SMTP_PASSWORD: the password for SMTP authentication
  • DISCOURSE_SMTP_AUTHENTICATION: the authentication method, 'plain' by default, 'none' to completely disable authentication.
  • DISCOURSE_SMTP_ENABLE_START_TLS: whether or not to use TLS (true/false)
  • DISCOURSE_SMTP_OPENSSL_VERIFY_MODE: its value may be either an OpenSSL verify mode constant (OpenSSL::SSL::VERIFY_NONE), or a string containing the name of an OpenSSL verify mode (none, peer, client_once, fail_if_no_peer_cert). 'none' to disable ssl verification.

Refer to milek/mail for more email configuration options.

Samples that can be easily adapted:

More configurable global options

  • DISCOURSE_LOAD_MINI_PROFILER: allows developers to use mini profiler
  • DISCOURSE_CDN_URL: discourse strongly recommend you use a CDN. For origin pull cdns all you need to do is register an account and configure
  • DISCOURSE_SERVE_STATIC_ASSETS: disable Rails's static asset server (Apache or nginx will already do this)
  • DISCOURSE_REDIS_HOST: redis host
  • DISCOURSE_REDIS_PORT: redis port
  • DISCOURSE_REDIS_PASSWORD: redis password
  • DISCOURSE_REDIS_DB: redis database
  • DISCOURSE_DEVELOPER_EMAILS: main admin email address
  • DISCOURSE_ENABLE_CORS: allow cross domain ajax calls, refer to rack-cors
  • DISCOURSE_CORS_ORIGIN: allowed dommain fro cross domain ajax calls, list splitted with comma