Step by step guide to setting up Jfrog artifactory on Amazon Linux server.
JFrog Artifactory is a powerful repository manager that supports various package formats and helps manage your binary artifacts efficiently. Setting it up on an Amazon Linux server is straightforward. This guide will walk you through the entire process, from launching your server to getting Artifactory up and running.
Prerequisites
Before you begin, ensure you have the following:
- AWS Account: You need access to create an EC2 instance.
- Basic Linux Knowledge: Familiarity with the command line will help.
- Java: Artifactory requires Java; we’ll install that during the setup.
Before we begin, there are several methods for installation, including Debian, RPM, Linux Archive, Helm Chart, and Docker Compose. For this guide, we’ll be using the RPM method, as Amazon Linux is based on the RPM distribution.
Step 1: Launch an Amazon EC2 Instance
- Sign in to your AWS Management Console.
- Navigate to the EC2 Dashboard.
- Click on Launch Instance.
- Choose an Amazon Machine Image (AMI): Select Amazon Linux 2 AMI.
- Choose an Instance Type: A
t2.medium
instance is more suitable for this tutorial. You can usedt2.micro
for small sized projects and testing. - Configure Instance Details: You can leave the default settings, but ensure you have a public IP enabled.
- Click on Keypair to create a new keypair as this will be used for our terminal to gain SSH access into the server.
- Add Storage: The default 8 GB is might not be sufficient for this tutorial, I will advise you use 15 GB instead.
- Configure Security Group: Create a new security group or use an existing one. Ensure you allow these ports:
- SSH (port 22)
- HTTP (port 80)
- HTTPS (port 443)
- Custom TCP Rule for Artifactory (port 8081–8082)
7. Review and Launch: Click on Launch Instances .
Step 2: Connect to Your EC2 Instance
Once your instance is running:
- Open your terminal.
- Use SSH to connect to your instance on your terminal using the command below
ssh -i /path/to/your-key.pem ec2-user@your-instance-public-ip
I use MobaXterm, this is a powerful terminal emulator for Windows that provides a variety of tools, including: SSH Client: For secure remote access.
As you can see above, i have connected to my MobaXterm terminal to my terminal and the connection was successful.
Step 3: Install Java
Artifactory requires Java. Here’s how to install it, we’d be using :
sudo yum update -y
sudo yum install java-1.8* -y
You can verify the installation with:
java -version
Here is the output of the command, it shows the version as well as the runtime environment.
Step 4: Download and Install JFrog Artifactory
- Navigate to the JFrog Artifactory download page to find the latest version.
- Use
cd /opt/
to move to the/opt/
directory. Downloading JFrog Artifactory in this directory is common practice as the/opt
directory is traditionally used for installing third-party software and applications that are not part of the default system installation. This helps keep the filesystem organized. - Use
wget
to download Artifactory:
sudo wget https://jfrog.bintray.com/artifactory/jfrog-artifactory-oss-6.9.6.zip
4. Unzip the downloaded file:
sudo yum install unzip -y
sudo unzip jfrog-artifactory-oss-6.9.6.zip
After unzipping the file, you can get rid of the zipped file.
Step 5: Start Artifactory
- Navigate to the Artifactory installation directory:
cd /opt/jfrog-artifactory-oss-6.9.6/app/bin
2. Start Artifactory:
sudo ./artifactory.sh start
Step 6: Access Artifactory
Open your web browser and navigate to:
http://your-instance-public-ip:8081/artifactory
Voila!!! Congratulation! you should see the picture below.
The default username and password for the built-in administrator user in JFrog Artifactory are “admin” and “password”. It is highly recommended to change the password after logging in for the first time.
Should you have any further question regarding this, please leave a comment and I'll respond.
Thank you!