2016-03-16 11:13:40 +00:00
# Service dependencies
2017-05-03 21:18:13 +00:00
# You may set REDIS_URL instead for more advanced options
2017-09-22 04:44:39 +00:00
# You may also set REDIS_NAMESPACE to share Redis between multiple Mastodon servers
2016-03-14 20:39:39 +00:00
REDIS_HOST=redis
2016-03-16 11:57:01 +00:00
REDIS_PORT=6379
2017-05-04 13:53:44 +00:00
# You may set DATABASE_URL instead for more advanced options
2016-03-16 11:57:01 +00:00
DB_HOST=db
DB_USER=postgres
DB_NAME=postgres
DB_PASS=
DB_PORT=5432
2018-02-09 22:04:47 +00:00
# Optional ElasticSearch configuration
2019-05-09 20:41:27 +00:00
# You may also set ES_PREFIX to share the same cluster between multiple Mastodon servers (falls back to REDIS_NAMESPACE if not set)
2018-02-09 22:04:47 +00:00
# ES_ENABLED=true
2018-03-09 10:32:55 +00:00
# ES_HOST=es
2018-02-09 22:04:47 +00:00
# ES_PORT=9200
2016-03-16 11:13:40 +00:00
# Federation
2017-12-22 01:17:59 +00:00
# Note: Changing LOCAL_DOMAIN at a later time will cause unwanted side effects, including breaking all existing federation.
2017-05-19 18:55:15 +00:00
# LOCAL_DOMAIN should *NOT* contain the protocol part of the domain e.g https://example.com.
2018-02-04 04:42:13 +00:00
LOCAL_DOMAIN=example.com
2017-12-22 01:17:59 +00:00
# Changing LOCAL_HTTPS in production is no longer supported. (Mastodon will always serve https:// links)
2016-03-16 11:13:40 +00:00
2017-04-15 00:15:46 +00:00
# Use this only if you need to run mastodon on a different domain than the one used for federation.
2017-05-05 02:56:28 +00:00
# You can read more about this option on https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Serving_a_different_domain.md
# DO *NOT* USE THIS UNLESS YOU KNOW *EXACTLY* WHAT YOU ARE DOING.
2017-04-15 00:15:46 +00:00
# WEB_DOMAIN=mastodon.example.com
2017-05-22 13:40:04 +00:00
# Use this if you want to have several aliases handler@example1.com
# handler@example2.com etc. for the same user. LOCAL_DOMAIN should not
# be added. Comma separated values
# ALTERNATE_DOMAINS=example1.com,example2.com
2016-03-16 11:13:40 +00:00
# Application secrets
2017-09-05 10:13:25 +00:00
# Generate each with the `RAILS_ENV=production bundle exec rake secret` task (`docker-compose run --rm web rake secret` if you use docker compose)
2016-03-14 20:39:39 +00:00
SECRET_KEY_BASE=
2017-01-29 12:06:58 +00:00
OTP_SECRET=
2016-03-16 11:13:40 +00:00
2017-07-13 20:15:32 +00:00
# VAPID keys (used for push notifications
# You can generate the keys using the following command (first is the private key, second is the public one)
# You should only generate this once per instance. If you later decide to change it, all push subscription will
# be invalidated, requiring the users to access the website again to resubscribe.
#
2017-09-05 10:13:25 +00:00
# Generate with `RAILS_ENV=production bundle exec rake mastodon:webpush:generate_vapid_key` task (`docker-compose run --rm web rake mastodon:webpush:generate_vapid_key` if you use docker compose)
2017-07-13 20:15:32 +00:00
#
# For more information visit https://rossta.net/blog/using-the-web-push-api-with-vapid.html
VAPID_PRIVATE_KEY=
VAPID_PUBLIC_KEY=
2016-12-06 16:19:26 +00:00
# Registrations
# Single user mode will disable registrations and redirect frontpage to the first profile
# SINGLE_USER_MODE=true
# Prevent registrations with following e-mail domains
# EMAIL_DOMAIN_BLACKLIST=example1.com|example2.de|etc
2017-04-04 15:04:44 +00:00
# Only allow registrations with the following e-mail domains
# EMAIL_DOMAIN_WHITELIST=example1.com|example2.de|etc
2016-12-06 16:19:26 +00:00
2017-04-07 10:40:26 +00:00
# Optionally change default language
# DEFAULT_LOCALE=de
2016-03-16 11:13:40 +00:00
# E-mail configuration
2017-04-07 11:43:44 +00:00
# Note: Mailgun and SparkPost (https://sparkpo.st/smtp) each have good free tiers
2017-04-17 08:41:19 +00:00
# If you want to use an SMTP server without authentication (e.g local Postfix relay)
2018-02-04 04:42:13 +00:00
# then set SMTP_AUTH_METHOD and SMTP_OPENSSL_VERIFY_MODE to 'none' and
2017-05-08 01:34:11 +00:00
# *comment* SMTP_LOGIN and SMTP_PASSWORD (leaving them blank is not enough).
2016-03-16 11:13:40 +00:00
SMTP_SERVER=smtp.mailgun.org
SMTP_PORT=587
SMTP_LOGIN=
SMTP_PASSWORD=
SMTP_FROM_ADDRESS=notifications@example.com
2017-04-17 08:42:29 +00:00
#SMTP_DOMAIN= # defaults to LOCAL_DOMAIN
2017-04-13 17:51:49 +00:00
#SMTP_DELIVERY_METHOD=smtp # delivery method can also be sendmail
2017-04-10 19:48:30 +00:00
#SMTP_AUTH_METHOD=plain
2017-05-02 23:03:12 +00:00
#SMTP_CA_FILE=/etc/ssl/certs/ca-certificates.crt
2017-04-10 19:48:30 +00:00
#SMTP_OPENSSL_VERIFY_MODE=peer
#SMTP_ENABLE_STARTTLS_AUTO=true
2017-08-01 13:00:29 +00:00
#SMTP_TLS=true
2016-11-26 14:27:05 +00:00
2017-04-15 00:07:21 +00:00
# Optional user upload path and URL (images, avatars). Default is :rails_root/public/system. If you set this variable, you are responsible for making your HTTP server (eg. nginx) serve these files.
# PAPERCLIP_ROOT_PATH=/var/lib/mastodon/public-system
# PAPERCLIP_ROOT_URL=/system
2016-11-26 14:27:05 +00:00
# Optional asset host for multi-server setups
2018-03-28 18:40:18 +00:00
# The asset host must allow cross origin request from WEB_DOMAIN or LOCAL_DOMAIN
# if WEB_DOMAIN is not set. For example, the server may have the
# following header field:
# Access-Control-Allow-Origin: https://example.com/
2017-05-30 16:39:28 +00:00
# CDN_HOST=https://assets.example.com
2016-11-29 13:20:15 +00:00
# S3 (optional)
2018-05-28 22:43:47 +00:00
# The attachment host must allow cross origin request from WEB_DOMAIN or
# LOCAL_DOMAIN if WEB_DOMAIN is not set. For example, the server may have the
# following header field:
# Access-Control-Allow-Origin: https://192.168.1.123:9000/
2016-12-06 16:19:26 +00:00
# S3_ENABLED=true
# S3_BUCKET=
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# S3_REGION=
2017-03-23 07:44:55 +00:00
# S3_PROTOCOL=http
# S3_HOSTNAME=192.168.1.123:9000
2016-12-06 16:19:26 +00:00
2017-04-07 10:58:12 +00:00
# S3 (Minio Config (optional) Please check Minio instance for details)
2018-05-28 22:43:47 +00:00
# The attachment host must allow cross origin request - see the description
# above.
2017-04-07 10:58:12 +00:00
# S3_ENABLED=true
# S3_BUCKET=
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# S3_REGION=
# S3_PROTOCOL=https
# S3_HOSTNAME=
# S3_ENDPOINT=
2017-04-19 12:18:50 +00:00
# S3_SIGNATURE_VERSION=
2017-04-07 10:58:12 +00:00
2017-09-06 10:13:00 +00:00
# Swift (optional)
2018-05-28 22:43:47 +00:00
# The attachment host must allow cross origin request - see the description
# above.
2017-09-06 10:13:00 +00:00
# SWIFT_ENABLED=true
# SWIFT_USERNAME=
2017-09-11 13:11:13 +00:00
# For Keystone V3, the value for SWIFT_TENANT should be the project name
2017-09-06 10:13:00 +00:00
# SWIFT_TENANT=
# SWIFT_PASSWORD=
2018-05-07 00:28:28 +00:00
# Some OpenStack V3 providers require PROJECT_ID (optional)
# SWIFT_PROJECT_ID=
2017-09-11 13:11:13 +00:00
# Keystone V2 and V3 URLs are supported. Use a V3 URL if possible to avoid
# issues with token rate-limiting during high load.
2017-09-06 10:13:00 +00:00
# SWIFT_AUTH_URL=
# SWIFT_CONTAINER=
# SWIFT_OBJECT_URL=
2017-09-11 13:11:13 +00:00
# SWIFT_REGION=
# Defaults to 'default'
# SWIFT_DOMAIN_NAME=
# Defaults to 60 seconds. Set to 0 to disable
# SWIFT_CACHE_TTL=
2017-09-06 10:13:00 +00:00
2018-08-25 11:27:08 +00:00
# Optional alias for S3 (e.g. to serve files on a custom domain, possibly using Cloudfront or Cloudflare)
# S3_ALIAS_HOST=
2017-01-29 12:06:58 +00:00
2017-02-03 23:34:31 +00:00
# Streaming API integration
# STREAMING_API_BASE_URL=
2017-04-09 03:46:32 +00:00
# Advanced settings
# If you need to use pgBouncer, you need to disable prepared statements:
# PREPARED_STATEMENTS=false
2017-04-17 02:32:30 +00:00
# Cluster number setting for streaming API server.
# If you comment out following line, cluster number will be `numOfCpuCores - 1`.
STREAMING_CLUSTER_NUM=1
2017-05-20 18:01:05 +00:00
# Docker mastodon user
# If you use Docker, you may want to assign UID/GID manually.
# UID=1000
# GID=1000
2018-02-04 22:36:19 +00:00
2017-11-14 15:22:34 +00:00
# Maximum allowed character count
2017-11-14 16:56:38 +00:00
# MAX_TOOT_CHARS=500
2018-02-04 04:42:13 +00:00
2019-04-29 00:10:30 +00:00
# Maximum number of pinned posts
# MAX_PINNED_TOOTS=5
2019-06-02 13:24:46 +00:00
# Maximum allowed bio characters
# MAX_BIO_CHARS=500
# Maximim number of profile fields allowed
# MAX_PROFILE_FIELDS=4
# Maximum allowed display name characters
# MAX_DISPLAY_NAME_CHARS=30
2019-06-02 10:14:06 +00:00
# Maximum image and video upload sizes
# Units are in bytes
2019-06-02 12:36:02 +00:00
# 1048576 bytes equals 1 megabyte
# MAX_IMAGE_SIZE=8388608
# MAX_VIDEO_SIZE=41943040
2019-06-02 10:14:06 +00:00
2018-03-02 07:14:34 +00:00
# LDAP authentication (optional)
# LDAP_ENABLED=true
# LDAP_HOST=localhost
# LDAP_PORT=389
# LDAP_METHOD=simple_tls
# LDAP_BASE=
# LDAP_BIND_DN=
# LDAP_PASSWORD=
# LDAP_UID=cn
2018-08-15 16:12:44 +00:00
# LDAP_SEARCH_FILTER="%{uid}=%{email}"
2018-03-02 07:14:34 +00:00
2018-02-04 14:05:53 +00:00
# PAM authentication (optional)
2018-02-22 22:41:21 +00:00
# PAM authentication uses for the email generation the "email" pam variable
# and optional as fallback PAM_DEFAULT_SUFFIX
# The pam environment variable "email" is provided by:
# https://github.com/devkral/pam_email_extractor
2018-02-04 14:05:53 +00:00
# PAM_ENABLED=true
2018-03-19 19:09:26 +00:00
# Fallback email domain for email address generation (LOCAL_DOMAIN by default)
# PAM_EMAIL_DOMAIN=example.com
2018-02-04 14:05:53 +00:00
# Name of the pam service (pam "auth" section is evaluated)
# PAM_DEFAULT_SERVICE=rpam
2018-03-02 18:02:50 +00:00
# Name of the pam service used for checking if an user can register (pam "account" section is evaluated) (nil (disabled) by default)
2018-02-04 14:05:53 +00:00
# PAM_CONTROLLED_SERVICE=rpam
2018-02-23 00:16:17 +00:00
# Global OAuth settings (optional) :
# If you have only one strategy, you may want to enable this
# OAUTH_REDIRECT_AT_SIGN_IN=true
2018-02-04 04:42:13 +00:00
# Optional CAS authentication (cf. omniauth-cas) :
# CAS_ENABLED=true
# CAS_URL=https://sso.myserver.com/
# CAS_HOST=sso.myserver.com/
# CAS_PORT=443
# CAS_SSL=true
# CAS_VALIDATE_URL=
# CAS_CALLBACK_URL=
# CAS_LOGOUT_URL=
# CAS_LOGIN_URL=
# CAS_UID_FIELD='user'
# CAS_CA_PATH=
# CAS_DISABLE_SSL_VERIFICATION=false
# CAS_UID_KEY='user'
# CAS_NAME_KEY='name'
# CAS_EMAIL_KEY='email'
# CAS_NICKNAME_KEY='nickname'
# CAS_FIRST_NAME_KEY='firstname'
# CAS_LAST_NAME_KEY='lastname'
# CAS_LOCATION_KEY='location'
# CAS_IMAGE_KEY='image'
# CAS_PHONE_KEY='phone'
# Optional SAML authentication (cf. omniauth-saml)
# SAML_ENABLED=true
# SAML_ACS_URL=
2018-02-25 23:24:55 +00:00
# SAML_ISSUER=http://localhost:3000/auth/auth/saml/callback
2018-02-04 04:42:13 +00:00
# SAML_IDP_SSO_TARGET_URL=https://idp.testshib.org/idp/profile/SAML2/Redirect/SSO
# SAML_IDP_CERT=
# SAML_IDP_CERT_FINGERPRINT=
# SAML_NAME_IDENTIFIER_FORMAT=
# SAML_CERT=
# SAML_PRIVATE_KEY=
# SAML_SECURITY_WANT_ASSERTION_SIGNED=true
# SAML_SECURITY_WANT_ASSERTION_ENCRYPTED=true
2018-02-22 22:31:25 +00:00
# SAML_SECURITY_ASSUME_EMAIL_IS_VERIFIED=true
2018-02-04 04:42:13 +00:00
# SAML_ATTRIBUTES_STATEMENTS_UID="urn:oid:0.9.2342.19200300.100.1.1"
# SAML_ATTRIBUTES_STATEMENTS_EMAIL="urn:oid:1.3.6.1.4.1.5923.1.1.1.6"
2018-03-07 05:19:10 +00:00
# SAML_ATTRIBUTES_STATEMENTS_FULL_NAME="urn:oid:2.16.840.1.113730.3.1.241"
# SAML_ATTRIBUTES_STATEMENTS_FIRST_NAME="urn:oid:2.5.4.42"
# SAML_ATTRIBUTES_STATEMENTS_LAST_NAME="urn:oid:2.5.4.4"
2018-02-04 04:42:13 +00:00
# SAML_UID_ATTRIBUTE="urn:oid:0.9.2342.19200300.100.1.1"
2018-02-22 22:31:25 +00:00
# SAML_ATTRIBUTES_STATEMENTS_VERIFIED=
# SAML_ATTRIBUTES_STATEMENTS_VERIFIED_EMAIL=
2018-04-25 00:14:49 +00:00
# Use HTTP proxy for outgoing request (optional)
# http_proxy=http://gateway.local:8118
# Access control for hidden service.
# ALLOW_ACCESS_TO_HIDDEN_SERVICE=true