• FastStore projects hosted in the vtex-sites organization using WebOps that you want to move to the GitHub organization of the account.
• FastStore projects hosted in their own organization on GitHub using WebOps that you want to move to a new organization or repository.

For FastStore projects hosted in the vtex-sites organization and not using WebOps (FastStore v1), open a ticket with VTEX Support to move your project to your account's GitHub organization.

Remember to replace the curly brackets according to your scenario.

1. Clone the current repository to your local environment:
   
   

   _10

   git clone https://github.com/{oldOrganizationName}/{oldRepositoryName}.git

   _10

   cd {oldRepositoryName}

   
   
2. Add the new repository to your local environment:
   
   

   _10

   git remote set-url origin https://github.com/{newOrganizationName}/{newRepositoryName}.git

   
   
3. Verify your remote configuration:
   
   

   _10

   git remote -v

   
   
   You should see your remote listed with the new URL.
4. Push the codebase to the new GitHub organization:
   
   

   _10

   git push -u origin main

   
   

1. Access the FastStore WebOps installation page on GitHub.
2. Click Configure.
3. Click the organization where you want to move your project.
4. Specify whether WebOps should be enabled for all repositories in the new GitHub organization or only selected repositories.
5. Click Installing & Authorizing to install the FastStore WebOps in your new GitHub organization.
   You'll see the message {"status":"pending","message":"Could not find installation intent. If you started this installation outside FastStore WebOps, follow the FastStore Cloud migration guide to finish linking your project."}, which means the migration process is not complete yet.
   

This step is performed in the GitHub organization where you want to move your project. For example, if you're moving your FastStore project from current-org to new-org, you must follow this step in the new-org organization on GitHub.

1. Go to the settings of the GitHub organization.
2. Click GitHub Apps under Third-party Access.
3. Search for FastStore WebOps, then click Configure next to the app name.
4. Check the URL to get the app installation ID. The URL follows this pattern: https://github.com/organizations/{organizationName}/settings/installations/{installationId}, where {organizationName} is the name of your organization and {installationId} is the app installation ID.
   

This step is performed in the repository hosted in the new GitHub organization.

1. Access the GitHub repository page where you want to host your FastStore project. The URL follows this pattern: https://github.com/{newOrganizationName}/{newRepositoryName}. Replace the curly brackets according to your scenario.
2. Open the console in your browser.
3. Run the following command in the console. The response is the repository ID.
   
   

   _10

   $("meta[name=octolytics-dimension-repository_id]").getAttribute('content')

   
   

• Account: Name of your account.
• Link to the old repository: URL of the repository where your project is currently hosted.
• Link to the new repository: URL of the repository where you want to move your project.
• Repository ID: The unique identifier of the repository you want to migrate. See how to get this ID in Identifying the repository ID section.
• App installation ID (installationId): The unique identifier of the FastStore WebOps installation on GitHub. See how to get this ID in Identifying the app installation ID.

Don't publish or make changes to the code in the new repository before the process is complete.