Home → Admin Manual → System Administration → .env Configuration Options

4.10. .env Configuration Options

The .env file on self hosted installations controls much of how HelpSpot runs at a global level. The standard settings are setup during installation but there are additional settings that can be configured if needed. All environment variables are entered into the .env file in this format: env_var_name="value"

• SECURITY_FRAME_OPTIONS - Controls the x-frame-options http header.
  • Default: SAMEORIGIN.
  • Values: SAMEORIGIN, DENY, ""
• CUSTOM_CSP - inserts custom CSP domains to be allowed in the admin area.
  
  • Default: null
  • Values: "yoururl.com"
• FORCE_HTTPS - This setting is used when SSL is offloaded to a reverse proxy or load balencer and traffic between the proxy and the HelpSpot server if unencrypted. If SSL is provided by the HelpSpot web server only the APP_URL needs to be changed to reflect the https protocol. In most cases when enabling SSL on a web server the only change needed is to update the APP_URL.
  
  • Default: false
  • Values: true, false
•  DISABLE_CSRF - Disable CSRF protection to certain routes, comma separated list of routes.
  • Default: null
  • example .env setting: DISABLE_CSRF_FOR="https://example.org/my-route,https://example.org/index.php?pg=login"\
• MAIL_CRON_INTERVAL - Set custom timing for how often email mailboxes are checked for mai
  
  • Default: * * * * *
  • Values: Valid CRON format schedule.
• MAINTENANCE_CRON_INTERVAL - Set custom timing when daily db maintenance tasks are run.
  
  • Default: 0 0 * * *
  • Values: Valid CRON format schedule.
• AUTO_COLLECT_MAIL - Enable (default) or Disable mail collection
  
  • Default: true
  • Values: true, false
• SEND_MAIL_DELAY - Add a delay between mail sends to help with services that throttle sends over time
  
  • Default: 1
  • Values: Time in seconds
• SEND_MAIL_BACKOFF - The number of seconds to wait before re-trying an email that failed to send
  
  • Default: 30
  • Values: Time in seconds
• SEND_MAIL_RETRIES - The maximum number of times HelpSpot will attempt to resend an email.
  
  • Default: 5
  • Values: An integer of reties
• MAINTENANCE_MODE - Put HelpSpot into maintenance mode
  
  • Default: false
  • Values: true, false
• SECURITY_CONTENT_TYPE_OPTIONS - Sets the X-Content-Type-Options
  
  • Default: nosniff
  • Values: nosniff or empty