--- schema_version: "1" id: 0e4ef85fbd26f734ee9583e07d00dfb7e36ea38286124c3ddb725463073693cc title: Troubleshoot DevOps Center Configuration collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_troubleshooting_setup.md canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_troubleshooting_setup.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 8c1c026f64a67a65f4b367d609ec2588ef998e7f89122a3101afda904e225be8 description: Here are some tips if you encounter issues when installing or configuring DevOps Center. products: - Salesforce Platform release: "264" --- # Troubleshoot DevOps Center Configuration Here are some tips if you encounter issues when installing or configuring DevOps Center. ## Provide General Feedback If you want to provide general feedback, request product enhancements, start discussions with other DevOps Center users or the product team, and share best practices, use the [DevOps Center Trailblazer group](https://trailhead.salesforce.com/en/trailblazer-community/groups/0F94S000000Guyg). ## Issue: Auto-generated work item numbers aren’t consecutive Sometimes, auto-generated record numbering, including work item numbers, aren’t sequential or consecutive. **Cause:** Record numbers can skip when multiple operations are running concurrently. **Action:** No action required. See Knowledge Article: [Auto numbers that are generated are not sequential all the time](https://help.salesforce.com/s/articleView?id=000383836&type=1&language=en_US) for more information. ## Issue: Can’t add or log in to a sandbox When attempting to add a sandbox as a development or pipeline environment, or to log in to a sandbox, DevOps Center launches `login.salesforce.com` so you can’t log in to it. **Cause:** Often, the cause is that the required auth provider, DevOps Center Test, has been deleted. **Action:** Toggle the DevOps Center Setup option to recreate all DevOps Center auth providers. - In Setup, find and select **DevOps Center**. - Click to disable DevOps Center and then click again to enable it. - In Setup, find and select **Auth. Providers**. - Verify that the list contains DevOps Center auth providers, including `DevOps Center Test`. After you re-add the DevOps Center Test auth provider, you’re directed to the expected login URL, `test.salesforce.com`. ## Issue: DevOps Center doesn’t load When you launch DevOps Center, you see a spinner but the Project page never loads. **Cause:** If you installed the Salesforce Page Optimizer Chrome extension, it’s not compatible with DevOps Center. We plan to fix this issue in a future release. **Action:** Remove or disable the extension. ## Issue: Can’t connect a release environment to a project or perform common operations You see this error, `Error: There was an error. Please reload the page`, when you try to connect a release environment to a project. **Cause:** If you have the API Access Control Setting `For admin-approved users, limit API access to only allowlisted connected apps` enabled, it blocks DevOps Center from interacting with required APIs. The behavior you see depends on if it was enabled before or after you installed and configured DevOps Center. - If this setting was enabled before DevOps Center was installed, you can’t add a release environment to a project. - If this setting is enabled after DevOps Center was installed, you can’t perform common operations, such as commits and promotions. **Action:** Disable the setting. From Setup, in the Quick Find box, enter API Access Control, then select **API Access Control**. ## Issue: DevOps Center doesn’t appear in the App Launcher **Cause:** If you miss some of the post-installation configuration steps, DevOps Center doesn’t appear in the App Launcher. **Action:** Try these troubleshooting steps in order: - Did you create the connected app? Be sure to complete all steps. - If you created the connected app, did you assign the `sf_devops_NamedCredentials` permission set to it? - Does the DevOps Center app Start URL appear in App Manager? - Go to Setup > App Manager. - Find DevOps Center and select **Manage** from the menu. - Click **Edit Policies**. - In the Start URL field, enter `/sf_devops/DevOpsCenter.app`, then click **Save**. ## Error: There was an error. Please reload the page... You see this error when trying to add an environment to the project. **Cause:** If Session Security “Level Required at Login” is set to `High Assurance`, it prevents the use of asynchronous processing. **Action:** Ask a Salesforce admin to turn off high assurance for **Manage Auth. Providers**. - From Setup, enter Identity Verification in the Quick Find box, then select **Identity Verification**. - Under Session Security Level Policies, for Manage Auth. Providers, select **None**. - Click **Save**. ## Issue: You don’t see an existing branch in the dropdown when building your pipeline **Cause:** When using an existing source control repository for the DevOps Center project, you don’t see the branch you want to select in the dropdown when building the pipeline. The Branch Settings dialog dropdown can display a maximum of 500 branches. **Action:** As a workaround, delete any obsolete branches in the source control repository and try again. ## Issue: Logged in to GitHub using the incorrect account When creating or opening a project, all team members log in to GitHub using the account that has access to the repos that your team wants to use with DevOps Center. If someone logs in with the incorrect GitHub account, a team member with Salesforce admin privileges can delete the authorization information so you or the team member can log in using the proper credentials. **Action:** See [Connect to a Different GitHub Account](https://help.salesforce.com/s/articleView?id=platform.devops_center_connect_diff_github_acct.htm&release=264.0.0&type=5 "When creating or opening a project, all team members log in to GitHub using the account that has access to the repos that your team wants to use with DevOps Center. If you or a team member logged in with the incorrect GitHub account, a team member with Salesforce admin privileges can delete the authorization information so you or the team member can log in using the proper credentials.") for instructions. ## Error: Did You Log In to the Correct Environment? **Cause:** DevOps Center acts like you didn’t log into the correct sandbox. In Winter ’24, Salesforce enforced enhanced domains, which changed sandbox My Domain URL formats to conform to new security standards. When you connect a sandbox in DevOps Center, DevOps Center uses a named credential to facilitate authentication. If you set up DevOps Center when enhanced domains weren’t deployed, the named credential requires an update. This issue surfaces when a DevOps Center user tries to perform an action using the sandbox. Actions include opening a connected sandbox, pulling changes from a connected environment, or promoting changes to the environment. **Action:** Users with Salesforce admin privileges or the “Customize Application” user permission can update named credentials. - From Setup, in the Quick Find box, enter Named Credentials in the Quick Find box, then select **Named Credentials**. - Locate the named credential records that correspond to sandboxes used as development environments or in pipeline stages. Look for the environment’s DevOps Center record ID in the Label field. DevOps Center uses this pattern for creating Named Credential records: Release environments: _environmentRecord ID_\__projectName_\__environmentName_\__sequentialNumber_ Other environments: _environmentRecord ID_\__environmentName_\__sequentialNumber_ - From the Actions menu, select **Edit**. - In the URL field, replace your old My Domain login URL with your new My Domain login URL. For example, replace: ``` https://MyDomainName--SandboxName.my.salesforce.com/ ``` with ``` https://MyDomainName--SandboxName.sandbox.my.salesforce.com ``` - Deselect **Start Authentication Flow on Save** and save your changes. ## Issue: DevOps Center Setup page doesn't appear in the org **Cause:** DevOps Center is available in Enterprise, Performance, Professional, Unlimited, and Developer editions, as well as scratch orgs and Trailhead playgrounds. It's not available in sandboxes or other unlisted org editions. **Action:** To evaluate DevOps Center, we suggest using a Developer Edition org or scratch org. Scratch orgs don't live forever, so we suggest indicating a duration of 30 days so you have ample time to try out DevOps Center. ## Error: Package can't be installed because Duplicate Rules and Matching Rules features are missing. ![The package can't be installed. There are problems that prevent this package from being installed. (Missing Organization Feature: Match, Missing Organization Feature: Dedupe)](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center_setup-264-0-0-production-enus/4741b024-a514-4bcf-8f2f-9d308932d2de/devops_center_setup/images/ts-dup-rules.png) **Cause:** DevOps Center is available in Enterprise, Performance, Professional, Unlimited, and Developer editions, as well as scratch orgs and Trailhead playgrounds. It's not available in sandboxes or other unlisted org editions. **Action:** To evaluate DevOps Center, we suggest using a Developer Edition org or scratch org. Scratch orgs don't live forever, so we suggest indicating a duration of 30 days so you have ample time to try out DevOps Center. ## Error: “You don’t have permission to view this data, enter credentials for the named credential in your personal settings. Or ask your Salesforce admin for help.” **Cause:** After the DevOps Center package is upgraded to the current version, a user sees this error when they try to open a project. This error is likely to occur when a user isn't logged into GitHub or doesn't have access to the project’s GitHub repo. **Action:** To work around this issue, click **New Project**, which prompts you to log in to GitHub. ## Error: “​​(DevOps\_Center\_GitHub) In field: authProvider - no AuthProvider named DEVOPS\_CENTER\_GITHUB found DevOps\_Center\_GitHub: In field: authProvider - no AuthProvider named DEVOPS\_CENTER\_GITHUB found” **Cause:** It’s highly likely that you didn't enable DevOps Center in your org. **Action:** Enable DevOps Center and accept the license terms in the DevOps Center Setup page. From Setup, enter DevOps Center in the Quick Find box, then select **DevOps Center**. ## Error: “The request was invalid. Resource protected by organization SAML enforcement.” **Cause:** GitHub repos owned by an organization aren’t visible in DevOps Center until an organization account owner provides access. **Action:** See [If an Organization Owns the GitHub Repo](https://help.salesforce.com/s/articleView?id=platform.devops_center_org_owns_github_repo.htm&release=264.0.0&type=5 "GitHub repos owned by an organization aren’t visible in DevOps Center until an organization account owner provides access.") for instructions on fixing this issue. ## Error: Problem Logging In Due to Login IP Restrictions **Cause:** The org or org user attempting to connect has login IP restrictions. DevOps Center uses named credentials and OAuth to facilitate a trusted connection between itself and the other environments. When you attempt to log in, you see an error popup and a URL format that conveys the existence of IP restrictions. ![Error popup that say: Problem Logging In. We can't log you in because of an authentication error. Contact your Salesforce admin.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center_setup-264-0-0-production-enus/4741b024-a514-4bcf-8f2f-9d308932d2de/devops_center_setup/images/error-setup-login-ip-restrictions.png) In the address bar, you see a URL that ends with something like this: ``` /AuthorizationError?ErrorCode=No_Oauth_Token&ErrorDescription=invalid_grant+ip+restricted ``` **Action:** Here are some options to work around this error: - Create an integration user in the target org, with a profile that doesn't have IP restrictions. - Add Salesforce IPs and DevOps Center service IPs to the list of trusted IPs in the target user's profile. See [Salesforce IP Address and Domains to Allow](https://help.salesforce.com/s/articleView?id=000321501&language=en_US) and [Update IP Allow List for DevOps Center App](https://help.salesforce.com/s/articleView?id=platform.devops_center_ip_allow_list_app.htm&release=264.0.0&type=5 "If your security settings require it, add the necessary domains for all environments that have allowlisting enabled."). - Completely disable IP allow-listing in the target org. ## Error: Commit or Promotion Failed Due to API Version Mismatch **Action:** To resolve this error, update the source API version. For more information, see [Update the Project’s Source API Version Each Salesforce Release](https://help.salesforce.com/s/articleView?id=platform.devops_center_sourceapi_version.htm&language=en_US).