Debian Installation

Document created by resplin Employee on Jun 6, 2015
Version 1Show Document
  • View in full screen mode

Obsolete Pages{{Obsolete}}

The official documentation is at:

Installing Alfresco 2.x Community on Debian. (for 3.x, see [])

This tutorial will help you install a clean Alfresco 2.x Community on a Linux Debian system without Graphical User Interface.
By following this tutorial you will have a Alfresco system up & running in 1 hour!

I used 'debian-40r1-i386-netinst' for the installation of Debian.

After the installation of Debian you will have to update your system to the latest version.
You can do this easily with the command:
apt-get update

When this command has finished doing it's work you can execute this command:
apt-get upgrade

Confirm with Y so it will install, when the installation is done you can reboot the system to let the changes take effect.

Alfresco Installation

First we need a few applications we will use the apt-get command for this again:

apt-get install openssh-server apache2 xvfb xfonts-base

Confirm with Y so it will install.
When the installation of these programs is done you should edit the OpenOffice Registration file which is located in:


Use your favorite editor to modify the Common.xcu (I used pico).

Find this line (which is between <value></value>): and remove it.

Save the file when you have removed this URL.

Creating the Alfresco directory

Go to /opt/ and create a directory by using the mkdir command:

mkdir alfresco

When you have done this go into this directory.

Now use WGET to fetch Alfresco Community from the webpage.
The Alfresco Community packages can be found on:

The file we downloaded was: alfresco-community-tomcat-2.1.0.tar.gz


Once you have downloaded the .tar.gz into /opt/alfresco/ it is time to extract it.
You can do this by entering this command:

tar -zxvf alfresco-community-tomcat-2.1.0.tar.gz

Downloading & Installing java

We need the Java runtime to make Alfresco work ;) Which is available from:

First we are going to create a new directory in /usr/
We called it 'java'

Use the mkdir command to make this directory. When this is done go into this directory.
Again use WGET to fetch java from the website. The package you will need is:
Linux (self-extracting file)

When the file is downloaded you need to chmod it.
You can do this by entering this command:

chmod +x jre-6u3-linux-i586.bin

(the filename may differ we downloaded the 6u3 version)

Once you have chmodded the file you execute it by adding ./ infront of the filename.. like this:


You will see a license agreement and you just have to agree with it on the end.
Java is now installed!

Adding JAVA Export into startup file from Alfresco

This file is located in /opt/alfresco/ The file is named
Edit it with your favorite editor (I used pico)
Find this line:

# Set any default JVM values

and add this under it:

export JAVA_HOME=/usr/java/jre1.6.0_03/

NOTE: If you installed a different version of java this might be an incorrect path!!!

Installing MySQL and Configuring Alfresco

We are going to use apt-get again to get the applications we need.

apt-get install mysql-server-5.0 mysql-admin

Once these are installed you enter these commands into the prompt:

connect mysql

Now you are connected into the database of MySQL! You will need to add these priveleges to make Alfresco work you can do this by entering these commands in the MySQL shell:

GRANT ALL PRIVILEGES ON *.* TO 'alfresco'@'localhost' IDENTIFIED BY 'alfresco' WITH GRANT OPTION; 


and exit by typing exit ;)

Creating MySQL Alfresco DB

Go to this directory:


When you are in there you enter this command:

mysql -u root -p