Bitbucket Server upgrade guide


アトラシアン コミュニティをご利用ください。


This guide describes how to upgrade your Bitbucket Server installation on Linux to the latest version using the installer.

現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。

Other ways to upgrade Bitbucket:



Before you upgrade Bitbucket there are a few questions you need to answer.

Is using the installer the right upgrade method for you?

You can choose to upgrade using the installer, or, if the installer is not suitable for your situation you can use an archive file to update your Bitbucket Server instance. Only use an archive file to update Bitbucket Server if the installer is not suitable for your situation, as the installer is the the recommended approach to upgrade for most use cases.

Read about how to upgrade Bitbucket Server from an archive file.


To check if software maintenance is current for your license, go to > Licensing and make sure the license support period has not expired.


Have our support platforms changed?

サポート対象プラットフォーム」ページで、アップグレード先の Bitbucket バージョンを確認します。ここでは、サポート対象のオペレーティング システム、データベース、およびブラウザを確認できます。

Have you taken into consideration all the version-specific upgrade information?

Make sure you read the following pages for each version between your current version of the application and the version you're upgrading to:

This will give you information about specific update notes for each version of Bitbucket Data Center and Server.

Are you upgrading from Bitbucket 4.x or earlier and have you modified your server.xml file?

Bitbucket 5 で、ポート番号、コンテキスト パス、アクセス プロトコルなどのプロパティの設定場所を変更して単一のディレクトリおよびファイルにまとめ、以降のリリースでのアップグレードを行いやすくしました。

Bitbucket 4.14 以前の任意のバージョンから Bitbucket 5.0 以降にアップグレードする場合、server.xml ファイルへの変更を ファイルに手動で移行する必要があります。

See the page Migrate customizations from server.xml to for instructions on locating your server.xml file and how to migrate your customizations.


1. アップグレード パスを決定する

ご利用の環境が Bitbucket の最新バージョンの実行要件を満たしているかどうかを、「サポート対象プラットフォーム」ページで確認します。また、「サポート終了のお知らせ」を確認します。 

You can update from any previous version of Bitbucket Server (or Stash) to the latest version, as there is no required upgrade path.

Bitbucket 8 is a major upgrade

Be sure to read the Bitbucket Server 8.0 release notes, take a full backup, and test your upgrade in a non-production environment before upgrading your production site.

Bitbucket 8 よりも古いバージョンからアップグレードすると、ユーザーがインストールしたすべてのアプリが起動時に無効化されます

Be sure to update your own apps and check the Atlassian Marketplace to ensure 3rd-party apps are compatible with Bitbucket Server 8 before upgrading.

tip/resting Created with Sketch.


複数ノードの Bitbucket クラスタを次のバグ修正アップデートにアップグレードする場合 (8.0.0 から 8.0.1 など)、ダウンタイムなしでアップグレードできます

2. Complete pre-upgrade checks

  1. アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
  2.  > [サポート ツール] に移動し、解決が必要な問題がログ アナライザーにあるかどうかを確認します。
  3. Check the compatibility of your apps with the version you plan to upgrade to.

    1.  > [アプリの管理] > [Bitbucket 更新の確認] に移動します。
    2. アップグレード先として計画しているバージョンを選択して [確認] を押します。

      If you have incompatible apps

      If your users rely on particular apps, you may want to wait until they are compatible before upgrading Bitbucket. App vendors generally update their apps very soon after a major release.


      • If you're performing a major version upgrade, user-installed apps will be disabled. You will need to enable your apps after successfully upgrading, regardless of compatibility with Bitbucket Server.

      • You can disable an app temporarily if it is not yet compatible. 

3. Upgrade Bitbucket in a test environment

  1. Create a staging copy of your current production environment.
  2. 以下の手順に従って、テスト環境をアップグレードします。
  3. Test any unsupported apps, customizations and proxy configuration (if possible) before upgrading your production environment.

Upgrade Bitbucket

This upgrade process does not perform an in-place upgrade, but instead installs the new version of Bitbucket Server into a new installation directory. The new instance uses your existing Bitbucket Server home directory and external database.

If necessary, rolling back an upgrade can only be performed by restoring a backup of both the Bitbucket Server home directory and the Bitbucket Server database – rolling back requires a consistent home directory and database. You can then reinstall the previous version of the application to the installation directory. Read the Rollback section for more details.

4. Download Bitbucket Server

Download the installer (the recommended approach) for your operating system -

5. データをバックアップする

  1. Determine which backup strategy to use. 

    Summary of the different backup strategies for Bitbucket...

    For Bitbucket Server (version 4.8 or later) instances, you can use Zero Downtime Backup, the Backup Client (version 2.7 or later), or DIY Backup (version 2.12 or later) while Bitbucket is running, or just stop Bitbucket and zip up / snapshot the home directory and database and keep them somewhere safe.

    For Bitbucket Data Center (version 4.8 or later) instances, you can use Zero Downtime BackupDIY Backup, or take snapshots of the shared home directory (on NFS) and database while all nodes are stopped. 

    For Bitbucket mirrors, the home directory doesn't store any persistent state that can't be reconstructed from the primary Bitbucket instance, but you should still make sure you have a backup of at least the important configuration files such as SSL certificate, server.xml,  config/ssh-server-keys.pem, file, and so on in a safe place. See  How do I back up my mirrors? for more information.

    See the article Data recovery and backups for detailed information and guidance on creating an effective backup strategy.

  2. Back up all the data in your Bitbucket home directory and external database.

 6. Migrate customizations

If upgrading from Bitbucket 4.x or earlier, see migrate customizations.

7. Stop the application

To stop Bitbucket Server from your Linux terminal, change to the <Bitbucket Server installation directory> and run:

For Bitbucket Data Center...

Be sure to stop all nodes of Bitbucket Data Center, perform the steps to upgrade for a single node first, then repeat the process on each cluster node.

詳細な手順については「Bitbucket の開始と終了」ページをご確認ください。

8. インストーラーを実行する

You can run the installer in GUI, console or unattended modes.

  1. Run the installer. 
    From your Linux terminal, change to the directory where you downloaded Bitbucket Server then execute this command to make the installer executable: 

    chmod +x atlassian-bitbucket-x.x.x-x64.bin

    sudo を使用してインストーラーを実行することをお勧めします。これにより Bitbucket Server を実行する専用アカウントが作成され、Bitbucket Server をサービスとして実行できます。

    インストーラーを実行するために sudo を使用するには、次のコマンドを実行します。 

    $ sudo ./atlassian-bitbucket-x.x.x-x64.bin

    You can also run the installer with root user privileges.

  2. Follow the prompts to upgrade Bitbucket Server.
    1. At the 'Welcome' step, choose the type of instance to upgrade

      Help me decide which type of upgrade to choose...

      For a single node (most users), choose the Upgrade an existing Bitbucket instance option.

      For Bitbucket Data Center instances, choose the Upgrade an existing Bitbucket instance option, and repeat the upgrade process for each application node.

      For a Bitbucket mirror, choose the Upgrade an existing mirror option.

    2. At the 'Select Bitbucket Server Home' step, select your existing home directory.

    3. Proceed with the remaining installer steps.

9. Start the application

If you’re also upgrading your operating system libraries and using PostgresSQL and glibc version lower than 2.28, and the upgrade increases the glibc version to 2.28 or later, you’ll need to rebuild the PostgresSQL indices before starting Bitbucket.

When using the installer, there will be an option to start the application (and launch it in a browser) at the end of the installation wizard.

For a H2 database (on a Bitbucket Mirror or Server), you must
  1. Choose No at this option
  2. Change to your <Bitbucket Server installation directory>
  3. Migrate your H2 database to MvStore format. For detailed instructions, see Migrate H2 database from 1.3 to 1.4.
  4. Start Bitbucket manually.

Bitbucket を手動で開始する方法を含む詳細な手順については、「Bitbucket の開始と終了」をご確認ください。


If necessary, rolling back an update can only be performed by restoring a backup of both the Bitbucket Server home directory and the Bitbucket Server database – rolling back requires a consistent home directory and database. You can then reinstall the previous version of the application to the installation directory. Never start an older binary against an upgraded home directory.

Check for known issues and troubleshooting

If something is not working correctly after you have completed the steps above to update your Stash installation, please check for known Stash issues and try troubleshooting your update as described below:

  • Check for known issues. Known issues can be seen in the BSERV project on our issue tracker.
  • Bitbucket Server Knowledge Base. Sometimes we find out about a problem with the latest version of Stash after we have released the software. In such cases we publish information in the Bitbucket Server Knowledge Base.
  • If you encounter a problem during the update and cannot solve it, please create a support ticket and one of our support engineers will help you.
最終更新日: 2023 年 1 月 31 日


Powered by Confluence and Scroll Viewport.