Cyberithub

How to Install Bitbucket on Linux Using 7 Simple Steps

Advertisements

In this article, I will take you through the steps to install Bitbucket on Linux. Bitbucket is a Git based source code repository by Atlassian. Bitbucket offers both commercial plans and free accounts with an unlimited number of private repositories. It provides an excellent solution to an organization who does not want to keep their project source code in a public repository like GitHub. Bitbucket allows developers to store, manage and track changes to their code in an efficient manner. More on official website. The installation and setup of Bitbucket is also as easy as it looks. Here we will see the steps to install Bitbucket Server on Linux(in our case it is Ubuntu 20.04 LTS) in great detail.

How to Install Bitbucket on Linux Using 7 Simple Steps

How to Install Bitbucket on Linux Using 7 Simple Steps

Also Read: How to Create and Work on your Own Bitbucket Feature Branch

Advertisements

Step 1: Prerequisites

a) You should have a running Ubuntu 20.04 LTS Server.

b) You should have sudo or root access to run privileged commands.

Advertisements

c) You should have apt or apt-get utility available in your Server.

 

Step 2: Download Bitbucket

You need to go to Bitbucket official download page and choose Linux 64 bit Operating System as shown below. Then Click on I agree checkbox and submit. This will start downloading the Bitbucket Server in your local system download folder.

Advertisements

How to Install Bitbucket on Linux Using 7 Simple Steps 2

 

Step 3: Install Git

Before installing Bitbucket you need to make sure git package is available in your System. You can simply use sudo apt-get install git -y command to download and install the git package along with all its dependencies from default Ubuntu repo as shown below.

cyberithub@ubuntu:~$ sudo apt-get install git -y
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following additional packages will be installed:
git-man
Suggested packages:
git-daemon-run | git-daemon-sysvinit git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn
The following NEW packages will be installed:
git
The following packages will be upgraded:
git-man
1 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
Need to get 8,223 kB of archives.
After this operation, 40.4 MB of additional disk space will be used.
Get:1 http://ppa.launchpad.net/git-core/ppa/ubuntu focal/main amd64 git-man all 1:2.37.0-0ppa1~ubuntu20.04.1 [1,956 kB]
Get:2 http://ppa.launchpad.net/git-core/ppa/ubuntu focal/main amd64 git amd64 1:2.37.0-0ppa1~ubuntu20.04.1 [6,267 kB]
Fetched 8,223 kB in 4s (2,213 kB/s)
(Reading database ... 197553 files and directories currently installed.)
Preparing to unpack .../git-man_1%3a2.37.0-0ppa1~ubuntu20.04.1_all.deb ...
Unpacking git-man (1:2.37.0-0ppa1~ubuntu20.04.1) over (1:2.25.1-1ubuntu3.4) ...
Selecting previously unselected package git.
Preparing to unpack .../git_1%3a2.37.0-0ppa1~ubuntu20.04.1_amd64.deb ...
Unpacking git (1:2.37.0-0ppa1~ubuntu20.04.1) ...
Setting up git-man (1:2.37.0-0ppa1~ubuntu20.04.1) ...
Setting up git (1:2.37.0-0ppa1~ubuntu20.04.1) ...
Processing triggers for man-db (2.9.1-1) ...

 

Step 4: Check Git Version

Once Git package is successfully installed, you can verify the current version by using git --version command as shown below. To use the latest Bitbucket Server, it is mandatory to have Git version 2.25.0 and above.

Advertisements
cyberithub@ubuntu:~$ git --version
git version 2.37.0

 

Step 5: Run Bitbucket Installer

Before running the installer, you need to provide execute permission on installer file by using chmod +x atlassian-bitbucket-8.2.0-x64.bin command as shown below.

cyberithub@ubuntu:~$ chmod +x atlassian-bitbucket-8.2.0-x64.bin

Once execute permission is given, you can install the application by running below installer file.

cyberithub@ubuntu:~$ ./atlassian-bitbucket-8.2.0-x64.bin
Unpacking JRE ...
Starting Installer ...
You do not have administrator rights to this machine.
You will not be allowed to install Bitbucket as a service or listen on any port that's not permitted by your firewall or security policy.

Are you sure you want to continue?
Yes [y, Enter], No [n]
y

Bitbucket 8.2.0 installation wizard
Would you like to install or upgrade an instance?
Install a new instance [1, Enter], Upgrade an existing instance [2]
1

Install Bitbucket 8.2.0
What type of instance are you looking to install?
Install a Server instance [1, Enter], Install a Data Center instance [2], Install a Smart Mirroring instance [3]
1
Where should Bitbucket be installed?

Select the folder where you would like Bitbucket 8.2.0 to be installed, then
click Next.
[/home/cyberithub/atlassian/bitbucket/8.2.0]

Default location for Bitbucket home directory

The location for Bitbucket data.
This will be the default location for repositories, plugins, and other data.

Ensure that this location is not used by another Bitbucket installation.
[/home/cyberithub/atlassian/application-data/bitbucket]

Configure which ports Bitbucket will use.


Configure TCP Ports
Bitbucket requires a TCP port that isn't being used by other applications.

The HTTP port is where users access Bitbucket through their browsers.

Bitbucket also requires ports 7992 and 7993 are available to run the bundled
search server that provides search functionality to Bitbucket.
HTTP Port Number
[7990]

Please review your Bitbucket installation settings


Installation Summary
Installation Directory: /home/cyberithub/atlassian/bitbucket/8.2.0
Home Directory: /home/cyberithub/atlassian/application-data/bitbucket
HTTP Port: 7990
Install as a service: No

Install [i, Enter], Exit [e]
i

Extracting files ...


Installation of Bitbucket is complete
Would you like to launch Bitbucket?
Yes [y, Enter], No [n]
y

Please wait a few moments while Bitbucket starts up.
Launching Bitbucket ...

Installation of Bitbucket 8.2.0 is complete
Your installation of Bitbucket 8.2.0 is now ready and can be accessed via
your browser.
Bitbucket 8.2.0 can be accessed at http://localhost:7990
Launch Bitbucket 8.2.0 in browser?
Yes [y, Enter], No [n]
y
Finishing installation ...

NOTE:

Please note that if you have any security or firewall running in your system then you need to allow HTTP Port 7990 and TCP Ports 7992 and 7993 through it so that it can be used by Bitbucket application.

 

Step 6: Setup Bitbucket

Once the Server is successfully installed, you can start setting it up by accessing it through the browser using URL http://localhost:7990 as shown below.

How to Install Bitbucket on Linux Using 7 Simple Steps 3

At the setup page, you need to select the preferred Language and then select Internal Database for using Bitbucket for evaluation and demo purposes and then click on Next. It will initialize the database.

How to Install Bitbucket on Linux Using 7 Simple Steps 4

Next step is to generate an evaluation license. For that you need to setup an Atlassian account and then login using the same. You can click on Create an account as shown below to setup your account.

How to Install Bitbucket on Linux Using 7 Simple Steps 5

Once you created and logged in to your account, it will automatically detect the current running instance and other details as shown below. You just need to click on Generate License.

How to Install Bitbucket on Linux Using 7 Simple Steps 6

 

How to Install Bitbucket on Linux Using 7 Simple Steps 7

In the next screen you can check your trial License Key generated for Bitbucket Server as shown below.

How to Install Bitbucket on Linux Using 7 Simple Steps 8

Then click on yes to confirm and install the License key on the localhost Server.

How to Install Bitbucket on Linux Using 7 Simple Steps 9

After confirming all the the details, Click on Next.

How to Install Bitbucket on Linux Using 7 Simple Steps 10

After setting up the administrator account. You can either Integrate with JIRA or click on Go to Bitbucket to login using administrator account.

How to Install Bitbucket on Linux Using 7 Simple Steps 11

You will be redirected to login page where you need to enter your administrator username and password just created. Then click on Log In.

How to Install Bitbucket on Linux Using 7 Simple Steps 12

After providing valid credentials, you will be logged in successfully as shown below.

How to Install Bitbucket on Linux Using 7 Simple Steps 13

 

Stop 7: Stop/Start Bitbucket

Once you are done with Bitbucket, you can choose to stop the application by running stop script stored in $HOME/atlassian/bitbucket/8.2.0/bin/ directory.

cyberithub@ubuntu:~$ cd atlassian/bitbucket/8.2.0/bin
cyberithub@ubuntu:~/atlassian/bitbucket/8.2.0/bin$ ./stop-bitbucket.sh
Stopping Atlassian Bitbucket as the current user

Stopping Bitbucket webapp
The Bitbucket webapp has stopped

Stopping the bundled search server
The bundled search server has stopped

Similarly, if you again want to start the Bitbucket application then you need to run the start script stored in $HOME/atlassian/bitbucket/8.2.0/bin directory.

cyberithub@ubuntu:~/atlassian/bitbucket/8.2.0/bin$ ./start-bitbucket.sh
Starting Atlassian Bitbucket as the current user

Starting the bundled search server
Hint: Run start-bitbucket.sh --no-search to skip starting the bundled search server
future versions of OpenSearch will require Java 11; your Java version from [/home/cyberithub/atlassian/bitbucket/8.2.0/jre] does not meet this requirement
future versions of OpenSearch will require Java 11; your Java version from [/home/cyberithub/atlassian/bitbucket/8.2.0/jre] does not meet this requirement
Bundled search server started successfully

Bitbucket is being run with a umask that contains potentially unsafe settings.
The following issues were found with the mask "u=rwx,g=rwx,o=rx" (0002):
- Access is allowed to 'others'. It is recommended that 'others' be denied
all access for security reasons.
- Write access is allowed to 'group'. It is recommend that 'group' be
denied write access. Read access to a restricted group is recommended
to allow access to the logs.
The recommended umask for Bitbucket is "u=,g=w,o=rwx" (0027) and can be
configured in _start-webapp.sh

The current open files limit is set to less than 6192
Attempting to increase limit...
Limit increased to 6192 open files

Starting Bitbucket webapp at http://localhost:7990
The Bitbucket webapp has been started.

If you cannot access Bitbucket within 3 minutes, or encounter other issues, check the troubleshooting guide at:
https://go.atlassian.com/bbs-troubleshooting-installations

Leave a Comment