--- title: "BitBucket Tutorial: Your Guide to a Powerful GitHub Alternative" description: "Need a project tool with seamless team workflow? This Bitbucket tutorial will expand your DevOps horizon as it shows you how it simplifies DevOps collaboration." canonical: "https://adamtheautomator.com/bitbucket-tutorial/" --- # BitBucket Tutorial: Your Guide to a Powerful GitHub Alternative > Need a project tool with seamless team workflow? This Bitbucket tutorial will expand your DevOps horizon as it shows you how it simplifies DevOps collaboration. Source: https://adamtheautomator.com/bitbucket-tutorial/ --- ATA Learning Tap to hide [ ATA Learning ](/) * [Home](/) * [Tutorials](/tutorials/) * [Instructors](/author/) * [Advertising](/advertising/) * [Recommended Resources](/resources/) * [About Adam](/about-adam/) Search for: * [](https://twitter.com/adbertram) * [](https://github.com/Adam-the-Automator) * [](https://www.linkedin.com/company/adam-the-automator-llc) * [](/feed/) ![BitBucket Tutorial: Your Guide to a Powerful GitHub Alternative](https://adamtheautomator.com/wp-content/uploads/2022/04/Learn-this-BitBucket-Tutorial-and-Discover-a-GitHub-Alternative.jpg) # BitBucket Tutorial: Your Guide to a Powerful GitHub Alternative [![](https://secure.gravatar.com/avatar/2beb65fca997135120ed98dc6a2e57dcdf1a7d7d2f5ff687b5d91dc7ccd7a6b5?s=192&d=mm&r=g)Sagar](https://adamtheautomator.com/author/shanky-mendiratta/)21 February 20246 min. read Categories: [IT Ops](/category/it-ops/) Tags:[Git](/tag/git/) Table of Contents * [Prerequisites](#prerequisites) * [Installing the Bitbucket Server](#installing-the-bitbucket-server) * [Setting up the Bitbucket Server Configuration](#setting-up-the-bitbucket-server-configuration) * [Creating a New Project and Repository](#creating-a-new-project-and-repository) * [Testing the Bitbucket Server with Git Bash](#testing-the-bitbucket-server-with-git-bash) * [Conclusion](#conclusion) In today’s DevOps space, working with dozens of applications and even more configurations file is the norm. And to manage these artifacts, you’ll need a repository. No one can blame you if the first word you think of is GitHub (that is what we will learn from this BitBucket Tutorial article). Apart from GitHub, [Bitbucket](https://bitbucket.org/product/) is an excellent alternative. Bitbucket allows you to store code or configuration files and collaborate with team members. Bitbucket also integrates well with [Jira](https://www.atlassian.com/software/jira) and [Trello](https://trello.com/) to bring the entire software team to execute a project. In this tutorial, you will learn to install and configure a Bitbucket server on Ubuntu. Set up a new project and repository, and test your Bitbucket instance with Git Bash on Windows. ## Prerequisites This post will be a step-by-step BitBucket tutorial. To follow along, be sure you have the following. * An [Ubuntu 20.04 LTS](https://lists.ubuntu.com/archives/ubuntu-announce/2022-February/000277.html) computer with [OpenJDK JRE](https://ubuntu.com/tutorials/install-jre#2-installing-openjdk-jre) installed. This tutorial should also work with Ubuntu 14.04 LTS and above. Related:[How to Install Ubuntu 20.04 \[Step-by-Step\]](https://adamtheautomator.com/install-ubuntu/) * An Atlassian account. If you don’t have one, [sign up for a free Atlassian account](https://id.atlassian.com/signup?application=mac&continue=https://my.atlassian.com) first. * A Windows 10 computer with Git Bash installed. > Although this tutorial covers Bitbucket on Ubuntu, know that Bitbucket is also available in Windows and other Linux distros. ## Installing the **Bitbucket Server** This tutorial kicks off with installing the Bitbucket Server. Installing Bitbucket is nothing different from installing other packages on your machine, and you only need to run a few Linux commands. To install, follow the below steps. 1\. Log in to your Ubuntu machine using your favorite [SSH](https://adamtheautomator.com/ssh-command-in-linux/) client. Related:[A Windows Guy in a Linux World: Setting up SSH in Linux](https://adamtheautomator.com/ssh-command-in-linux/) 2\. Update your computer’s package repository cache by running the below command. ```bash sudo apt update ``` Related:[Learning Ubuntu Apt Get Through Examples](https://adamtheautomator.com/ubuntu-apt-get/) 3\. Next, run the following commands to create a directory named _/opt/install-bitbucket-demo_ and switch to that directory. This directory will host your Bitbucket installation files. ```bash sudo mkdir /opt/install-bitbucket-demo cd /opt/install-bitbucket-demo ``` ![Creating the Bitbucket tutorial directory](https://adamtheautomator.com/wp-content/uploads/2022/04/image-608.png) Creating the Bitbucket tutorial directory 4\. Now, download the Bitbucket binary file for Linux 64-bit by running the below wget command. > _As of this writing, the latest Bitbucket version is 7.21.0. In the future, you may find the latest download links on the [Bitbucket products download page](https://bitbucket.org/product/download-journey)._ ```powershell sudo wget https://www.atlassian.com/software/stash/downloads/binary/atlassian-bitbucket-7.21.0-x64.bin ``` Wait for the download to finish. The installer size is approximately 496MB, and the download may be complete in a few minutes, depending on your internet speed. ![Downloading the Bitbucket binary file](https://adamtheautomator.com/wp-content/uploads/2022/04/image-609.png) Downloading the Bitbucket binary file 5\. After downloading, turn the binary file into an executable by running the following command. ```powershell # Adding the Execute permission on the binary file sudo chmod a+x atlassian-bitbucket-7.21.0-x64.bin ``` 6\. Run the below command to install the Bitbucket server. > _Starting the Bitbucket installation with sudo creates a dedicated account that will run Bitbucket and allows running Bitbucket as a service._ ```powershell sudo ./atlassian-bitbucket-7.21.0-x64.bin ``` 7\. When the Bitbucket installation wizard prompts you to install or upgrade an instance, press 1, Enter for a new Bitbucket instance installation. ![Choosing to install a new instance](https://adamtheautomator.com/wp-content/uploads/2022/04/image-610.png) Choosing to install a new instance 8\. The wizard asks you What type of instance are you looking to install? Press 1, Enter to Install a Server instance. ![Choosing to install a server instance](https://adamtheautomator.com/wp-content/uploads/2022/04/image-611.png) Choosing to install a server instance 9\. Next, leave the default installation path for Bitbucket (/opt/atlassian/bitbucket/7.21.0\] and press Enter. ![Setting the Bitbucket installation path](https://adamtheautomator.com/wp-content/uploads/2022/04/image-612.png) Setting the Bitbucket installation path 10\. Leave the default home directory (/var/atlassian/application-data/bitbucket) unchanged and press Enter. This directory will host the Bitbucket repositories, plugins, and other data related to Bitbucket. ![Setting the Bitbucket home directory.](https://adamtheautomator.com/wp-content/uploads/2022/04/image-613.png) Setting the Bitbucket home directory. 11\. Accept the default port number (7990) and press Enter on the port number configuration step. ![Setting the Bitbucket port number](https://adamtheautomator.com/wp-content/uploads/2022/04/image-614.png) Setting the Bitbucket port number > _Bitbucket also uses port numbers 7992 and 7993 to run the search server, enabling the search functionality._ 12\. On the Install Bitbucket as a service prompt, press y, Enter. The installer configures Bitbucket to run as a daemon and starts automatically when the computer restarts. ![Choosing to install Bitbucket as a service](https://adamtheautomator.com/wp-content/uploads/2022/04/image-615.png) Choosing to install Bitbucket as a service 13\. Review the Installation summary and press i, Enter to confirm the installation. Wait for the installation to complete, which only takes a few minutes. ![Confirming the Bitbucket installation settings](https://adamtheautomator.com/wp-content/uploads/2022/04/image-616.png) Confirming the Bitbucket installation settings 14\. When the installation is complete, press y, Enter to launch Bitbucket. ![Launching Bitbucket](https://adamtheautomator.com/wp-content/uploads/2022/04/image-617.png) Launching Bitbucket 15\. Finally, press n, Enter to skip launching the browser. ![Skip launching the browser](https://adamtheautomator.com/wp-content/uploads/2022/04/image-618.png) Skip launching the browser ## Setting up the **Bitbucket Server Configuration** So you’ve installed Bitbucket. Excellent! But, there are a few more steps before you start using Bitbucket. Don’t worry. You’ll be doing the Bitbucket setup through the web UI as follows. 1\. Now open your favorite browser and navigate to _HTTP://ipaddressOrHostname:7990,_ and you should see the Bitbucket setup screen as shown below. Select the Language as English and Database as internal, and click on the Next button. ![Choosing the language and database type](https://adamtheautomator.com/wp-content/uploads/2022/04/image-619.png) Choosing the language and database type 2\. Specify the Application title, and the base URL will auto-populate. Next, select the I need an evaluation license option and click on the I have an account button. ![Setting up Licensing and base URL](https://adamtheautomator.com/wp-content/uploads/2022/04/image-620.png) Setting up Licensing and base URL 3\. On the next page, log in to your Atlassian account. Depending on how you registered your account, select the appropriate login option. ![Atlassian account login page](https://adamtheautomator.com/wp-content/uploads/2022/04/image-621.png) Atlassian account login page 4\. Select the following options on the **New Trial License** page and click **Generate License** to generate a 90-day trial license. * Product: **Bitbucket Software**. * License type: **Bitbucket** **Software (Data Center)**. * Organization: <**Your organization name>**. * Your instance: **up and running**. * Server ID: DO NOT CHANGE. The Bitbucket setup automatically populates this field with your server’s Server ID. ![Generating a 90-day trial license for Atlassian Bitbucket](https://adamtheautomator.com/wp-content/uploads/2022/04/image-622.png) Generating a 90-day trial license for Atlassian Bitbucket 5\. Click Yes on the confirmation prompt to install the license key to your Bitbucket server. ![Confirming the license installation](https://adamtheautomator.com/wp-content/uploads/2022/04/image-623.png) Confirming the license installation 6\. Next, set up the administrator account to completely control the Bitbucket server. Enter your registered email address, username, and password, and click on the Go to Bitbucket button. ![Creating the Bitbucket administrator account](https://adamtheautomator.com/wp-content/uploads/2022/04/image-624.png) Creating the Bitbucket administrator account 7\. You should now see the **Welcome to Bitbucket. Let’s get started** page, which means you’ve completed the Bitbucket server setup stage. ## Creating a New Project and Repository You’ve installed Bitbucket and completed the server configuration, including installing a trial license. Your Bitbucket server is now functional, and you are now ready to start creating create projects and repositories. 1\. On the Bitbucket welcome page, click on **Projects**. ![Bitbucket welcome page](https://adamtheautomator.com/wp-content/uploads/2022/04/image-625.png) Bitbucket welcome page 2\. Now, select the Create project option to create the first project. ![Selecting the Create project Option](https://adamtheautomator.com/wp-content/uploads/2022/04/image-626.png) Selecting the Create project Option 3\. Next, specify the details for your new project. This example project will have the following information: * Project name: **ATA Learning** * Project Key: Automatically populated ( Short form of Project name **AL**) * Description: **This is a new project** * Project avatar: (Optional) Once you’re satisfied with the project details, click **Create project**. ![Specifying the details to create the project](https://adamtheautomator.com/wp-content/uploads/2022/04/image-627.png) Specifying the details to create the project 4\. Once you’ve created the project, you will see that the Project page has no repositories. To make the one, click on Create repository. ![Creating a new repository](https://adamtheautomator.com/wp-content/uploads/2022/04/image-628.png) Creating a new repository 5\. Next, enter the new repository details. This example will create a repository with the below details. * Name: **Repo1**. * Default branch name: **main.** * Description: My First Repository in ATA learning Project Once you’ve filled in the details, click Create repository ![Specifying the new repository details](https://adamtheautomator.com/wp-content/uploads/2022/04/image-629.png) Specifying the new repository details After creating the repository, you will see the new repository (Repo1) on the list. ![Viewing the new repository in ATA Learning Project in bitbucket](https://adamtheautomator.com/wp-content/uploads/2022/04/image-630.png) Viewing the new repository in ATA Learning Project in bitbucket ## Testing the Bitbucket Server with Git Bash You’ve created a new Bitbucket project and repository. Good! But your repository is sitting there doing nothing at this point. Why not put your repository to use next by cloning it and pushing new files. 1\. Firstly, navigate to the **Repositories** drop-down button at the top of the page and select the repository (**Repo1**) that you want to clone. 2\. Next, click on the Settings button —> Repository permissions —> Enable on the repository page. This step will allow you to clone the repository to your local machine. ![Enabling the clone permissions on the Bitbucket repository](https://adamtheautomator.com/wp-content/uploads/2022/04/image-631.png) Enabling the clone permissions on the Bitbucket repository 3\. Now, create a folder on your desktop named _**New folder**_. 4\. Open Git Bash software on your computer and navigate to the _**New folder**_ you created in the previous step. 5\. Execute the [git clone](https://www.atlassian.com/git/tutorials/setting-up-a-repository/git-clone) command to clone the Bitbucket repository. ```powershell git clone http://ipAddressOrHostname:7990/scm/al/repo1.git ``` ![Cloning the repository](https://adamtheautomator.com/wp-content/uploads/2022/04/image-632.png) Cloning the repository 6\. Next, verify if the repository has been cloned successfully by navigating the New folder. As you can see below, the repository has been successfully cloned (repo1) in the _New folder_. ![Verifying the cloned repository](https://adamtheautomator.com/wp-content/uploads/2022/04/image-633.png) Verifying the cloned repository That’s it! Your Bitbucket instance is now working. At this point, you can [add](https://www.atlassian.com/git/tutorials/saving-changes) files to your local repository, [commit](https://www.atlassian.com/git/tutorials/saving-changes/git-commit) the changes, and [push](https://www.atlassian.com/git/tutorials/syncing/git-push) the changes to your Bitbucket repository. ## Conclusion In this tutorial, you learned to install Bitbucket on Ubuntu and configured its initial settings to get started. You also created a project and a repository within, letting you store code and configuration files conveniently for you and your team. Finally, you cloned the Git repository using Git Bash on your local machine. With what you’ve learned in this Bitbucket tutorial, do you think Bitbucket could be an excellent alternative to GitHub for your team? Share this article [Share on X](https://twitter.com/intent/tweet?url=https%3A%2F%2Fadamtheautomator.com%2Fbitbucket-tutorial%2F&text=BitBucket%20Tutorial%3A%20Your%20Guide%20to%20a%20Powerful%20GitHub%20Alternative)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fadamtheautomator.com%2Fbitbucket-tutorial%2F)[Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fadamtheautomator.com%2Fbitbucket-tutorial%2F) ## Related Posts ![](https://adamtheautomator.com/wp-content/uploads/2022/12/bitbucket-api.jpg) ### [Bitbucket API: Boost Your GIT DevOps Productivity](/bitbucket-api/) Discover how the Bitbucket API can elevate your GIT DevOps workflow. Join our tutorial for expert insights and practical applications to enhance productivity. ![](https://adamtheautomator.com/wp-content/uploads/2021/08/How-to-Get-Started-with-Git-Bash-on-Windows.jpg) ### [Getting Started with Git Bash Commands on Windows](/git-bash-commands/) Start your journey with Git and learn about Git Bash commands on Windows and run some basic commands on Git Bash terminal on Windows in this tutorial! ![](https://adamtheautomator.com/wp-content/uploads/publisher/2e05d9c85b2b8184bb24f8beaeb7f165/85751120c0fb4909afa44fc19e072a60152e0de73a44e1bba3c2dc4f2c71b424.webp) ### [SQL Server 2025 Upgrades: Avoid These Breaking Changes](/sql-server-upgrade-breaking-changes/) Avoid SQL Server 2025 upgrade failures. Master the breaking changes in encryption, TDS, and replication before you plan your migration. ## Categories * [IT Ops](/category/it-ops/) * [Cloud](/category/cloud/) * [DevOps](/category/devops/) * [Home Ops](/category/home-ops/) * [Information Security](/category/infosec/) * [Software Development](/category/software-development/) ## Site * [Home](/) * [Tutorials](/tutorials/) * [Instructors](/author/) * [Advertising](/advertising/) * [Recommended Resources](/resources/) * [About Adam](/about-adam/) Copyright 2026© ATA Learning | [Privacy Policy](/privacy/)