Configuring Errbit

Following the recommendation of 12factor.net, Errbit takes all of its configuration from environment variables. You can use dotenv, which is included in the Gemfile, to fill in any values that you can’t or won’t supply through the environment.

In order of precedence Errbit uses:

Environment variables (for example MY_VALUE=abc bundle exec unicorn)
Values provided in a .env file
Default values from .env.default

Configuration Parameters

ERRBIT_HOST: Hostname to use when building links back to Errbit; defaults to errbit.example.com
ERRBIT_PROTOCOL: Protocol to use when building links back to Errbit (http or https); defaults to http
ERRBIT_PORT: TCP port to use when building links back to Errbit
ERRBIT_ENFORCE_SSL: When enabled, Errbit forces all traffic over https; defaults to false
ERRBIT_CONFIRM_ERR_ACTIONS: Present confirmation dialogs when users act on errors; defaults to true
ERRBIT_USER_HAS_USERNAME: Allow users to have a username field; defaults to true
ERRBIT_USE_GRAVATAR: Enable gravatar; defaults to true
ERRBIT_GRAVATAR_DEFAULT: Default gravatar image (see https://en.gravatar.com/site/implement/images/); identicon
ERRBIT_EMAIL_FROM: The value that should be set in the ‘from’ field for outgoing emails; defaults to errbit@example.com
ERRBIT_EMAIL_AT_NOTICES: Errbit notifies watchers via email after the set number of occurances of the same error; defaults to [1,10,100]
ERRBIT_PER_APP_EMAIL_AT_NOTICES: Let every application have it’s own configuration rather than using ERRBIT_EMAIL_AT_NOTICES. If this value is true, you can configure each app using the web UI.; defaults to false
ERRBIT_NOTIFY_AT_NOTICES: Notify each application’s configured notification service after the set number of occurances of the same error. [0] means notify on every occurance.; defaults to [0]
ERRBIT_PER_APP_NOTIFY_AT_NOTICES: Let every application have it’s own configuration rather than using ERRBIT_NOTIFY_AT_NOTICES. If this value is set to true, you can configure each app using the web UI.; defaults to false
SERVE_STATIC_ASSETS: Allow Rails to serve static assets. For most production environments, this should be false because your web server should be configured to serve static assets for you. But some environments like Heroku require this to be true.; defaults to true
SECRET_KEY_BASE: For production environments, you should run rake secret to generate a secret, unique key for this parameter; defaults to f258ed69266dc8ad0ca79363c3d2f945c388a9c5920fc9a1ae99a98fbb619f135001c6434849b625884a9405a60cd3d50fc3e3b07ecd38cbed7406a4fccdb59c
MONGO_URL: URL connection string for mongo in the form mongodb://username:password@example.com:port To more easily set up connections to third party mongo providers, you can call this value MONGOLAB_URI, MONGOHQ_URL, MONGODB_URL or MONGO_URL; defaults to mongodb://localhost/errbit_<Rails.env>
GITHUB_URL: Use this URL for interacting github. This is useful if you have a github enterprise account and you’re using a URL other than https://github.com; defaults to https://github.com
GITHUB_API_URL: For github enterprise accounts, the API URL could be something like https://github.example.com/api/v3; defaults to https://api.github.com
GITHUB_AUTHENTICATION: Allow github sign-in via OAuth; defaults to true
GITHUB_CLIENT_ID: Client id of your github application
GITHUB_SECRET: Secret key for your github application
GITHUB_ORG_ID: ID of your github organization. If set, Errbit will create user accounts for users in your github organization who sign into Errbit without having a user account
GITHUB_ACCESS_SCOPE: OAuth scope to request from users when they sign-in through github; defaults to [repo]
GITHUB_SITE_TITLE: The title to use for GitHub. This value is whatever you want displayed in the Errbit UI when referring to GitHub.; defaults to GitHub
EMAIL_DELIVERY_METHOD: :smtp or :sendmail, depending on how you want Errbit to send email
SMTP_SERVER: Server address for outgoing SMTP messages
SMTP_PORT: Server port for outgoing SMTP messages
SMTP_AUTHENTICATION: Authentication method for the SMTP connection (see http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration)
SMTP_USERNAME: Username for SMTP auth, you could also set SENDGRID_USERNAME
SMTP_PASSWORD: Password for SMTP auth, you could also set SENDGRID_PASSWORD
SMTP_DOMAIN: HELO domain to set for outgoing SMTP messages, you can also use SENDGRID_DOMAIN
SENDMAIL_LOCATION: Path to sendmail
SENDMAIL_ARGUMENTS: Custom arguments for sendmail
DEVISE_MODULES: Devise modules to enable; defaults to [database_authenticatable,recoverable,rememberable,trackable,validatable,omniauthable]
USE_UNICORN_WORKER_KILLER: unicorn-worker-killer modules to enable; defaults to false
ERRBIT_LOG_LOCATION: Path to use to store the log. Specify STDOUT for stdout output, Syslog::Logger to send logs to syslog (uses local0 facility).; defaults to STDOUT