Run the Bitbucket installer

This page provides information about running Bitbucket Data Center and Server with search installed. For high-level information about installing and using Bitbucket see Getting started.

An installer is available for the Linux operating system. 

The installer will:

  • Install Bitbucket into a fresh directory, even if you have an earlier version installed.
  • Install a supported version of the Java JRE, which is only available to Bitbucket.
  • Install a bundled, local search server.
  • Launch Bitbucket when it finishes.

Additional services provided by the installer, and described on this page, are:

You can also automate the Bitbucket Setup Wizard so that a Bitbucket instance can be completely provisioned automatically – see Automated setup for Bitbucket.

Running the installer

Download the Bitbucket Server installer from the Atlassian download site.

For Linux...

On Linux, you need to set the executable flag on the installer file before running it: 

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


Run the installer, and follow the installation wizard.


Install Bitbucket as a service

The installer can install Bitbucket as a service (although not when upgrading an existing instance of Bitbucket).

A service account named 'atlbitbucket' will be created.

On Linux

  • The 'atlbitbucket' account will be a locked account (it cannot be used to log in to the system). 
  • The init.d script will be linked to run levels 2, 3, 4 and 5. If you wish to change this, you will need to configure it manually.


Console and unattended mode

The Bitbucket installer has three modes:

  • GUI mode: the default mode for the installer is to display a GUI installer.
  • Console mode: if the installer is invoked with the -c argument, the interaction with the user is performed in the terminal from which the installer was invoked.
  • Unattended mode: if the installer is invoked with the -q argument, there is no interaction with the user and the installation is performed automatically with the default values.

Unattended mode also allows you to supply a response file with a -varfile option, to supply answers for all questions that are used instead of the defaults. An example response file is:

Example response file
 // Should Bitbucket Server be installed as a Service? Must be ADMIN (default: true if the process is running with administrator rights, false otherwise). If false, the home and installation directories must be specified to point to directories owned by the user
app.install.service$Boolean=true

// The ports Bitbucket Server should bind to (defaults: portChoice=default, httpPort=7990)
portChoice=custom
httpPort=7990


// Path to the Bitbucket Server HOME directory (default: /var/atlassian/application-data/bitbucket if the process is running with administrator rights, ~/atlassian/application-data/bitbucket otherwise)
app.bitbucketHome=/var/atlassian/application-data/bitbucket


// The target installation directory (default: /opt/atlassian/bitbucket/<VERSION> if the process is running with administrator rights, ~/atlassian/bitbucket/<VERSION> otherwise)
app.defaultInstallDir=/opt/atlassian/bitbucket/<VERSION>

The following parameters can be included in the file.

ParametersAccepted valuesDescription
app.bitbucketHome
This is the path to your target local home directory.
app.defaultInstallDir
This is the path to your target installation directory for a new install, or existing installation directory to be upgraded.
installation.type
  • INSTALL
  • UPGRADE
  • DATA_CENTER_INSTALL
  • DATA_CENTER_UPGRADE
  • MIRROR_INSTALL
  • MIRROR_UPGRADE

Determines the type of installation:

  • INSTALL - Install a new single-node Bitbucket instance with a search server
  • UPGRADE - Upgrade an existing single-node Bitbucket instance with a search server
  • DATA_CENTER_INSTALL - Install one node in a multi-node Bitbucket Data Center instance
  • DATA_CENTER_UPGRADE - Upgrade one existing node in a multi-node Bitbucket Data Center instance
  • MIRROR_INSTALL - Install a Bitbucket mirror instance
  • MIRROR_UPGRADE - Upgrade an existing Bitbucket mirror instance
portChoice
  • custom
  • default
Determines whether Bitbucket should be installed with default ports or custom values.
httpPort<numeric port value>HTTP port for Bitbucket, if portChoice is set to custom.
app.install.service$Boolean
  • true
  • false
Determines whether Bitbucket should be installed as a service or not.
app.service.account<service account name>Account name for the Bitbucket service if Bitbucket is installed as a service.
launch.application$Boolean
  • true
  • false
Determines whether the installer should start Bitbucket once installation is complete.
sys.adminRights$Boolean=true
  • true
  • false
Indicates whether the user running the installer has admin rights privileges on the machine.
sys.languageId
Default application language



For more information see the install4j documentation.

Further reading

Use Bitbucket in the enterprise

Last modified on Aug 31, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.