Sep 10, 2025 · Sep 3, 2025 · Sep 3, 2025 · Sep 3, 2025 · Sep 3, 2025 · Sep 4, 2025
diff --git a/_data/argohub-nav.yml b/_data/argohub-nav.yml
    - title: Install GitOps Runtime with existing Argo CD
      url: "/runtime-install-with-existing-argo-cd"
    - title: Install GitOps Runtime with new Argo CD
      url: "/runtime-install-with-new-argo-cd"
      url: "/runtime-install-with-new-argo-cd"
    - title: Install GitOps Runtime in namespace scope
      url: "/runtime-install-namespace-scope"
    - title: Configure GitOps Runtime
      url: "/runtime-configuration"
    - title: Troubleshoot installation
diff --git a/_data/nav.yml b/_data/nav.yml
      url: "/promotion-policy"
    - title: Promotion Workflows
      url: "/promotion-workflow"
    - title: Promotion hooks
      url: "/promotion-hooks"
    - title: Service accounts for Promotion Workflows
      url: "/service-accounts-promotion-workflows"
    - title: Promotion contexts in promotion hooks
          url: "/runtime-install-with-existing-argo-cd"
        - title: Install GitOps Runtime with new Argo CD
          url: "/runtime-install-with-new-argo-cd"
        - title: Install GitOps Runtime in namespace scope
          url: "/runtime-install-namespace-scope"
        - title: Troubleshoot installation
          url: "/runtime-troubleshooting"
        - title: On-premises GitOps Runtime
diff --git a/_docs/administration/user-self-management/manage-pats.md b/_docs/administration/user-self-management/manage-pats.md
 1. Define the following:
  * Token name
  * Expiration date
  * Select scope: `repo`
  * Select scopes:
      * `repo`
      * `admin:repo_hook`

  {%
  include
diff --git a/_docs/gitops-integrations/ci-argument-reference.md b/_docs/gitops-integrations/ci-argument-reference.md
 sub_group: ci-integrations
 toc: true
 ---
 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 ## CI integrations: Complete argument reference
 The table describes _all_ the arguments required for CI integrations in general. The actual arguments required, differs according to the specific CI integration tool.
diff --git a/_docs/gitops-integrations/ci-integrations.md b/_docs/gitops-integrations/ci-integrations.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 ## Codefresh GitOps with CI solutions

 With Codefresh GitOps, you can integrate not only with Codefresh CI but also with other popular Continuous Integration (CI) solutions.
diff --git a/_docs/gitops-integrations/ci-integrations/codefresh-classic.md b/_docs/gitops-integrations/ci-integrations/codefresh-classic.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 If Codefresh Pipelines is your CI tool, you can integrate it with GitOps for streamlined deployment, image enrichment, and reporting. This integration allows you to leverage Codefresh Pipelines for CI tasks—such as building, testing, and scanning code—while using GitOps for managing deployments and tracking enriched image metadata.

diff --git a/_docs/gitops-integrations/ci-integrations/github-actions.md b/_docs/gitops-integrations/ci-integrations/github-actions.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 If GitHub Actions is your CI tool, you can integrate it with GitOps for streamlined deployment, image enrichment, and reporting. This integration allows you to leverage GitHub Actions for CI tasks—such as building, testing, and scanning code—while using GitOps for managing deployments and tracking enriched image metadata.

 Connecting a GitHub Action, adds the CI information to images which are displayed in the Images dashboard, as in the example below.
diff --git a/_docs/gitops-integrations/ci-integrations/jenkins.md b/_docs/gitops-integrations/ci-integrations/jenkins.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 If Jenkins is your CI tool, you can integrate it with GitOps for streamlined deployment, image enrichment, and reporting. This integration allows you to leverage Jenkins for CI tasks—such as building, testing, and scanning code—while using GitOps for managing deployments and tracking enriched image metadata.

diff --git a/_docs/gitops-integrations/container-registries.md b/_docs/gitops-integrations/container-registries.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh supports integration with popular container registries, including Docker Hub, JFrog Artifactory, and others, enabling seamless management of container images in GitOps workflows.

 By adding a container registry integration in Codefresh, you can reference it by name in third-party CI tools like GitHub Actions or Codefresh Pipelines, rather than using explicit credentials. This simplifies your workflow and enhances security.
diff --git a/_docs/gitops-integrations/container-registries/amazon-ecr.md b/_docs/gitops-integrations/container-registries/amazon-ecr.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh offers native support for interacting with Amazon ECR (Elastic Container Registry), enabling you to push, pull, and deploy container images seamlessly.
 For general information on container registry integrations for GitOps, see [Container registry GitOps integrations]({{site.baseurl}}/docs/gitops-integrations/container-registries/).

diff --git a/_docs/gitops-integrations/container-registries/dockerhub.md b/_docs/gitops-integrations/container-registries/dockerhub.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh has native support for interacting with Docker Hub registries, to push, pull, and deploy images.

 For general information on container registry integrations for GitOps, see [Container registry GitOps integrations]({{site.baseurl}}/docs/gitops-integrations/container-registries/).
diff --git a/_docs/gitops-integrations/container-registries/github-cr.md b/_docs/gitops-integrations/container-registries/github-cr.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh offers native support for interacting with GitHub Container Registry, allowing you to host and manage Docker container images within your personal or organization account on GitHub, to push, pull, and deploy images seamlessly.

diff --git a/_docs/gitops-integrations/container-registries/jfrog.md b/_docs/gitops-integrations/container-registries/jfrog.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh offers native support for integrating with JFrog Artifactory, enabling you to host, manage, and deploy Docker container images.
 <!--- With JFrog Artifactory, you can take advantage of fine-grained access control and support for multiple repository types, including Docker registries. This flexibility allows you to manage your images while enforcing strict security and permission policies, all within your GitOps process. -->
 For general information on container registry integrations for GitOps, see [Container registry GitOps integrations]({{site.baseurl}}/docs/gitops-integrations/container-registries/).
diff --git a/_docs/gitops-integrations/container-registries/quay.md b/_docs/gitops-integrations/container-registries/quay.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh offers native support for integrating with Quay, enabling seamless pushing, pulling, and deploying of container images.

 By adding a Quay integration in Codefresh, you can reference the integration account in external CI tools, such as GitHub Actions, using the integration name instead of managing explicit credentials. This simplifies security and enhances the ease of managing integrations in GitOps.
diff --git a/_docs/gitops-integrations/image-enrichment-overview.md b/_docs/gitops-integrations/image-enrichment-overview.md
 toc: true
 ---



 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Image enrichment enhances visibility into deployments by associating metadata—such as feature requests, pull requests, and logs—with container images. This metadata helps teams track changes, investigate failures, and improve traceability across the CI/CD process.

 With Codefresh GitOps, you can enrich and report images to the Codefresh platform, even if you're using third-party CI tools. This allows you to maintain existing workflows while gaining full deployment insights in Codefresh.

 >**NOTE**
 To enable image enrichment, please contact Support.

 ## Report image templates
 Codefresh provides **report image templates** optimized for third-party CI tools, enabling seamless integration with your workflows. By connecting external tools—such as Jira, Docker Hub, and Quay—you can enrich and report images with minimal disruption to existing CI/CD processes.





 ## How image enrichment works

 Integrate Codefresh with your CI platform/tool account with a unique name per integration account.
diff --git a/_docs/gitops-integrations/issue-tracking.md b/_docs/gitops-integrations/issue-tracking.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 A key feature of Codefresh GitOps is the ability to automatically correlate software features with their deployments—identifying not just the software version, but also which features are included in each release.

 By adding an issue-tracking integration for GitOps, you can link issues (such as user stories, bugs, and feature requests) directly to your deployments. This allows you to track which features are deployed and when, providing better visibility and traceability in your images.
diff --git a/_docs/gitops-integrations/issue-tracking/jira.md b/_docs/gitops-integrations/issue-tracking/jira.md
 toc: true
 ---

 {% if page.collection == site.gitops_collection %}
 >**Early Access**
 This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
 {% endif %}

 Codefresh offers native integration with Atlassian Jira, enabling you to enrich images with Jira ticket information. This integration allows you to track a feature from its creation in Jira through to its implementation and deployment across environments, providing visibility into the full lifecycle.

diff --git a/_docs/gitops-quick-start/dependency-multi-env-promotion.md b/_docs/gitops-quick-start/dependency-multi-env-promotion.md
  - /docs/promotions/promotion-scenarios/dependency-multi-env-promotion/
 ---

 >**Promotions is currently in development**
 This feature is still under active development and we've identified some issues with its resilience and reliability, particularly with recovery from cluster and network problems. We are currently upgrading our architecture to resolve these known issues and add self-healing capabilities.
 We don't recommend using Promotions for mission-critical or production deployments at this time.

 ## Advanced Promotion Flow with environment dependencies quick start

diff --git a/_docs/gitops-quick-start/drag-and-drop.md b/_docs/gitops-quick-start/drag-and-drop.md
  - /docs/promotions/promotion-scenarios/drag-and-drop/
 ---

 >**Promotions is currently in development**
 This feature is still under active development and we've identified some issues with its resilience and reliability, particularly with recovery from cluster and network problems. We are currently upgrading our architecture to resolve these known issues and add self-healing capabilities.
 We don't recommend using Promotions for mission-critical or production deployments at this time.


 ## Simple drag-and-drop promotion quick start
 In this first quick start on promotions, we'll see how to promote products using the intuitive drag-and-drop functionality in the Environments dashboard.

diff --git a/_docs/gitops-quick-start/quick-start-promotion-workflow.md b/_docs/gitops-quick-start/quick-start-promotion-workflow.md
 toc: true
 ---

 >**Promotions is currently in development**
 This feature is still under active development and we've identified some issues with its resilience and reliability, particularly with recovery from cluster and network problems. We are currently upgrading our architecture to resolve these known issues and add self-healing capabilities.
 We don't recommend using Promotions for mission-critical or production deployments at this time.

 ## Promotion Workflows quick start
 This quick start will guide you through creating a Promotion Workflow in Codefresh.

diff --git a/_docs/installation/gitops/manage-runtimes.md b/_docs/installation/gitops/manage-runtimes.md
 Refer to our [troubleshooting section]({{site.baseurl}}/docs/kb/articles/runtime-issues/#unable-to-communicate-with-runtime-name-or-two-or-more-runtimes) for a list of possible causes and the corresponding corrective actions.
 {% endif %}

 ## View notifications in Activity Log

 The Activity Log is a quick way to monitor notifications for Runtime events such as upgrades. A pull-down panel in the Codefresh toolbar, the Activity Log shows ongoing, success, and error notifications, sorted by date, starting with today's date.

 1. In the Codefresh UI, on the top-right of the toolbar, select  **Activity Log**.
 1. To see notifications for provisioned Runtimes, filter by **Runtime**.


  <!--- ask dev for help -->
  {% include image.html
  lightbox="true"
  file="/images/runtime/runtime-activity-log.png"
  url="/images/runtime/runtime-activity-log.png"
  alt="Activity Log filtered by Runtime events"
  caption="Activity Log filtered by Runtime events"
  max-width="30%"
  %}

 {:start="3"}

 1. To see more information on an error, select the **+** sign.



 ## Related articles
 [Monitoring GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/monitor-runtimes/)
 [Managing Git Sources in GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/git-sources/)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -72,7 +72,9 @@
		- title: Install GitOps Runtime with existing Argo CD
		url: "/runtime-install-with-existing-argo-cd"
		- title: Install GitOps Runtime with new Argo CD
		url: "/runtime-install-with-new-argo-cd"
		url: "/runtime-install-with-new-argo-cd"
		- title: Install GitOps Runtime in namespace scope
		url: "/runtime-install-namespace-scope"
		- title: Configure GitOps Runtime
		url: "/runtime-configuration"
		- title: Troubleshoot installation
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -439,8 +439,6 @@
		url: "/promotion-policy"
		- title: Promotion Workflows
		url: "/promotion-workflow"
		- title: Promotion hooks
		url: "/promotion-hooks"
		- title: Service accounts for Promotion Workflows
		url: "/service-accounts-promotion-workflows"
		- title: Promotion contexts in promotion hooks
Expand DownExpand Up		@@ -621,6 +619,8 @@
		url: "/runtime-install-with-existing-argo-cd"
		- title: Install GitOps Runtime with new Argo CD
		url: "/runtime-install-with-new-argo-cd"
		- title: Install GitOps Runtime in namespace scope
		url: "/runtime-install-namespace-scope"
		- title: Troubleshoot installation
		url: "/runtime-troubleshooting"
		- title: On-premises GitOps Runtime
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -154,7 +154,9 @@ max-width="70%"
		1. Define the following:
		* Token name
		* Expiration date
		* Select scope: `repo`
		* Select scopes:
		* `repo`
		* `admin:repo_hook`

		{%
		include
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -5,6 +5,10 @@ group: gitops-integrations
		sub_group: ci-integrations
		toc: true
		---
		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		## CI integrations: Complete argument reference
		The table describes _all_ the arguments required for CI integrations in general. The actual arguments required, differs according to the specific CI integration tool.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -5,6 +5,11 @@ group: gitops-integrations
		toc: true
		---

		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		## Codefresh GitOps with CI solutions

		With Codefresh GitOps, you can integrate not only with Codefresh CI but also with other popular Continuous Integration (CI) solutions.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,11 @@ sub_group: ci-integrations
		toc: true
		---

		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		If GitHub Actions is your CI tool, you can integrate it with GitOps for streamlined deployment, image enrichment, and reporting. This integration allows you to leverage GitHub Actions for CI tasks—such as building, testing, and scanning code—while using GitOps for managing deployments and tracking enriched image metadata.

		Connecting a GitHub Action, adds the CI information to images which are displayed in the Images dashboard, as in the example below.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,10 @@ sub_group: ci-integrations
		toc: true
		---

		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		If Jenkins is your CI tool, you can integrate it with GitOps for streamlined deployment, image enrichment, and reporting. This integration allows you to leverage Jenkins for CI tasks—such as building, testing, and scanning code—while using GitOps for managing deployments and tracking enriched image metadata.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,11 @@ sub_group: container-registries
		toc: true
		---

		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		Codefresh offers native support for interacting with Amazon ECR (Elastic Container Registry), enabling you to push, pull, and deploy container images seamlessly.
		For general information on container registry integrations for GitOps, see [Container registry GitOps integrations]({{site.baseurl}}/docs/gitops-integrations/container-registries/).

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,10 @@ sub_group: container-registries
		toc: true
		---

		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		Codefresh offers native support for interacting with GitHub Container Registry, allowing you to host and manage Docker container images within your personal or organization account on GitHub, to push, pull, and deploy images seamlessly.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -7,23 +7,18 @@ redirect_from:
		toc: true
		---



		{% if page.collection == site.gitops_collection %}
		>Early Access
		This feature is available upon request through our Early Access Program. As it is still in development, you may encounter occasional bugs or limitations.
		{% endif %}

		Image enrichment enhances visibility into deployments by associating metadata—such as feature requests, pull requests, and logs—with container images. This metadata helps teams track changes, investigate failures, and improve traceability across the CI/CD process.

		With Codefresh GitOps, you can enrich and report images to the Codefresh platform, even if you're using third-party CI tools. This allows you to maintain existing workflows while gaining full deployment insights in Codefresh.

		>NOTE
		To enable image enrichment, please contact Support.

		## Report image templates
		Codefresh provides report image templates optimized for third-party CI tools, enabling seamless integration with your workflows. By connecting external tools—such as Jira, Docker Hub, and Quay—you can enrich and report images with minimal disruption to existing CI/CD processes.





		## How image enrichment works

		Integrate Codefresh with your CI platform/tool account with a unique name per integration account.
Expand Down