DSpace – Repository Software

Installing DSpace 5.5 on Lubuntu/Ubuntu 14.04 LTS:

Open Applications > Accessories > Terminal and execute following commands. / press Ctrl+Alt+T


        Login as root.

        Enter the following command:

        library@localhost# sudo su (hit enter)

        Enter Password


Execute the following commands in order (One after another):

  • Update the Ubuntu: apt-get update
  • Install OpenJDK: apt-get install openjdk-7-jdk
  • Install Apache Maven and Apache ant: apt-get install ant maven
  • Install RDBMS – PostgreSQL: apt-get install postgresql
  • Install Tomcat (Web Server): apt-get install tomcat7

·         Install Default JDK: apt-get install default-jdk


Create user and directory as ‘dspace’:

useradd -m dspace

passwd dspace [enter a password for the new user dspace]

mkdir /dspace

chown dspace /dspace


Create the PostgreSQL “dspace” user

Log in to postgresql:

sudo su postgres

Let’s create database and user (both) with the name ‘dspace’ and password as ‘dspace’

Important Note: Database user is different compared to normal user. Both the users are different in nature.

Your prompt will change once you run the above command (sudo su postgres) then run the following command:

createuser -U postgres -d -A -P dspace

Enter password for new role: Enter password as dsapce

Enter it again: Re-enter password as dspace

Choose the below in order, if it appears on the screen.

Shall the new role be allowed to create more new roles? (y/n) y

Answer “y” for yes.

Than type exit and come to root

Once, you type the exit command, you will get back to root prompt:


Now, make changes in the following file and add the lines mentioned below.

You can use any editor for making changes.

For Server always use either ‘nano’ or ‘vi’

For Desktop always use either ‘gedit’ or ‘leafpad’

root@localhost# gedit /etc/postgresql/9.3/main/pg_hba.conf

Add the following line shown in red color at last of the file.

local     all       dspace        md5

Type the following to restart:

/etc/init.d/postgresql restart


root@localhost# service postgresql restart


Create the database in PostgreSQL with the name ‘dspace’

Login as:

sudo su dspace

dspace@localhost# createdb -U dspace -E UNICODE dspace

Than type exit and come to root


Restart the PostgreSQL Server:

/etc/init.d/postgresql restart


service postgresql restart


Create ‘build’ directory to download the software:

mkdir /build

chmod -R 777 /build

cd /build


Download DSpace to /build directory

Run the following command at command prompt to download the software from repository:

Important: Make sure, Internet is working.

root@localhost# cd /build

root@localhost/build# wget https://github.com/DSpace/DSpace/releases/download/dspace-5.5/dspace-5.5-src-release.tar.gz

root@localhost/build# tar -zxf dspace-5.5-src-release.tar.gz

root@localhost/build# cd dspace-5.5-src-release

root@localhost/build/dspace-5.5-src-release# mvn -fn package


Important Note: Once you run the ‘mvn -fn package’ command, it will start downloading the maven packages and it may take hours together to complete. Once completed, it will show build successful. Now, run the following command one after another.

root@localhost/build/dspace-5.5-src-release# cd dspace/target/dspace-installer

root@localhost/build/dspace-5.5-src-release/target/dspace-installer# ant fresh_install


Configure Tomcat Server:

Open the ‘server.xml’ file from /etc/tomcat7/server.xml with any editor. (nano or gedit)

root@localhost# gedit /etc/tomcat7/server.xml


Add the following lines at the bottom of the file before </Host> in the file.

<!–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=”/solr” docBase=”/dspace/webapps/solr” allowLinking=”true”/>

Then save close the file.

Step-9: Change the Tomcat Permission and restart the Tomcat Server.

You can use the following command at terminal to issue permission.

root@localhost# chown tomcat7:tomcat7 /dspace -R

Restart Tomcat

root@localhost# /etc/init.d/tomcat7 restart


root@localhost# service tomcat7 restart


Make an initial administrator in DSpace:

root@localhost# /dspace/bin/dspace create-administrator

When you run this command, it may ask you to enter email address.

Please note this email ID is your user ID which you may be using to login as an Administrator.

Enter your genuine e-mail ID as you may receive emails on this ID, if DSpace has any problem in future subject the email configuration in the DSpace.

Then Enter First

Then Enter Surname

Enter a password.

It will create the User ID and Password.


DSpace has two interfaces (jspui and xmlui)

To see the Interface, open the browser and type the following in address bar.





  1. https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS
  2. https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace
Is this Page useful? Useful Useless 7 of 10 people say this Page is useful.