Versions
- 9.6
- 9.5
- 9.4
- 9.3
- 9.2
- 9.1
- 9.0
- 8.19
- 8.18
- 8.17
- 8.16
- 8.15
- 8.14
- 8.13
- 8.12
- 8.11
- 8.10
- 8.9
- 8.8
- 8.7
- 8.6
- 8.5
- 8.4
- 8.3
- 8.2
- 8.1
- 8.0
- 7.21
- 7.20
- 7.18
- 7.19
- 7.17
- 7.16
- 7.15
- 7.14
- 7.13
- 7.12
- 7.11
- 7.10
- 7.9
- 7.8
- 7.7
- 7.6
- 7.5
- 7.4
- 7.3
- 7.2
- 7.1
- 7.0
- 6.10
- 6.9
- 6.8
- 6.7
- 6.6
- 6.5
- 6.4
- 6.3
- 6.2
- 6.1
- 6.0
- 5.16
- 5.15
- 5.14
- 5.13
- 5.12
- 5.11
- 5.10
- 5.9
- 5.8
- 5.7
- 5.6
- 5.5
- 5.4
- 5.3
- 5.2
- 5.1
- 5.0
- See all
Install a Bitbucket Server trial
Bitbucket Server installation guide
- Install a Bitbucket Server trial
- Install Bitbucket Server on Windows
- Install Bitbucket Server on Linux
- Running Bitbucket Server with a dedicated user
- Running Bitbucket Server as a Linux service
- Automated setup for Bitbucket Server
- Starting and stopping Bitbucket Server
- Install Bitbucket Server from an archive file
- Running the Bitbucket Server installer
On this page
Related content
- Exporting issues from Cloud to Data Center
- Restoring data from an xml backup
- Migrating from Jira Cloud to Data Center applications
- Importing and exporting data
- Migrating Jira applications to another server
- Backing up the database
- Anonymising Jira application data
- Splitting Jira applications
- Rolling back a Jira application upgrade
- Migrating data with 3rd party apps
Want to get up and running with Bitbucket Server quickly? This page will guide you through the steps to install and set up a trial instance of Bitbucket Server.
If you're ready to set up a production instance of Bitbucket Server, or you want more control, check out our other installation guides.
Before you begin
Our installers come with all the bits and pieces you need to run the application, but there's a few things you'll need to get up and running:
A computer or laptop with a supported operating system - you'll be installing Bitbucket so you'll need admin rights.
Supported operating systems...You can install Bitbucket on a Windows, Linux, or Mac operating system. However Mac isn't supported for production instances.
A supported web browser - you'll need this to access Bitbucket, we support the latest versions of Chrome and Mozilla Firefox, Internet Explorer 11, and Microsoft Edge.
A valid email address - you'll need this to generate your evaluation license and create an account. Register with your business email domain to access live chat and phone calls with Bitbucket product specialists (for a limited time).
Ready to get going? Let's start with grabbing the installer.
1. Download the installer
Head to www.atlassian.com/software/bitbucket/download and download the installer for your operating system.
2. Install Bitbucket
The installer allows you to choose the installation and home directories. For this guide we recommend using the default options.
- Run the installer - we recommend running with an administrator account.
- Choose Install a standard instance, then click Next.
- When prompted, choose to start and launch Bitbucket in a browser.
- Bitbucket will open in your default browser, and you're ready to start the setup wizard.
The application will be available athttp://localhost:7990.
Change to the directory where you downloaded Bitbucket then execute this command to make it executable:
$ chmod a+x atlassian-Bitbucket-X.X.X-x64.binWhere
X.X.Xis is the Bitbucket version you downloaded.Run the installer - we recommend using
sudoto run the installer as this will create a dedicated account to run Bitbucket and allow you to run Bitbucket as a service.$ sudo ./atlassian-Bitbucket-X.X.X-x64.bin- When prompted, choose to start and launch Bitbucket in a browser.
- Once installation is complete head to
http://localhost:7990in your browser to begin the setup process.
3. Set up Bitbucket
The Setup Wizard runs automatically when you visit Bitbucket Server in your browser the first time it's started.
Add your license key
Follow the prompts and head to my.atlassian.com where you can generate a trial license. Be sure to register with your business email domain to access live chat and phone calls with Bitbucket product specialists.
Create your administrator account
- Enter details for the administrator account.
Click either Go to Bitbucket - to go straight to the Bitbucket Server interface, or Integrate with JIRA - to create your connection with an existing JIRA application.
Tell me more...You can also chose 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 elect to do this later.
Start using Bitbucket Server
What's next?
When setting up Bitbucket Server in a production environment, we recommend that you configure these aspects next:
- Connect Bitbucket Server to a user directory - manage users/groups stored in an external directory.
- Run Bitbucket Server as a dedicated user - run Bitbucket Server from a user account with restricted privileges.
- Secure the Bitbucket home directory - secure the home directory against unauthorized access.
- Proxy and secure Bitbucket Server - run Bitbucket Server 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 Server for an enterprise here: Using Bitbucket Server in the enterprise.
Related content
- Exporting issues from Cloud to Data Center
- Restoring data from an xml backup
- Migrating from Jira Cloud to Data Center applications
- Importing and exporting data
- Migrating Jira applications to another server
- Backing up the database
- Anonymising Jira application data
- Splitting Jira applications
- Rolling back a Jira application upgrade
- Migrating data with 3rd party apps