Discourse

Learn about configurations >

• cors_origin | string

  Default: *

  Cors origin string to use, defaults to '*'.

• developer_emails | string

  Comma delimited list of email addresses that should have developer level access.

• enable_cors | boolean

  Default: True

  Enable Cross-origin Resource Sharing (CORS) at the application level (required for SSO).

• external_hostname | string

  External hostname this discourse instance responds to. Defaults to application name.

• force_https | boolean

  Configure Discourse to use https.

• force_saml_login | boolean

  Force SAML login (full screen, no local database logins).

• s3_access_key_id | string

  The S3 access key ID to use. Sets DISCOURSE_S3_ACCESS_KEY_ID. Required if s3_enabled is true.

• s3_backup_bucket | string

  The S3 bucket to use for backups. Sets DISCOURSE_S3_BACKUP_BUCKET. Also sets DISCOURSE_BACKUP_LOCATION=s3.

• s3_bucket | string

  The S3 bucket to use. Sets DISCOURSE_S3_BUCKET. Required if s3_enabled is true.

• s3_cdn_url | string

  The S3 Content Delivery Network URL. Sets DISCOURSE_S3_CDN_URL.

• s3_enabled | boolean

  Store uploaded objects in an S3-compatible object storage service instead of a local directory. If true, sets DISCOURSE_USE_S3=true. Check https://meta.discourse.org/t/using-object-storage-for-uploads-s3-clones/148916 for more details.

• s3_endpoint | string

  Default: https://s3.amazonaws.com

  The S3 endpoint to use. This may be a non-Amazon S3-compatible endpoint. Sets DISCOURSE_S3_ENDPOINT

• s3_install_cors_rule | boolean

  Default: True

  Will discourse set cors rule on the S3 bucket. Sets DISCOURSE_S3_INSTALL_CORS_RULE

• s3_region | string

  The S3 region to use. Sets DISCOURSE_S3_REGION. Required if s3_enabled is true.

• s3_secret_access_key | string

  The S3 secret key to use. Sets DISCOURSE_S3_SECRET_ACCESS_KEY. Required if s3_enabled is true.

• saml_sync_groups | string

  Comma-separated list of groups to sync from SAML provider.

• smtp_address | string

  Hostname / IP that should be used to send SMTP mail.

• smtp_authentication | string

  Default: none

  Type of smtp authentication to use. Valid values: none, login, plain, cram_md5.

• smtp_domain | string

  Hostname that email sent by this discourse should appear to come from.

• smtp_enable_start_tls | string

  Default: true

  Enable TLS encryption for smtp connections.

• smtp_force_tls | string

  Default: false

  Force implicit TLS as per RFC 8314 3.3.

• smtp_openssl_verify_mode | string

  Default: none

  Should discourse verify SSL certs.

• smtp_password | string

  Password to use when sending mail via SMTP.

• smtp_port | int

  Default: 587

  Port to use when connecting to SMTP server.

• smtp_username | string

  Username to use when sending mail via SMTP.

• throttle_level | string

  Default: none

  Throttle level - blocks excessive usage by ip. Accepted values: none, permissive, strict.