configuration.md 5.35 KB

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:

  1. Environment variables (for example MY_VALUE=abc bundle exec puma)
  2. Values provided in a .env file
  3. 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 MONGODB_URI, 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 GOOGLE_AUTHENTICATION Allow google sign-in via OAuth defaults to true GOOGLE_CLIENT_ID Client id of your google application GOOGLE_SECRET Secret key for your google application GOOGLE_SITE_TITLE The title to use for Google. This value is whatever you want displayed in the Errbit UI when referring to Google. defaults to Google 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]