Page tree
Skip to end of metadata
Go to start of metadata

Updated Guide Available

An updated guide to Installing DSpace on OSX has been created. See: Install DSpace on OSX (2014)

Reference documentation:

See Installing DSpace on Mac OS X for an newer, less terse version.


  • OSX 10.4 November 2006, Java 1.5, X_Code tools 2.3?
  • These instructions seem to work fine, and are the same for OS X and OS X Server.
  • I don't use the older version of tomcat installed with OS X Server, nor do I attempt to update it.
  • I run tomcat on port 80 and I have not tried to use Apache with tomcat.

Start Here;

  • create a user postgres - use this for your postgres install
  • create a user dspace - use this for both dspace and tomcat
  • Update java With system update (J2RE version 1.5)
  • Install xcode tools. You need it for Ant. Probably other stuff too.
  • Install tomcat5.5 is a good guide - just remember to use the user dspace instead of tomcat. I have only done steps one to three.
  • Create the PostgreSQL 'dspace' user and the 'dspace' database. The key here is to issue each command using sudo as the Unix 'postgres' user:

    sudo -u postgres createuser -U postgres -d -A -P dspace
    sudo -u dspace createdb -U dspace -E UNICODE dspace

If you use the sites above, postgres and tomcat will be in the /usr/local part of your filesystem.

modify /etc/profile as follows;

# System-wide .profile for sh(1)

export PATH

if [ "${BASH-no}" != "no" ]; then
        [ -r /etc/bashrc ] && . /etc/bashrc

#For Tomcat
export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
export CATALINA_HOME=/usr/local/tomcat

export JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"

Open a NEW terminal(so the updates to profile are available) and follow the dspace install instructions.

NOTE: The Manakin DSpace XMLUI works fine (so far), but you will have to update the context.xml to include the location of DSpace config file (dspace.cfg)