Article Index


In this small post, you will learn how to install Atlassian Confluence in no more than 15 minutes. It do not replace the online installations manual (The Confluence Installation Guide is for people who are installing Confluence for the first time. Check the requirements and supported platforms, then download and install Confluence), but mainly complement it, with some of the best Linux practices (ADDED points).





How to install Atlassian Confluence in 15 minutes

Create user and user group

ADDED: Better run these web applications with their own user group and user for more security…This is not required, but follow Linux best practices, thus highly recommended.

The groupadd command creates a new group account using the values specified on the command line and the default values from the system.

# groupadd confluence

The useradd command allow a super user or root to create a new user or updates default new user information.

# useradd -g confluence -c 'confluence user for confluence' -m confluence

Be that user, for all next operations

# su – confluence

You are now in the new home of user confluence.

/home/confluence /#

Install Confuence

Get the latest standalone version

# wget

Unpack it

# tar –xvf confluence-3.1.1-std.tar.gz

ADDED: To avoid having version number and make software updates easier, create a symbolic link (symlink). This will avoid to have in all your scripts a reference to the version number, thus keeping them more or less generic.

# ln –s /home/confluence/confluence-3.1.1-std /home/confluence/confluence

Customization of profile

ADDED: I do not like to type too much, that why all server where I went are full of aliases. This help also other developers to locate quickly interesting functions on the system.

# cd

Open the Bashrc and put at the end

# vi .bashrc

At least these 4 alias, you are free to define more. Think also that they may be seen as documentation.

alias rel='cd /home/confluence/confluence/'
alias logs='tail -F /home/confluence/confluence/logs/*'
alias cstart='/home/confluence/confluence/bin/'
alias cstop='/home/confluence/confluence/bin/'

To make you life easier, you’ll be able now to start and stop Confluence by issuing a cstart or cstop, watch logs by typing logs

Prepare database configuration

Go to confluence home

# cd

If you are using MySQL (most of the time you are), you’ll have to get the driver from internet due to licensing issues

# wget

Install unzip if not available on your system

# apt-get install unzip

Unpack drivers in current directory

# unzip

Search the driver file. I do this to avoid searching or typing for it

# find /home/confluence/ -name mysql*.jar

This should return something like mysql-connector-java-5.1.10/mysql-connector-java-5.1.10-bin.jar.

Copy this drivers into tomcat shared lib, aka into /home/confluence/confluence/lib

# cp mysql-connector-java-5.1.10/mysql-connector-java-5.1.10-bin.jar /home/confluence/confluence/lib

Create new database schema and user

# mysql –u root –p
mysql> create database confluence character set utf8;
mysql> CREATE USER 'confluence'@'localhost'
        IDENTIFIED BY 'xxxxxxxxxx';

mysql> GRANT ALL PRIVILEGES ON confluence
        TO 'confluence'@'localhost' WITH GRANT OPTION;

Configure Confluence to connect to this new database

Open /home/confluence/confluence/conf/server.xml and add in yellow the configuration for your database.

validationQuery="select 1" />

Start Confluence

Issue a

# cstart; logs

and check logs to see if there is no fatal error occurring before visiting your browser http://yourserverIP:8081/confluence to continue installation.

Scripts (optional)

Create a new init.d script for Confluence

ADDED: Are for starting and stopping easily Confluence, in a standard way. This is something missing currently in the manuals. Here I present you maybe the most basic script ever made, but its purpose is just to be called later on by a rc.d as you will see later.

# vi /etc/init.d/confluence

And place inside the following



start() { 
su -l confluence -c '/home/confluence/confluence/bin/' 

stop() { 
su -l confluence -c '/home/confluence/confluence/bin/' 

status() { 
echo "not implemented" 

findShutdownPort() { 
SHUTDOWN_PORT=`netstat -vatn|grep LISTEN|grep $NORMAL_PORT|wc –l` 

case "$1" in 
echo "Usage: $0 {start|stop|restart|redebug|status}" 
exit 1 
exit $RETVAL

# chown u+x /etc/init.d/confluence

Rc.d scripts

ADDED: This will start automatically Confluence in runlevel 5 if machine if ever restarted

# cd /etc/rc5.d

Create a symbolic link to the Init.d script for starting

# ln -s ../init.d/confluence S20confluence

And stopping

# ln -s ../init.d/confluence k20confluence

You might like also

Display the short GIT version hash as build identifier in TeamCity
TeamCity is a Continuous integration and build management server from JetBrains. As the first build step, create a custom script that reads %build.number%, and uses service messages to append the short GIT hash programmatically. Here’s an example using a bash script pasted right into the TeamCity GUI (Runner type: Command Line, Run: Custom Script): GIT_HASH=%build.vcs.number% GIT_HASH_SHORT=$ echo "#teamcity[buildNumber '#$']" &160; …
2028 Days ago
Latest JetBRAINS Teamcity 5 plugin for the Tux Droid
I did refresh the tuxdroid teamcity plugin project a bit on request to Jasper Moltke Nygaard (Danmark ) TeamCity is a Java-based build management and continuous integration server from JetBrains, creators of IntelliJ IDEA and ReSharper With this plugin you can notify your Tux Droid with your TeamCity build results. After login you can find the new notificator Tux Droid in your notification settings. You need your Tux Droid server IP and port to connect your Tux to TeamCity. After …
3350 Days ago
Running Selenium Grid and a set of Remote control as NT services
Selenium has various projects that can be combined with each other to create a robust testing environment. Selenium IDE: a Firefox add-on to record and playback tests in Firefox. Selenium Remote Control: a client/server system to control web browsers locally or on other computers, using almost any programming language and testing framework. Selenium Grid: transparently distribute your tests on multiple machines so that you can run your tests in parallel, cutting down the time required for running in-browser test suites. …
3369 Days ago
No Thumbnail was found
Amazon EC2 and Virtual Agents Take avdantage of cloud computing with TeamCity by putting Build Agents on Amazon EC2. After your Build Agents' AMIs (Amazon Machine Images) are registered, the TeamCity server will account for those virtual machines in its build scheduling and will automatically do a suspend/resume job on them, based on the load and build queue status. Better Support for Maven Version 5.0 has many Maven support improvements under the hood. These include the creation of Maven-based build …
3549 Days ago
Update JetBrains TeamCity in one click
&160; A small script developed to upgrade TeamCity with no or less effort! a very simple script, easily extensible. “TeamCity is a continuous integration and build management system. With TeamCity, you can set up a build server within minutes and enjoy out of the box continuous unit testing, code quality analysis, and early reporting on build problems — even without leaving your favorite IDE. TeamCity offers a gentle learning curve, so you can quickly improve your release management practices by …
3676 Days ago
Adding Google analytics to Atlassian Bamboo
As I found no better tutorial on Internet, here is a very very short how to add Google analytics to Atlassian Bamboo, it require a bit of hacking, and these kind of changes will be lost after each upgrade of Bamboo.. Edit the file webapps/ROOT/start.ftl Now put the usual code you get after creating a new analytics profile just before the </body> …
3764 Days ago
Continuous integration server Bamboo up and running
My Bamboo continuous integration server is now fully functional and available at&160; &160; &160; &160; Remember Atlassian is providing free license for Open Source Projects: Atlassian supports and believes in the Open Source movement - Bamboo utilizes a number of good Open Source components, and Atlassian developers are committers on a large number of Open Source projects. To give back to the open source community (and hopefully improve the quality of those projects!), Bamboo is free for any Open …
3767 Days ago
TeamCity 4.5 up and running
Today JetBrains announces the public availability of TeamCity 4.5, it's award-winning distributed build management and continuous integration tool. With TeamCity, you can set up a build server for your projects within minutes and enjoy out of the box continuous unit testing, code quality analysis, and early reporting on build problems - even without leaving your favorite IDE. TeamCity offers a gentle learning curve, so you can quickly improve your release management practices by gradually adopting its advanced features and capabilities. …
3770 Days ago
Installing JIRA standalone on OpenSuse 11.x/ Plesk 9
JIRA is a proprietary enterprise software product, developed by Atlassian, commonly used for bug tracking, issue tracking, and project management. JIRA is widely deployed within public open source projects and has over 12,000 customers in over 100 countries. Visit my JIRA instance at or; This is now officially my new Tracker. (Thanks to Atlassian for giving me an open source license) …
3777 Days ago
Installing TeamCity standalone on OpenSuse 11.x/ Plesk 9
After fighting many days.. with their container versions (many webapps in the same tomcat with mod_proxy, mod_proxy_ajp), I did install JetBrains TeamCity, Atlassian Jira and Bamboo as standalone on my server. TeamCity is a Java-based build management and continuous integration server from JetBrains, creators of IntelliJ IDEA and ReSharper. &160; What will happen next? TuxDroid for Teamcity plugin will be build there (MAVEN2) the first component for Joomla! will be build there as well (using Maven 4 PHP) …
3777 Days ago