In this guide, I use variables like $CATALINA_HOME. These are pre-set for you in the SmartOS Java image. You can use them like:


... and it will take you to that directory.

Step by Step:

After installing the Java Image, update:

pkgin -fy up

Check and see what your tomcat password is... mine didn't seem to set right when I installed. Note: I locked my self out for 5 minutes b/c I kept trying my other password (5 times). If you do this, you have to wait 5 minutes (or restart your server).

Near the bottom of the file below you will find your tomcat password:

vi $CATALINA_HOME/conf/tomcat-users.xml

Download and unzip confluence (use the most up-to-date link):

cd /opt

Create a good place to stick confluence and stick it here.

mkdir atlassian
mv confluence-5.4.3 atlassian/confluence

Define where the data folder is the create that data folder

vi /opt/atlassian/confluence/confluence/WEB-INF/classes/

##change last line to confluence.home=/opt/atlassian/confluence-data
mkdir /opt/atlassian/confluence-data

Method #1 - Normal "by-atlassian's-book" install

There are 2 methods for showing confluence to the world using confluence in tomcat. This method gives you a url like: You can use this method and mix it with apache/nginx to put confluence on its own domain, or use Method #2 below.

vi $CATALINA_HOME/conf/Catalina/localhost/confluence.xml

The files contents should be like so:

<Context path="/confluence" docBase="/opt/atlassian/confluence/confluence" debug="0" reloadable="true">

Method #2 - Use Tomcat's Virtual Host

This method uses Tomcat Virtual Hosts to define the domain of confluence. If you want to do this step, delete the file you made in Method #1.

This will easily let you have confluence on the root of its own domain (like:


Edit $CATALINIA_HOME/conf/server.xml and add the following below the last closing Host.

<Host name="" appBase="webapps" unpackWARs="false" autoDeploy="true">
  <Context path="" docBase="/opt/atlassian/confluence/confluence" debug="0" reloadable="true">

tomcat needs access

chown -R tomcat:tomcat /opt/atlassian

set the memory on the server NOT SURE IF THIS IS NESSISARY


Add the line below and set Xmx to a memory that you think is good (I always just do about 70-80% my server memory):

JAVA_OPTS="-Xms256m -Xmx1024m -XX:MaxPermSize=256m"

Get the java mysql driver


Download, unzip and copy to the right location (use the latest java link, not the one below):

cd /opt
tar zxvf mysql-connector-java-5.1.29.tar.gz
cp mysql-connector-java-5.1.29/mysql-connector-java-5.1.29-bin.jar $CATALINA_HOME/lib/
rm -r mysql-connector-java-5.1.29

Restart tomcat (I just rebooted the whole server/zone).

reboot #to reboot the whole server


svcadm restart tomcat #Restart tomcat

If you used method #1 - login to http://yourtomcatdomainORip/confluence/
If you sued method #2 - login at the domain you set

Setting up Mysql database:

See my post on setting up a remote database using the percona smartos image.

Last tip: when going through the confluence web install. Set your database to directly connect, and the the "database url" will be:

jdbc:mysql://<host>/<database name>