Change a workspace ID

Changing your workspace ID will change the URL for all associated repositories, snippets, and any static websites you're hosting on Bitbucket Cloud.

A workspace is how you will organize different streams of work in an account. For now, you'll only have one workspace and one workspace ID.

You can change your workspace ID in Bitbucket Cloud; however, this will change the URLs for all the repositories, snippets, and static websites you're hosting on Bitbucket Cloud.

This page:

Change your workspace ID for repository, snippet, wiki, and website URLs

Changing your URL is a two-part processYou first update the workspace ID in Bitbucket Cloud and then in your configuration file.

Update the workspace ID in Bitbucket Cloud

  1. Click your profile avatar in the lower-left corner > click Bitbucket settings.
  2. From the Account settings page, click Change next to the workspace ID.
  3. Enter your new workspace ID. Your workspace ID can only contain lowercase letters with no spaces or special characters.
  4. View the repositories that will be impacted to confirm you understand the impact of this change.
  5. Follow the prompts to confirm the change.
  6. Update any configuration files, builds, or references to the old URLs.

This change on the remote Bitbucket server invalidates any local repositories pointing to your repositories on Bitbucket. You and anyone who references the old URL in DVCS configuration files must update them to reflect the new workspace ID. 

For example, if you rename your workspace ID from johnc to jcitizen, the repository previously available at is accessed as after renaming.

Update the URL in your configuration file

The URL you use for a repository depends on which protocol you're using: HTTPS or SSH. You can find these URLs from the Clone button on the Source page of your repository.

You can click back and forth between the SSH and the HTTPS protocol links to see how the URLs differ. The table below shows how the formats vary based on protocol.

URL の一部として次の名前が表示されます。

  • <repo_name> にはリポジトリ名が表示されます。

  • In place of <workspace_ID> in the HTTPS URL format, you'll see the workspace ID for your workspace.

Git リポジトリ URL
HTTPS 形式 https://<your_username><workspace_ID>/<repo_name>.git
SSH 形式<workspace_ID>/<repo_name>.git



Mercurial リポジトリ URL
HTTPS 形式 https://<your_username><workspace_ID>/<repo_name>
SSH 形式 ssh://<workspace_ID>/<repo_name>/

Git リポジトリの URL を更新する

  1. ターミナルでリポジトリに移動します。

    $ cd ~/<path_to_repo>
  2. 現在のリモート URL を表示するには、git remote -v を実行します。

    $ git remote -v
    origin (fetch)
    origin (push)
  3. 現在のリモート URL と新しいリモート URL を使用して、リモート URL を git remote set-url で更新します。

    $ git remote set-url origin

HTTPS から SSH に URL を更新すると、次にリポジトリからプッシュまたはプルを行ったときに、ターミナルは、Bitbucket ホストを既知のホストのリストに追加することを応答します。また、パスワードを入力する必要はありません。

Mercurial リポジトリの URL を更新する

  1. ターミナルで現在のリポジトリ設定を表示します。

    $ cd ~/<path_to_repo>
    $ cat .hg/hgrc
    default =

    先ほどの例では、default URL は HTTPS プロトコルを使用しています。

  2. Open the ~/<path_to_repo>/.hg/hgrc file in your favorite text editor.
  3. default の値を、そのリポジトリに使用する URL の値に変更します。

    default = ssh://
  4. 構成ファイルを保存して閉じます。

HTTPS から SSH に URL を更新すると、次にリポジトリからプッシュまたはプルを行ったときに、ターミナルは、Bitbucket ホストを既知のホストのリストに追加することを応答します。また、パスワードを入力する必要はありません。

最終更新日 2019 年 4 月 17 日


Powered by Confluence and Scroll Viewport.