Step-by-Step Guide to Installing and Configuring Atlassian Jira Server on Linux

Server and Data Center products are undergoing major changes, with new Server licenses ending on 2021‑02‑02 and support ending on 2024‑02‑02, meaning Jira will primarily be offered as SaaS or Data Center versions.

1. Download the software package

Visit the official Atlassian download page, accept the license agreement, and select the desired version (or a historical version if needed). After downloading, you obtain an executable .bin file that must be uploaded to the target server, along with the Atlassian agent for learning purposes only.

scp atlassian-jira-software-8.13.2-x64.bin [email protected]:/root
ssh 182.168.1.200
wget https://gitee.com/pengzhile/atlassian-agent/attach_files/283101/download/atlassian-agent-v1.2.3.tar.gz
# You will see two files
atlassian-agent-v1.2.3.tar.gz  atlassian-jira-software-8.13.2-x64.bin
chmod +x atlassian-jira-software-8.13.2-x64.bin
./atlassian-jira-software-8.13.2-x64.bin

2. Create the PostgreSQL database

CREATE USER jiraadmin WITH PASSWORD 'password';
CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;
GRANT ALL PRIVILEGES ON DATABASE jiradb TO jiraadmin;

3. Start the installation

[root@zeyang-nuc-service jira]# ./atlassian-jira-software-8.13.2-x64.bin
Unpacking JRE ...
Starting Installer ...
... (follow prompts, choose Express Install)
Installation Directory: /opt/atlassian/jira
Home Directory: /var/atlassian/application-data/jira
HTTP Port: 8080
RMI Port: 8005
Install as service: Yes
... Installation complete ...
Start Jira Software 8.13.2 now? [y, Enter]
Launching Jira Software ...
Jira Software 8.13.2 can be accessed at http://localhost:8080

Open the required firewall port:

firewall-cmd --add-port=8080/tcp --permanent
systemctl reload firewalld
firewall-cmd --list-all

After the first start, a license error appears. To fix it, add the Atlassian agent JAR to the JVM options.

systemctl stop jira
cd /
tar zxf atlassian-agent-v1.2.3.tar.gz
mv atlassian-agent-v1.2.3/atlassian-agent.jar /opt/atlassian/
# Edit /opt/atlassian/jira/bin/setenv.sh
# Add the following line
export JAVA_OPTS="-javaagent:/opt/atlassian/atlassian-agent.jar ${JAVA_OPTS}"

Start Jira again:

systemctl start jira

4. Initial configuration

Access the web UI, configure the database connection, verify the connection, and proceed through the setup wizard to set site information and register the license.

[root@zeyang-nuc-service atlassian]# java -jar atlassian-agent.jar -d -m [email protected] -n JIRA -p jira -o http://192.168.1.200:8080 -s BRTQ-XNWS-FZVU-9DZR
... (license code output) ...

Copy the generated license code into the Jira license field, complete registration, and begin using Jira.

For more details, refer to the official documentation: Connecting Jira Applications to PostgreSQL .