How do I set up Jira as a subdomain?

[Aneez Zahra]

My company example.com is hosted at route53. How to add Jira as a subdomain of exapmle.com? like jira.example.com

[Prince Nyeche]

If you do not have Jira Installed

To do so, you will require a Static IP if using EC2 to prevent the Public DNS from changing anytime the instance is restarted. Then spin up a linux server instance on EC2 and RDS where you can host Jira and configure Apache proxy to run on Jira and later on your database. If you're using other hosts, then it's better you Install Jira there and have Apache installed or nginx either one will do the trick.

The other steps would require you changing the config file of Apache (i.e if Apache is used) and write up a virtual host configuration to link access of your Jira to your domain, you can see the steps here on configuring proxies.

Finally, you can then setup your subdomain using a CNAME routed to the EC2 Public DNS (if using AWS EC2 Instances).

If you have Jira Installed and active on some other Host

Simply use a CNAME in your route53 registered domain name as (jira.example.com) and route it to your active Jira Installation Public DNS. Usually when adding a CNAME record, it will ask for the "Name" which should be the subdomain jira.example.com. and a "CNAME" which should point to your Public DNS (where Jira lives e.g example.com)

[Aneez Zahra]

Jira is already running on Ec2 Linux server and we have set a static IP also. Company TLD is hosted on Route53.

[Prince Nyeche]

Then on your linux server, ensure you've installed Apache, you can do so by running

sudo su
apt-get install apache2 -y

You should then add a virtual host to the apache default conf file and nano into /etc/apache2/sites-available/000-default.conf to add the below configuration

<VirtualHost *:80> 
ServerName sub.example.com
 
ProxyRequests Off 
ProxyVia Off
 
<Proxy *> 
     Require all granted 
</Proxy> 

ProxyPass / http://localhost:8080/ 
ProxyPassReverse / http://localhost:8080/ 
</VirtualHost>

 ServerName should include the subdomain you want to use from your domain.

Other steps would involve you changing and uncommenting the HTTP or HTTPS Apache proxy Connector (depending if you want to use SSL or not) in your  /opt/atlassian/jira/conf/server.xml - given that you used the default installation directory.

After that you can change the CNAME in your domain on route53.

[Prince Nyeche]

P/S: Also I should have asked if its ubuntu or another linux version as the above is for ubuntu with apache. if you're using Amazon linux with apache installed, you should nano into /etc/httpd/conf/httpd.conf instead and set the virtual host there.