Bitbucket Server をアーカイブ ファイルから Linux にインストールする



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


このページでは、tar.gz ファイルを使用して手動で、外部データベースのある本番環境に Bitbucket Server をインストールする方法を説明します。


Bitbucket Server のその他のインストール方法 

  • トライアル - 無料トライアルの利用をすぐに開始できます。
  • インストーラー – Linux インストーラーを使用して Bitbucket をインストールします。

On this page


Bitbucket Server をインストールする前に、いくつかの質問に答える必要があります。 

サポートされているオペレーティングシステムと Java のバージョンを使用していますか?

サポート対象プラットフォーム」 ページで、インストールする Bitbucket Server のバージョンをご確認ください。このページでは、サポート対象のオペレーティング システム、データベースおよびブラウザーに関する情報を提供しています。


  • 本番サイトでの macOS への Bitbucket Server のインストールはサポートされません。
  • Bitbucket Server インストーラーには Java (JRE) および Tomcat が含まれているため、これらを別途インストールする必要はありません。
Bitbucket Server をサービスとして実行する予定ですか?

Bitbucket Server をサービスとして実行すると、Linux サーバーの起動時に Bitbucket Server が自動的に開始します。

Bitbucket Server をサービスとして実行したい場合は Linux インストーラーを使用してください。

Bitbucket Server をサービスとして実行しない場合

  • Bitbucket Server のインストール ディレクトリで ファイルを実行することで Bitbucket Server を開始および停止します。
  • Bitbucket Server は、Bitbucket Server をインストールするために使用されたユーザー アカウントで実行されます。専用ユーザーとして実行するように選択することもできます。
  • サーバーが再起動される場合、Bitbucket Server を手動で再起動する必要があります。


Bitbucket は既定で 7990、7992、および 7993 ポートを使用します。これらは利用可能ですか?

Port 7990: Bitbucket runs on port 7990 by default. If this port is already in use, see Change the port Bitbucket listens on for more guidance on changing this.

Ports 7992 and 7993: Bitbucket Server's bundled search server, which is required for search functionality, requires ports 7992 and 7993 be available. This is not configurable, so ensure these ports are available.


To run Bitbucket in production you'll need an external database. Check the Supported platforms page for the version you're installing for the list of databases we currently support.


  • データベースは開始前にセットアップしておきます。PostgreSQLOracle、およびSQL Server 向けのガイドが提供されています。
  • MySQL は Bitbucket Server インスタンスでのサポート対象ですが、これは推奨されません。詳細については、「Bitbucket Server を MySQL に接続する」を参照してください。

Bitbucket Server ライセンスを持っていますか?

Bitbucket Server を使用するには、有効なライセンスが必要です。


  • ライセンスをお持ちではない場合、セットアップ中に評価ライセンスを作成できます。この際、業務用のメール アドレスを使用するようにしてください。
  • If you already have a license key you'll be prompted to log in to to retrieve it, or you can enter the key manually during setup.
  • Bitbucket Cloud ( から移行する場合、新しいライセンスが必要です。

Git および Perl の適切なバージョンをインストールしていますか?

Bitbucket Server requires Git on the machine that will run Bitbucket Server. If you need to check, install, or upgrade Git on the Bitbucket Server instance machine, see Installing and upgrading Git.

Git を最新バージョンにアップグレードする前に、現在サポートされている Git バージョンを「サポート対象のプラットフォーム」ページで確認してください。

Check that you have all the other system requirements, including Perl, to avoid any trouble.

JAVA_HOME 変数が正しく設定されていますか?

Before you install Bitbucket Server, check that you're running a supported Java version and that the JAVA_HOME environment variable is set correctly.

JAVA_HOME 変数を確認するには:

$ java -version

JAVA_HOME 変数が正しく設定されていることを確認するには:

$ echo $JAVA_HOME

If you see a path to your Java installation directory, the JAVA_Home environment variable has been set correctly. If a path is not returned you'll need to set your JAVA_HOME environment variable manually before installing Bitbucket Server.

Do you need to use a remote search server?

Bitbucket Server comes with a bundled search server, which runs as a separate process from the Bitbucket Server application and doesn't require any extra configuration.

You can can also install a search server on a remote machine, which can provide some advantages allocating memory resources. In most cases you're better off using our bundled search server that will be automatically configured out of the box.

A clustered Bitbucket Data Center installation requires a search server on a remote machine.

If you still want to use a search server on a remote machine, there are instructions for doing so on the the Install and configure a remote Elasticsearch server and Install and configure a remote OpenSearch server pages.

Bitbucket Server のインストール

1. Bitbucket Server をダウンロードする

Download the tar.gz file -

2. インストールディレクトリの作成

  1. Create your installation directory (with full control permission) – this is where Bitbucket will be installed. Avoid using spaces or special characters in the path. We'll refer to this directory as your <installation-directory>.

  2. Extract the tar.gz file to your <installation-directory>

3. ホームディレクトリの作成

  1. Create your home directory (with full control permission) – this is where your Bitbucket Server data is stored. This should be separate to your installation directory. We'll refer to this directory as your <home-directory>

  2. Edit <installation-directory>/bin/ file – uncomment the BITBUCKET_HOME line and add the absolute path to your home directory.

4. Bitbucket を起動する

  1. Change directory to the <installation-directory> and run this command:

  2. In your browser, go to http://localhost:7990/ and run through the Setup Wizard. 

Bitbucket のセットアップ

Bitbucket Server の初回起動時にブラウザでアクセスすると、セットアップ ウィザードが自動的に実行されます。

5. データベースへの接続 

  1. データベースをまだ作成していない場合、ここで作成します。詳細については、このページの「はじめる前に」セクションを参照してください。 

データベースとして [外部] を選択し、ドロップダウン メニューからデータベース タイプを選択して、データベースの詳細情報を入力します。

MySQL を使用する場合は追加の手順が必要です...

MySQL / MariaDB 用の JDBC ドライバはライセンス上の制限により、Bitbucket Server にバンドルされていません。このため、ドライバをダウンロードしてインストールする必要があります。

  1. MySQL Connector/J JDBC ドライバをダウンロード サイトからダウンロードします。
  2. ダウンロードした zip/tar.gz ファイルを展開します。
  3. 展開したディレクトリの .jar ファイルを <Bitbucket home directory>/lib ディレクトリにコピーします。
  4. Bitbucket Server を再起動します。

Bitbucket Server を MySQL に接続する」もご参照ください。

6. ライセンス キーの追加

Follow the prompts to log in to to retrieve your license, or enter a license key.

また、このステップでベース URL を設定できます (あとから行うこともできます)。

7. 管理者アカウントの作成

  1. 管理者アカウントの詳細情報を入力します。
  2. Select either Go to Bitbucket to go straight to the Bitbucket interface or Integrate with Jira to create your connection with an existing Jira application. 


    You can also select to use a Jira application as your user database during this step. See the page Configuring Jira integration in the Setup Wizard for details. You can also do this later.

9. Bitbucket Server の使用を開始する

That's it! Your Bitbucket site is accessible from a URL like this: http://<computer_name_or_IP_address>:<port>


本番環境に Bitbucket をセットアップする場合、次に、以下の部分を設定することをおすすめします。

Read more about setting up Bitbucket for an enterprise here: Using Bitbucket in the enterprise.

最終更新日 2022 年 11 月 24 日


Powered by Confluence and Scroll Viewport.