Install Bitbucket Server on Windows from a zip file
This page describes how to install Bitbucket Server in a production environment, with an external database, manually using a zip file.
Other ways to install Bitbucket Server:
On this page
Before you install Bitbucket Server, there are a few questions you need to answer.
|サポートされているオペレーティングシステムと Java のバージョンを使用していますか?|
Check the Supported Platforms page for the version of Bitbucket Server you are installing. This will give you info on supported operating systems, databases and browsers.
|Do you want to run Bitbucket Server as a service?|
Running Bitbucket Server as a service means that Bitbucket Server will automatically startup when Windows is started.
You should use the Windows installer if you want to run Bitbucket Server as a service.
If you choose not to run Bitbucket Server as a service:
For more information about these options, see the pages:
|Are ports 7990, 7992, and 7993 available?|
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.
Do you have a Bitbucket Server license?
You'll need a valid license to use Bitbucket Server.
|Do you have Git and Perl installed and on the right version?|
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.
Do not upgrade Git to the latest version until you check the Supported Platforms page for which version of Git is currently supported.
Check that you have all the other system requirements, including Perl, to avoid any trouble.
Before you install Bitbucket Server, check that you're running a supported Java version and that the
|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.
Install Bitbucket Server
1. Download Bitbucket Server
Download the zip file - www.atlassian.com/software/bitbucket/download.
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
Extract the zip file to your
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
<Bitbucket home directory>.A few things to note about setting up the home directory on Windows that will make life easier...
Keep the path length to the Bitbucket home directory as short as possible. See Bitbucket Server is unable to create the merge diff for pull requests for an explanation.
Don't use spaces in the path to the Bitbucket home directory.
Now tell Bitbucket where your home directory is located. You can do this in one of two ways:
set-bitbucket-home.batfile – uncomment the
BITBUCKET_HOMEline and add the absolute path to your home directory.Here's an example of what that could look like when you're done...
rem set BITBUCKET_HOME=C:\application-data\bitbucket
Or, you can set an environment variable to tell Bitbucket Server where you created your home directory by setting a
BITBUCKET_HOMEenvironment variable. To do this
- Go to System Environment Variables in Windows.
- Click Environment Variables, and then New under 'System variables'.
- Enter "
BITBUCKET_HOME" as the Variable name, and the absolute path to your Bitbucket home directory as the Variable value. Don't use a trailing backslash.
4. Start Bitbucket
Change directory to the
<installation-directory>and run this command:
In your browser, go to
http://localhost:7990/and run through the Setup Wizard.
Set up Bitbucket
The Setup Wizard runs automatically when you visit Bitbucket Server in your browser the first time it's started.
Select External as your database, then choose a Database Type from the dropdown menu and enter the details of your database.
The JDBC drivers for MySQL / MariaDB are not bundled with Bitbucket Server (due to licensing restrictions), so you need download and install the driver.
- Download the MySQL Connector/J JDBC driver from the download site.
- Expand the downloaded
- Copy the
.jarfile from the extracted directory to your
<Bitbucket home directory>/libdirectory.
- Restart Bitbucket server.
Also see Connecting Bitbucket Server to MySQL.
6. Add your license key
You can also set the base URL at this step, (you can elect to do this later).
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.
8. Start using Bitbucket Server
When setting up Bitbucket in a production environment, we recommend that you configure these aspects next:
- Connect Bitbucket to a user directory - manage users/groups stored in an external directory.
- Run Bitbucket as a dedicated user - run Bitbucket from a user account with restricted privileges.
- Secure the Bitbucket home directory - secure the home directory against unauthorized access.
- Proxy and secure Bitbucket - run Bitbucket behind a reverse proxy and enable HTTPS access.
- Establish a data recovery plan - backup the home directory and database of your instance.
Read more about setting up Bitbucket for an enterprise here: Using Bitbucket in the enterprise.