> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.14/onboard-cortex-xsoar/remote-repositories-in-cortex-xsoar/remote-repositories-overview.md). # Remote Repositories Overview In Cortex XSOAR, you can develop and test your content on other machines, before using it in a production environment. You can do this by using one of the following options: * The remote repository feature in the UI. * Use the [CI/CD Process](https://xsoar.pan.dev/docs/reference/packs/content-management) **The Remote Repository Feature in the UI** Cortex XSOAR supports the ability to work with separate repositories for development and production environments. This enables you to develop and test all of your content in one location, and when it is ready, you push the content to the remote repository. On your production environment, you pull the content as you would all other content updates. This feature does not need the resources for the CI/CD process and is designed for less complicated content, usually one or two developers working on a local machine. **Working with the Remote Repository Feature in the UI** In the production environment, the content appears as a content update, just like any other, and you pull the content from the remote repository into your working branch. {% hint style="info" %} ### Note The development and production environments must be running on the same version of Cortex XSOAR. {% endhint %} In addition, Cortex XSOAR content updates are only delivered to the development environment. This enables you to determine which updates you want to push to production. * Working with remote repositories is Git-based. Any service that supports this protocol can be used, for example, GitHub, GitLab, Bitbucket, etc. In addition, on-premise repositories are also supported. * Verify that your Cortex XSOAR has access to the remote repository as this feature cannot be configured to work with Engines. To work with remote repositories, you must have two separate Cortex XSOAR environments on two separate machines. The development environment is used to write the following content: * Automations * Playbooks * Integrations * Classifiers * Mappers * Lists

Note

Lists created in the development environment and pushed to production cannot be edited in the production environment. Lists created in the production environment can be edited in the production environment.

* Content packs

Note

When pushing a content pack to the remote repository, you should push all of its content, listed in the Local Changes window, for the content pack to work properly.

* Incident fields * Indicator fields * Evidence fields * Incident layouts * Incident types * Pre-processing rules

Note

If you have re-ordered your pre-processing rules you must push all of the pre-processing changes to the production tenant.

* Indicator types * Reports * Dashboards * Widgets On the production environment, it is not possible to edit these elements. You need to configure a remote repository both on a [development environment](/xsoar-6-administrator-guide/6.14/onboard-cortex-xsoar/remote-repositories-in-cortex-xsoar/configure-a-remote-repository-on-a-development-machine.md) and a [production environment](/xsoar-6-administrator-guide/6.14/onboard-cortex-xsoar/remote-repositories-in-cortex-xsoar/configure-a-remote-repository-on-the-production-machine.md). After you develop your content, if you want it to be available as part of a content update for the production environment, you must [push](/xsoar-6-administrator-guide/6.14/onboard-cortex-xsoar/remote-repositories-in-cortex-xsoar/edit-and-push-content-to-a-remote-repository.md) the changes to the remote repository. If you experience issues, learn how to [troubleshoot remote repositories](/xsoar-6-administrator-guide/6.14/onboard-cortex-xsoar/remote-repositories-in-cortex-xsoar/troubleshoot-a-remote-repository-configuration.md). {% hint style="info" %} ### Note If after setting up development and production machines, you later decide to revert to a standalone environment, without a remote repository, disable the option for **Private content repository** under Settings → Advanced → **Content Repository**. {% endhint %} **The Remote Repository UI feature and High Availability** The remote repository feature in the UI is not supported on development environments that run as High Availability (multi-app servers). You can still use a development > staging > production setup, where development is a single server (not High availability), but production can be High Availability. In this setup, both staging and production pull from the same Git repository. If your development environment runs as High Availability, use the [CI/CD Solution](https://xsoar.pan.dev/docs/reference/packs/content-management). {% hint style="warning" %} ### Caution Although the remote repository feature is supported in a High Availability production machine, users may experience slowness during content installation, version history viewing, or instability during release notes generation. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.14/onboard-cortex-xsoar/remote-repositories-in-cortex-xsoar/remote-repositories-overview.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.