> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/continuous-integration/3.0/troubleshooting-and-resources/troubleshoot-harness-ci/troubleshooting-ci.md).

# Troubleshoot CI

[Harness AI](/continuous-integration/troubleshooting-and-resources/troubleshoot-harness-ci/ai.md) and [debug mode](/continuous-integration/troubleshooting-and-resources/troubleshoot-harness-ci/debug-mode.md) can help you troubleshoot errors and other issues in Harness CI.

For troubleshooting guidance and questions related to Harness CI, go to the [Continuous Integration FAQs](/continuous-integration/3.0/troubleshooting-and-resources/ci-articles-and-faqs/continuous-integration-faqs.md).

For troubleshooting guidance for the Harness Platform, delegates, connectors, secrets, or other modules go to the [Platform Knowledge Base](https://developer.harness.io/kb/platform) or [Troubleshooting Harness](/continuous-delivery/troubleshooting-and-resources/troubleshooting-nextgen.md).

For additional support, you can [contact Harness Support](mailto:support@harness.io) or visit the [Harness Community](https://developer.harness.io/community).

### Connector connection test failures <a href="#connector-connection-test-failures" id="connector-connection-test-failures"></a>

If your connector connection tests (preflight checks) fail due to network restrictions, split DNS configurations, proxy setups, or restrictive firewall policies, but you know the connector will work at runtime, you can configure Harness to skip the connection validation.

To skip connector preflight checks, you need both:

1. **Account-level feature flag enabled**: Contact [Harness Support](mailto:support@harness.io) to enable the `CI_IGNORE_TEST_CONNECTION` feature flag for your account.
2. **Connector YAML configuration**: Add `ignoreTestConnection: true` to your connector's YAML configuration.

When both the feature flag and YAML property are enabled, connection tests will always return as "Successful" without performing actual connectivity validation.

For more information and example configurations, go to:

* [Create a connector using YAML - Skip connector preflight checks](/harness-ai/use-harness-platform/connectors/create-a-connector-using-yaml.md#optional-skip-connector-preflight-checks)
* [Connect to a Git repository - Connection tests fail due to network restrictions](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md#connection-tests-fail-due-to-network-restrictions)
* [CI FAQ - How can I skip connector preflight checks?](/continuous-integration/3.0/troubleshooting-and-resources/ci-articles-and-faqs/continuous-integration-faqs.md#how-can-i-skip-connector-preflight-checks-when-they-fail-due-to-network-restrictions)

{% hint style="warning" %}
Use this feature carefully. Skipping connection tests means Harness won't validate whether the connector credentials are correct or if the remote service is accessible. Only use this when you're certain the connector will work at runtime despite failing preflight checks.
{% endhint %}