Contact Us
Try BuildPiper
Contact Us
Try BuildPiper
Contact Us
Try BuildPiper

System Setting

/* Buttons */ /* Paragraph */ /* HERO */ /* BOX CONTAINER */ /* BOX */ /* NO STYLE BOX (3rd box fix) */ /* TABLET */ /* MOBILE */ /* optional: hide empty box on mobile */

Overview

System Settings (shown as System Properties in the UI) is the platform-wide configuration page of BuildPiper. It gives central control over the platform-level settings that manage security, integrations and operational behavior. Organizations use it to standardize workflows, enforce policies, and run pipelines securely and efficiently across environments.

The page holds 118 settings in 21 categories. They cover sign-in and SSO, build and deploy behavior, integrations, security, notifications and worker scaling.

Important: A change in System Settings affects every application and every user. Only administrators should edit it.

1. Open System Settings

1

Open the System Settings page: https://app.buildpiper.io/system-settings

2

Select a category in the left panel, or type part of a setting name in Search.

3

Click a setting in the Configurations table to open it.

2. The Page

System Settings Overview: original figure 1
Figure 1: System Settings, Build System & CI Configuration category

3. Categories

The settings are described in the following documents.

Category Settings Document
Authentication & Identity Management 14 Authentication
Audit 2 Security, Audit and Network
Security & Compliance 6 Security, Audit and Network
Network and Connectivity 5 Security, Audit and Network
Build System & CI Configuration 16 Build and CI
Deployment & CD Configuration 21 Deployment and Platform
BP Versioning Management 3 Deployment and Platform
Database 1 Deployment and Platform
Application Level Settings 2 Deployment and Platform
Service Level Settings 2 Deployment and Platform
Integration & External Systems 13 Integrations and Feature Flags
Feature Flags & Compatibility 9 Integrations and Feature Flags
BP Maturity Insights 1 Integrations and Feature Flags
AI Configurations 3 Integrations and Feature Flags
Webhook 1 Integrations and Feature Flags
Notifications & Alerts 5 Notifications, Pipelines and Workers
Pipeline Execution & Workflow Control 5 Notifications, Pipelines and Workers
Streaming Configuration 3 Notifications, Pipelines and Workers
Task Queue & Routing 1 Notifications, Pipelines and Workers
Time & Timezone 1 Notifications, Pipelines and Workers
Worker & Queue Monitoring 4 Notifications, Pipelines and Workers

These documents list every field and what it does. They do not record current values, because some fields (OAuth secrets, SMTP and LDAP passwords, API keys) hold credentials.

4. Field Types

Most dropdowns in System Settings are a true / false switch. The others offer a fixed set of options, for example Pod Terminal Policy (Allow or Block), System Timezone (a list of time zones) and SAML Force Protocol (http or https). Their options are described with those settings.

To confirm: Check which Custom Tag Pattern field holds the tag-variable dropdown, and whether list fields such as LLM Provider, BP Versioning Approval Kind List and Change Detection List are dropdowns or free text.

5. Change a Setting

1

Open System Settings, and select the category. You can also type part of the name in Search.

2

Click the setting to open its detail panel. Hover over the information icon of each field to read what the field does.

3

Note the current values before you edit, so that you can restore them.

4

Edit the fields. Fields marked * are required.

5

Save with Apply Immediately (applies the change now) or Apply Async (queues the change to be applied in the background).

6

Check the affected area. For example, after you change SMTP, send a test notification. After you change an SSO provider, try to sign in from a private window, and keep your current session open.
Important: After you apply changes in System Settings, log out and log back in, so that the updates synchronize and take effect.
Note: The UI gives no tooltip for the two Apply buttons. The descriptions above come from their labels. Confirm the exact difference with your BuildPiper administrator.

6. Settings Named in the Product Documentation

The BuildPiper product documentation also describes the following settings. They were not in the list of settings that was captured for these documents, so their fields are not described here.

Setting Purpose
DB Clean-up When it is on, cleans data from the database at a set frequency, to prevent storage bloat.
Log Clean-up When it is on, cleans logs from the host machine at a fixed interval, for efficient disk use.
Docker Image Cleanup Removes intermediate Docker images from the host machine after builds, to free disk space.
CloudWatch Information Sets the CloudWatch details, to push custom metrics from BuildPiper into AWS CloudWatch for observability.

The product documentation also has pages for these topics.

Topic Page
Login and SSO providers https://docs.buildpiper.io/docs/bp-login-and-sso/#sso-providers
Build details (CI) https://docs.buildpiper.io/docs/configuration-of-build-details/
Deploy details (CD) https://docs.buildpiper.io/docs/configuring-the-deploy-details/

 

Overview

System Settings (shown as System Properties in the UI) is the platform-wide configuration page of BuildPiper. It gives central control over the platform-level settings that manage security, integrations and operational behavior. Organizations use it to standardize workflows, enforce policies, and run pipelines securely and efficiently across environments.
The page holds 118 settings in 21 categories. They cover sign-in and SSO, build and deploy behavior, integrations, security, notifications and worker scaling.
Important: A change in System Settings affects every application and every user. Only administrators should edit it.

1. Open System Settings

1
Open the System Settings page: https://app.buildpiper.io/system-settings
2
Select a category in the left panel, or type part of a setting name in Search.
3
Click a setting in the Configurations table to open it.

2. The Page

System Settings Overview: original figure 1
Figure 1: System Settings, Build System & CI Configuration category

3. Categories

The settings are described in the following documents.
Category Settings Document
Authentication & Identity Management 14 Authentication
Audit 2 Security, Audit and Network
Security & Compliance 6 Security, Audit and Network
Network and Connectivity 5 Security, Audit and Network
Build System & CI Configuration 16 Build and CI
Deployment & CD Configuration 21 Deployment and Platform
BP Versioning Management 3 Deployment and Platform
Database 1 Deployment and Platform
Application Level Settings 2 Deployment and Platform
Service Level Settings 2 Deployment and Platform
Integration & External Systems 13 Integrations and Feature Flags
Feature Flags & Compatibility 9 Integrations and Feature Flags
BP Maturity Insights 1 Integrations and Feature Flags
AI Configurations 3 Integrations and Feature Flags
Webhook 1 Integrations and Feature Flags
Notifications & Alerts 5 Notifications, Pipelines and Workers
Pipeline Execution & Workflow Control 5 Notifications, Pipelines and Workers
Streaming Configuration 3 Notifications, Pipelines and Workers
Task Queue & Routing 1 Notifications, Pipelines and Workers
Time & Timezone 1 Notifications, Pipelines and Workers
Worker & Queue Monitoring 4 Notifications, Pipelines and Workers
These documents list every field and what it does. They do not record current values, because some fields (OAuth secrets, SMTP and LDAP passwords, API keys) hold credentials.

4. Field Types

Most dropdowns in System Settings are a true / false switch. The others offer a fixed set of options, for example Pod Terminal Policy (Allow or Block), System Timezone (a list of time zones) and SAML Force Protocol (http or https). Their options are described with those settings. To confirm: Check which Custom Tag Pattern field holds the tag-variable dropdown, and whether list fields such as LLM Provider, BP Versioning Approval Kind List and Change Detection List are dropdowns or free text.

5. Change a Setting

1
Open System Settings, and select the category. You can also type part of the name in Search.
2
Click the setting to open its detail panel. Hover over the information icon of each field to read what the field does.
3
Note the current values before you edit, so that you can restore them.
4
Edit the fields. Fields marked * are required.
5
Save with Apply Immediately (applies the change now) or Apply Async (queues the change to be applied in the background).
6
Check the affected area. For example, after you change SMTP, send a test notification. After you change an SSO provider, try to sign in from a private window, and keep your current session open.
Important: After you apply changes in System Settings, log out and log back in, so that the updates synchronize and take effect.
Note: The UI gives no tooltip for the two Apply buttons. The descriptions above come from their labels. Confirm the exact difference with your BuildPiper administrator.

6. Settings Named in the Product Documentation

The BuildPiper product documentation also describes the following settings. They were not in the list of settings that was captured for these documents, so their fields are not described here.
Setting Purpose
DB Clean-up When it is on, cleans data from the database at a set frequency, to prevent storage bloat.
Log Clean-up When it is on, cleans logs from the host machine at a fixed interval, for efficient disk use.
Docker Image Cleanup Removes intermediate Docker images from the host machine after builds, to free disk space.
CloudWatch Information Sets the CloudWatch details, to push custom metrics from BuildPiper into AWS CloudWatch for observability.
The product documentation also has pages for these topics.
Topic Page
Login and SSO providers https://docs.buildpiper.io/docs/bp-login-and-sso/#sso-providers
Build details (CI) https://docs.buildpiper.io/docs/configuration-of-build-details/
Deploy details (CD) https://docs.buildpiper.io/docs/configuring-the-deploy-details/
 
AuthenticationThe Authentication & Identity Management category contains settings that control how users authenticate and access BuildPiper. These include Single Sign-On (SSO) providers, Active…Security, Audit and NetworkThis document covers three System Settings categories in BuildPiper: Audit (2 settings), Security & Compliance (6 settings), and Network and Connectivity (5 settings).…Build and CIThe Build System & CI Configuration category sets how BuildPiper builds, tags and scans artifacts, and the limits on builds. It has 16…Deployment and PlatformThis document covers five categories: Deployment & CD Configuration (21 settings), BP Versioning Management (3), Database (1), Application Level Settings (2) and Service…Integrations and Feature FlagsThis document covers five categories: Integration & External Systems (13 settings), Feature Flags & Compatibility (9), BP Maturity Insights (1), AI Configurations (3)…Notifications, Pipelines and WorkersThis document covers six categories: Notifications & Alerts (5 settings), Pipeline Execution & Workflow Control (5), Streaming Configuration (3), Task Queue & Routing…