Importing deploy anywhere projects from external Git repositories

Any deploy anywhere projects that are mapped to an external Git repository can be imported into your current workspaces. This option helps you to restore a project that got deleted or import a project that exists in a different environment.

Before you begin

  • You must have the Git repository URL and the necessary credentials to the project repository to be imported.
  • If you are using a Git branch other than main to import the project, update the branch details in your project's scaffolding file. This file is at, <base_directory>/path/config/scaffolding/<projectname>.yaml. To update the scaffolding file, do the steps.
    1. Go to your Git project.
    2. Switch to the desired branch.
    3. Open the relevant scaffolding file.
    4. Make the updates.
    5. Commit the changes.
      Note: No changes are required in the scaffolding file when you work with the main branch.
  • If any third-party packages are used, make sure that all their dependencies are also included. Without the required dependencies, the package is not enabled after import. Therefore, make sure to resolve any third-party package dependencies beforehand.
  • Make sure that none of the existing projects share the name as the repository. If a name conflict exists, the project import process fails.
    Note: You cannot rename a project or repository name as it might lead to errors.
  • Using shared Git accounts, you can import projects, but you cannot save or commit changes unless your personal Git credentials are properly configured. Suppose that you are working on a Bitbucket repository by using a shared account. You can import the project, but to commit changes, you must add your personal Git credentials, for example, username is john.doe, token is bbp_123xyz..., in the Packages tab. Without credentials, commit attempts fail due to authentication errors. This step is crucial to make sure that your commits are properly authenticated, accurately linked to your identity, and successfully pushed to the external Git repository.

    For more information on how to update Git accounts, see Updating packages.

Procedure

  1. Go to Projects and click Import.
  2. In the Import project dialog, enter the Git details:
    Git URL
    The URL of the package repository where the project is available.
    Source account
    The name of the account that is associated with the repository. The Source account option displays all Git accounts available to you. You can add a Git account by clicking Add.
  3. Click Next. If the account does not have access to the repository, then an error message is displayed. Correct the Git details to proceed further.
  4. Select a particular branch or tag of the repository to use as the source for the package in the Git branch/Tag field.
    The project name is automatically displayed as in the repository name.
  5. In Access, select one of the options to define project permissions.
    Only shared members
    Select this option to create a project in private visibility mode.
    Anyone in the environment
    Select this option to create a project in public visibility mode.
    Note: Starting with June 2026 release, a project is created in private mode by default. You can set the project access to public, but a better option is to set the project to private and share it with specific users. Projects created before June 2026 release are public by default.
  6. Choose a color and icon to represent the project on the dashboard.
    These visual identifiers help distinguish projects in both card and list views.
  7. Click Import.

Results

The project is created by using the project details in the Git repository. You can use this project to create and save your integrations and assets.