How to Update Your Repository URL

If your repository has moved to a new location (e.g., transferred to a different workspace on Bitbucket, GitHub, or GitLab), you can update the URL in DeployBot without needing to recreate the project.

Before You Start

If your repository uses SSH key authentication, you'll need to add the DeployBot public key to your new repository or workspace:

  1. In DeployBot, go to your repository's Settings > General page

  2. Copy the public key shown there

  3. Add it to your new repository host:

    • Bitbucket: Go to Repository Settings > Access keys and click Add key

    • GitHub: Go to Repository Settings > Deploy keys and click Add deploy key

    • GitLab: Go to Repository Settings > Repository > Deploy keys and click Add key

  4. Paste the public key and save

Tip: If multiple repositories in your DeployBot account share the same SSH key (account-level key), you only need to add it once at the workspace or organization level on your Git host, rather than adding it to each repository individually. For example, on Bitbucket, go to Workspace Settings > Access keys to add it as a workspace-wide key.

Steps to Update the Repository URL

  1. Log in to your DeployBot account

  2. Go to Repositories and click the repository you want to update

  3. Click the Settings tab to open repository settings

  4. Under General, find the Repository URL section

  5. Click "Do you want to change this URL?"

  6. On the Reconnect repository page, select how you want to connect:

    • GitHub — select a connected GitHub account and choose the repository

    • Bitbucket — select a connected Bitbucket account and choose the repository

    • GitLab — select a connected GitLab account and choose the repository

    • Others — manually enter the repository URL for self-hosted or other Git providers

  7. Click "Reconnect"

Important Notes

  • You cannot reconnect a repository while a deployment is in progress. Wait for any active deployments to finish first.

  • Your server environments, deployment settings, and history will be preserved — only the source repository URL changes.

  • If new commits stop appearing after the change, go back to Settings > General and click "reconnecting your repository" to re-add the deployment key and webhook.

Was this helpful?