Installing Atlassian Forge on Ubuntu 20.04

Introduction

This tutorial provides a comprehensive guide to installing Atlassian Forge on Ubuntu 20.04. Given that Forge can present challenges on this operating system, this step-by-step approach will help you navigate the installation process, ensuring all dependencies are correctly set up for a smooth development experience.

Step 1: Update Your System

Before installing any new software, it's essential to update your package list and upgrade existing packages.

1. Open your terminal.
2. Run the following commands:

   sudo apt update
   sudo apt upgrade -y
   

Step 2: Install Required Dependencies

Atlassian Forge requires specific dependencies to function properly.

1. Install Node.js and npm (Node Package Manager):

   sudo apt install nodejs npm -y
   

2. Verify the installations:

   node -v
   npm -v
   

3. Install additional tools:

   sudo apt install git curl -y
   

Step 3: Install Yarn Package Manager

Yarn is needed for managing packages effectively in your Forge applications.

1. First, configure the Yarn repository:

   curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
   echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
   

2. Update your package list again:

   sudo apt update
   

3. Install Yarn:

   sudo apt install yarn -y
   

Step 4: Install Atlassian Forge CLI

The Forge command-line interface (CLI) is essential for creating and managing Forge applications.

1. Run the following command to install the Forge CLI:

   npm install -g @forge/cli
   

2. Verify the installation:

   forge --version
   

Step 5: Log in to Atlassian Forge

After installing the Forge CLI, you need to log in to your Atlassian account.

1. Execute the following command:

   forge login
   

2. Follow the prompts to authenticate your account.

Step 6: Create Your First Forge Application

Now that Forge is installed, you can create your first application.

1. Use the following command to create a new Forge app:

   forge create
   

2. Follow the instructions to set up your app. Choose a name and template as prompted.

Conclusion

In this tutorial, you successfully installed Atlassian Forge on Ubuntu 20.04, including all necessary dependencies. You also learned how to log in and create your first application.

For further development, consider exploring the Atlassian Forge documentation to enhance your knowledge and capabilities. Happy coding!