Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Adding an on-premises file system (legacy)

Updated on April 6, 2022

Add a file system repository instance to use a local file system storage in your application.

Before you begin:
Pega Cloud Services environments and Cloud deployments do not support adding local file system repositories. You should only use local file system repositories with a shared or network storage, or for development-time experimentation.

The best practice for client applications running in Pega Cloud Services environments is to use a default S3 repository that is preconfigured and optimized for Pega Cloud environments. This repository appears as pegacloudfilestorage in your list of repositories in RecordsSysAdminRepository in Dev Studio. For details, see Pega Cloud Services File Storage.

  • To create a repository, your access group must have the PegaRULES:RepositoryAdministrator role. To use a repository, your access group must have the PegaRULES:RepositoryUser role.
  1. In the header of Dev Studio, click CreateSysAdminRepository.
  2. Enter a short description of the repository and the repository name and click Create and open.
  3. In the Definition tab, click Select and select the repository type.
  4. In the Resource path field, enter the path under which artifacts are stored on a file system.
    Note: Each node's operating system must detect the resource path in order to import and export artifacts.
  5. Click Test connectivity to verify whether your credentials are valid.
  6. Click Validate repository to test the connection to the Repository APIs and review the results in the Test Repository Connectivity window. The results include the total time to complete the test, the Repository APIs tested, and the status of the connection.
  7. Click Save.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us