Stash is now known as Bitbucket Server.
See the

Unknown macro: {spacejump}

of this page, or visit the Bitbucket Server documentation home page.

メタデータの末尾にスキップ
メタデータの先頭に移動

To install Stash yourself...

... from an archive file, on Linux, Mac OS X or Windows, read on!

Use the installer instead...

... for a quick and trouble-free install.
See Getting started.

For production installs...

... 最初に「企業での Stash の使用」をお読みになることを強く推奨します。

This page describes how to manually install Stash from an archive file. However, we strongly recommend that you use the Stash installer instead, for a quick and trouble-free install experience.

これらの代替プロビジョニングに関心がある場合:

1. サポート対象プラットフォームを確認する

Check the Supported platforms page for details of the application servers, databases, operating systems, web browsers and Java and Git versions that we have tested Stash with and recommend.

Atlassian only officially supports Stash running on x86 hardware and 64-bit derivatives of x86 hardware.

Cygwin Git is not supported. No internal testing is done on that platform, and many aspects of Stash's functionality (pull requests and forks among them) have known issues. When running Stash on Windows, always use msysGit.

2. Java のバージョンを確認する

ターミナルまたはコマンド プロンプトで以下を実行します。

java -version

The version of Java should be 1.7.x or 1.8.x. You'll need a 64-bit version of Java if you have a 64-bit operating system.

 Linux でサポート対象バージョンが表示されない場合、Java を取得...

Java をインストール

Download Java Server JRE from Oracle's website, and install it.

Now try running 'java -version' again to check the installation. The version of Java should be 1.7.x  or 1.8.x.

システムが Java を検出できることを確認します。

ターミナルで、以下を実行します。

echo $JAVA_HOME

You should see a path like /usr/jdk/jdk1.7.0.

パスが表示されない場合は、JAVA_HOME を設定します。

次のいずれかの操作を行います:

  • If JAVA_HOME is not set, log in with 'root' level permissions and run:

    echo JAVA_HOME="path/to/JAVA_HOME" >> /etc/environment

    where path/to/JAVA_HOME may be like: /usr/jdk/jdk1.7.0

  • If JAVA_HOME needs to be changed, open the  /etc/environment file in a text editor and modify the value for JAVA_HOME to:
    JAVA_HOME="path/to/JAVA_HOME"

    It should look like: /usr/jdk/jdk1.7.0

 On Mac OS X, if you don't see a supported version, then get Java...

Java をインストール

Download Java Server JRE from Oracle's website, and install it.

Now try running 'java -version' again to check the installation. The version of Java should be 1.7.x or 1.8.x.

システムが Java を検出できることを確認します。

ターミナルで、以下を実行します。

echo $JAVA_HOME
You should see a path like /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home/.

パスが表示されない場合は、JAVA_HOME を設定します。

Open your ~/.profile file in a text editor and insert:

JAVA_HOME="path/to/JAVA_HOME"
export JAVA_HOME

where path/to/JAVA_HOME may be like: /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home/

Refresh your ~/.profile in the terminal and confirm that JAVA_HOME is set:

source ~/.profile
$JAVA_HOME/bin/java -version

You should see a version of Java that is 1.7.x or 1.8.x, like this:

java version "1.7.0_1"

 Windows でサポート対象バージョンが表示されない場合、Java を取得...

Java をインストール

Download Java Server JRE from Oracle's website, and install it.

Now try running 'java -version' again to check the installation. The version of Java should be 1.7.x or 1.8.x.

システムが Java を検出できることを確認します。

Stash uses the JAVA_HOME environment variable to find Java. To check that, in a command prompt, run:

echo %JAVA_HOME%

You should see a path to the root directory of the Java installation. When running Stash on Windows, unlike Linux or Unix, JAVA_HOME paths with spaces are just fine.

パスが表示されない場合は、JAVA_HOME を設定します。

 Windows 7 ...

ステージ 1. Java インストール ディレクトリを見つける

JRE のインストール パスがすでに分かっている場合、下記の手順 2へ進んでください。それ以外の場合、次の手順に従ってインストール パスを見つけてください:

  1. If you didn't change the installation path for the Java Runtime Environment during installation, it will be in a directory under C:\Program Files\Java. Using Explorer, open the directory C:\Program Files\Java.
  2. Inside that path will be one or more subdirectories such as C:\Program Files\Java\jre7

ステージ 2. JAVA_HOME 変数を設定する

  1. [Start] に移動し、"sys env" を検索してから、[Edit the system environment variables] を選択します。
  2. [Environment Variables] をクリックした後、[System variables] の下で [New] をクリックします。
  3. variable name に「JAVA_HOME」と入力し、Variable value として、Java のインストール先の絶対パスを入力します。末尾にバックスラッシュを使用したり、値を引用符で囲んだりしないでください。

Now, in a new command prompt,  try running '%JAVA_HOME%\bin\java -version'. You should see the same version of Java as you saw in 2. above.

 Windows Server 2003 R2 ...

ステージ 1. Java インストール ディレクトリを見つける

JRE のインストール パスがすでに分かっている場合、下記の手順 2へ進んでください。それ以外の場合、次の手順に従ってインストール パスを見つけてください:

  1. If you didn't change the installation path for the Java Runtime Environment during installation, it will be in a directory under C:\Program Files\Java. Using Explorer, open the directory C:\Program Files\Java.
  2. Inside that path will be one or more subdirectories such as C:\Program Files\Java\jre7

ステージ 2. JAVA_HOME 変数を設定する

JRE インストール パスを特定したあと:

  1. デスクトップの マイ コンピュータ アイコンを右クリックして プロパティ を選択します。
  2. 詳細設定 タブをクリックします。
  3. 環境変数 ボタンをクリックします。
  4. システム環境変数 領域で、新規 をクリックします。
  5. 変数名として「JAVA_HOME」と入力します。
  6. variable value に Java Development Kit (JDK) のインストール パスを入力します。末尾にバックスラッシュを使用したり、値を引用符で囲んだりしないでください。
    • If your Java installation directory has a space in its path name, you should use the shortened path name (e.g. C:\Progra~1\Java\jre7) in the environment variable instead.

      64 ビットシステムの Windows ユーザー向け注記

      Progra~1 = 'Program Files'
      Progra~2 = 'Program Files(x86)'

  7. OK をクリックします。
  8. 変更の適用 をクリックします。
  9. これらの変更を加える前に開いていたすべてのコマンド ウィンドウを閉じ、新しいコマンド ウィンドウを開きます。実行中のコマンド プロンプトから環境変数をリロードすることはできません。コマンド プロンプトを一旦閉じ、再度開いても、変更が反映されない場合は、Windows を再起動してください。

Now, in a new command prompt,  try running '%JAVA_HOME%\bin\java -version'. You should see the same version of Java as you saw in 2. above.

3. Git および Perl のバージョンを確認する

ターミナルまたはコマンド プロンプトで以下を実行します。

git --version
perl --version

The version of Git should be 1.7.6 or higher. The version of Perl should be 5.8.8 or higher.

If you don't see supported versions of Git and Perl, either install or upgrade them – see Installing and upgrading Git.

4. Now it's time to get Stash  

Download Stash from the Atlassian download site. Looking for the Stash WAR file?

ダウンロードしたファイルをインストール場所に展開します (パスにスペースは含まないこと)。 

The path to the extracted directory is referred to as the <Stash installation directory> in these instructions.

Never unzip the Stash archive file over the top of an existing Stash installation –  each version of Stash includes versioned jar files, such as  stash-model-2.4.1.jar . If you copy these, you end up with multiple versions of Stash's jar files in the classpath, which leads to runtime corruption.

Note that you should use the same user account to both extract Stash and to run Stash (in Step 6.) to avoid possible permission issues at startup. For production installations, we recommend that you create a new dedicated user that will run Stash on your system. See Running Stash with a dedicated user.

5. Tell Stash where to store your data

The Stash home directory is where your Stash data is stored.

If you are upgrading Stash, simply update the value of STASH_HOME in the <Stash installation directory>/bin/setenv file so the new Stash installation points to your existing Stash home directory (if you use a STASH_HOME environment variable to specify the home directory location, no change is required).

Otherwise, for a new install, create your Stash home directory (without spaces in the name), and then tell Stash where you created it by editing the <Stash installation directory>/bin/setenv file – uncomment the STASH_HOME line and add the absolute path to your home directory. Here's an example of what that could look like when you're done:

(warning) You should not locate your Stash home directory inside the  <Stash installation directory> — they should be entirely separate locations. If you do put the home directory in the <Stash installation directory> it may be overwritten, and lost, when Stash gets upgraded. And by the way, you'll need separate Stash home directories if you want to run multiple instances of Stash.

 Windows の場合の注意事項をクリックして確認...

Tell Stash where you created it by setting a STASH_HOME environment variable, for Windows 7, as follows:

  1. [スタート] に移動し、「sys env」を検索してから、[システム環境変数の編集] を選択します。
  2. [環境変数] をクリックした後、[システム変数] の下で [新規] をクリックします。
  3. Enter "STASH_HOME" as the Variable name, and the absolute path to your Stash home directory as the Variable value. Don't use a trailing backslash.

There are a few things to know about setting up the Stash home directory on Windows that will make life easier:

6. Move server.xml to your Stash home shared directory

If this is a new installation, or you are already running Stash 3.8 or above, you can skip to the next step.

If you are upgrading from Stash 3.7 or earlier and you made any changes to <Stash installation directory>/conf/server.xml (for instance to secure your server with SSL):

  1. In the <STASH_HOME> directory, make a new directory called shared.
  2. Then, copy your modified server.xml file into <STASH_HOME>/shared/. Ensure the copied file is readable by the user account that runs Stash.

7. Start Stash!

There are a couple of ways in which you can start Stash – see Starting and stopping Stash.

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

8. メール サーバーをセットアップする

Configure your email server so users can receive a link from Stash that lets them generate their own passwords. See Setting up your mail server.

9. ユーザーとディレクトリを追加する

Now is the time to set up your users in Stash, and to tell Stash about any existing repositories you have. Please the following pages for the details:

本番環境用の追加手順

For production or enterprise environments we recommend that you configure the additional aspects described on Using Stash in the enterprise. The aspects described there are not necessary when you are installing for evaluation purposes only.

If you wish to install Stash as a service on Linux or Windows, see either of:


Stopping Stash

See Starting and stopping Stash.

Uninstalling Stash

To uninstall Stash, stop Stash as described above and then delete the <Stash installation directory> and Stash home directory.

  • ラベルなし