System Settings

This screen allows you to change some technical configuration settings in Rock. For the most part you should never need to worry about these settings, but we've provided this page to help you change them if needed.

Warning

Changing these settings will cause Rock to restart. This means that all sites will be unavailable for a few minutes during the restart. Use caution when changing these settings.

General Configuration

  1. Enable Multiple Time Zone Support - Out of the box Rock assumes that all campuses are in the same time zone. There's typically not a big impact when they’re different, except for check-in. Enable this option to ensure check-in works as expected across different time zones.
  2. Always Show Businesses in Person Picker - If this is enabled then businesses will appear in the search results when you're using any Person Picker in Rock. That means if you search for 'Decker' you'll see Ted and his family, but you'll also see the 'Decker & Sons Plumbing' business returned.
  3. PDF External Render Endpoint - If you're running Web Services on Azure, or if you're running Rock in an environment that does not support running Puppeteer/Chrome on the server, you'll need a third-party service to handle PDF generation. This is where you'll specify the endpoint for this service.
  4. Enable Keep Alive - Enable this setting to have Rock poll itself to keep it "alive" during times of inactivity. This setting is not needed if your AppPool's Idle Time-out is set to 0 (Highly Recommended).
  5. Visitor Cookie Persistence Length - The number of days a visitor cookie persists. This is used by features like Personalization.
  6. Personalization Segment Cookie Affinity Duration - Controls how long the ROCK_SEGMENT_FILTERS cookie can be retained before it must be refreshed from the database. This only impacts Personalization features.
  7. Real-time Hostname - Overrides the default hostname used to connect to Rock’s real-time engine. Useful when routing through a proxy or CDN to ensure correct connections.
  8. Countries Restricted from Accessing - Block users attempting to access your site from the selected countries. For more info see IP Address Geocoding.

  1. Race Label - Some blocks, like Family Pre-Registration give you the option of collecting race and ethnicity information for a person (off by default). Here you can change the name of "race" to something else.
  2. Ethnicity Label - This is the same as the above setting but applies to ethnicity.
  3. Captcha Site Key - If you're using Captcha, this is where you'll put the Site Key from Cloudflare. See the Rock Captcha chapter for details.
  4. Captcha Secret Key - This is the same as the above setting, but applies to theSecret Key.
  5. SMS Opt-In Message - The message you put here will be seen on certain blocks (e.g.,Family Pre-Registration) when a person is prompted to provide a mobile phone number if the SMS Opt-in feature is enabled for that block.

Note

Observability
Configuring Observability can be found in the Observability Chapter.  

Experimental Settings

  1. Starting Day of Week - By default, a week in Rock starts on Monday and ends on Sunday. It is possible, but not necessarily advised, to choose a day other than Monday to start the week. As noted on the page, this will impact things like SundayDate calculations.
  2. Security Grant Token Duration - This is simply the default length of time for which a security grant token is valid. Note that this is not the same as the Person Token Expire Minutes Global Attribute, which gets used with the PersonTokenCreateLava filter.
  3. Revoke Grants - With the click of a single button you can revoke all security grant tokens that have been issued.

Web.Config Settings

  1. Time Zone - When you were installing Rock you should have set your time zone. If you need to change it, you can do that here.
  2. Enable Run Jobs In IIS Context - By default, Rock’s job engine runs on the webserver. This setting allows you to disable this in order to run jobs as a Windows Agent. See the Jobs chapter for more information on this topic.
  3. Max Upload File Size - For security reasons, webservers limit the maximum file size that can be uploaded. This helps to limit the impact of denial of service attacks. Rock has set the default value to 100 MB. If you need more, you can update the size here.
  4. Login Cookie Persistence Length - Use this setting to override the authentication cookie length. The value you set will become the default for things like the REST API. This will impact how frequently a person needs to authenticate, so try to strike a balance between convenience and security.
  5. Enable Database Performance Counters - This setting should remain disabled unless you're actively troubleshooting a system performance issue. When enabled, and after the system restarts, Rock will start collecting data about the usage of your database "connection pool". Rock ships with a set of Metrics you can use to see the results of this data collection. These metrics can be accessed in Rock under Tools > Metrics | Hosting Metrics and will provide the information described below:
    1. Number Of Active Connections - The number of active connections that are currently in use. This number will naturally jump up and down during the day.
    2. Number Of Free Connections - The number of open connections available for use. This number will decrease as the number of active connections increases.
    3. Hard Connects Per Second - This is a count of how many connections are being opened explicitly each second. You might expect this number to rise when first starting Rock or when there aren’t enough available connections in the connection pool.
    4. Soft Connects Per Second - The number of connections being obtained from the connection pool per second. Note, it's possible for this number to be larger than the number of connections in your pool because most connections are used for only fractions of a second.
  6. Azure SignalR Endpoint - Once you’re signed up with Azure you'll add your SignalR Endpoint here. This is used by Rock's Real-Time Engine.7Azure SignalR AccessKeyThis is the same as the above setting, but for the AccessKey.8Observability Service NameIf you have Observability enabled, this is where you'll put the service name.Family Rules

  1. Bible Strict Spouse - This feature enables churches to configure Rock by allowing or disallowing the entry of spouses with the same gender.