Installing DSpace 4.x on Ubuntu 12.04/14.04 LTS

[This installation document is obsoleted. Please visit for latest Dspace installation steps.]

Installation of prerequisite applications

Open  Applications > Accessories > Terminal and execute following commands. Text in italics are the commands to be executed.

apt-get install leafpad
sudo apt-get install openjdk-7-jdk
sudo apt-get install postgresql
sudo apt-get install tomcat7
sudo apt-get install ant maven

Create the database user

sudo su postgres
createuser -U postgres -d -A -P dspace

Enter password for new role: [Enter a password e.g. dspace]
Shall the new role be allowed to create more new roles? (y/n) n
[Enter n and press enter button]

Type exit

Allow the database user (dspace) to connect to the database
[If the following command not open, check the Postgresql version number and apply in the command]

sudo leafpad /etc/postgresql/9.3/main/pg_hba.conf

Add this line to the configuration file at the end: 

local all dspace md5

save and close the file

Restart PostgreSQL :

sudo su
/etc/init.d/postgresql restart

Create Dspace user

sudo useradd -m dspace
sudo passwd dspace
[enter a password for the new user dspace]
sudo mkdir /dspace
sudo chown dspace /dspace

Create the PostgreSQL 'dspace' database

sudo -u dspace createdb -U dspace -E UNICODE dspace 

Configure Tomcat
[If the following command not open, check the tomcat version number and apply in the command]

sudo leafpad /etc/tomcat7/server.xml

Insert the following chunk of text just above the closing </Host>

<!-- Define a new context path for all DSpace web apps -->
<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="/jspui" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

save and close  the file.

Create Dspace directory

sudo mkdir /build
sudo chmod -R 777 /build
cd /build

Download Dsapce to /build directory
You can check latest version of Dspace from here.
Copy paste following line in the terminal,


Extracting Dspace package

tar -zxf dspace-4.2-src-release.tar.gz
cd /build/dspace-4.2-src-release
mvn -U package 

Enter into Dspace package folder to download packages.

cd dspace/target/dspace-4.2-build
sudo ant fresh_install

Fix Tomcat permissions, and restart the Tomcat server
sudo chown tomcat7:tomcat7 /dspace -R

Restart Tomcat

/etc/init.d/tomcat7 restart

Make an initial administrator account (an e-person) in DSpace:
/dspace/bin/dspace create-administrator

It will ask to enter email address for user login.
Enter an email address (e.g. dspace@localhost).
Enter First name and surename (e.g. dspace)
Enter a password.

Open Dspace in your browser
You can load either one Dspace interface in a browser.




  1. sir,

    How to add header text at Dspace JSPUI in 4.x.
    in previous version (1.8) it is easy to add.
    but in new version I could not understand how to add.
    please help in this matter.

    thank you

  2. Are the steps used here the same when installing dspace 5.x. Is it possible to customize dspace 5.x

  3. are the steps used here the same when installing dspace 5x


  4. There are some slight differences

    Please check the DSpace Community page or the dspace 5x documentation page for further instructions.

    For example, there is no need the enter the stated chunk of text in the .../server.xml/, file. However, you have to set the proxy and host in the .../server.xml/ in order to proceed to the build section.

  5. hi
    I have manage to install dspace 4.x on ubuntu 12.04 lts desktop in virtualbox. however I cannot access in on another PC when I entered http://localhost:8080/xmlui. any suggestion

  6. managed to install, but how do I customize dspace 4.x headers

  7. tomcat fail to restart and failed to identify the problem anyone help me?

  8. very helpful tutorial but I'm stuck
    [command no found]

    I'm Using Debian 8 Jessie

  9. Replies
    1. Please visit for latest Dspace installation steps.

  10. In the last step i.e. /dspace# /bin/dspace create-administrator I found
    error :- bash: /bin/dspace: No such file or directory

    and http://localhost:8080/xmlui
    not opening any pages with HTTP Status 404 - /xmlui error