How to Install DSpace on macOS

DSpace is a digital repository software used to store and share digital content. In this tutorial, we will guide you through the steps of installing DSpace on macOS.

Prerequisites

  • macOS Mojave or higher
  • Java 8 or higher
  • PostgreSQL database

Step 1: Download and Extract DSpace

  1. Navigate to https://duraspace.org/dspace/ and download the latest stable release of DSpace.

  2. Open the Terminal app on your Mac.

  3. Navigate to the directory where you want to extract DSpace. For example, you can navigate to your home directory by typing the following command:

cd ~

  1. Extract the downloaded file by running the following command:

tar -zxvf ~/Downloads/dspace-6.x-release.tar.gz

Note: Replace 6.x with the version of DSpace you downloaded.

Step 2: Install PostgreSQL

  1. Install PostgreSQL by downloading it from the official PostgreSQL website https://www.postgresql.org/download/macosx/.

  2. Follow the instructions to install PostgreSQL on your Mac.

  3. Create a new database for DSpace by running the following command:

createdb -U postgres -E UNICODE dspace

  1. Set a password for the PostgreSQL user “postgres”:

psql -U postgres

ALTER USER postgres PASSWORD 'newpassword';

  1. Exit out of the PostgreSQL console:

\q

Step 3: Configure DSpace

  1. Navigate to the DSpace directory:

cd dspace-6.x-release

  1. Copy the configuration files by running the following command:

cp dspace/config/dspace.cfg.EXAMPLE dspace/config/dspace.cfg

  1. Edit the dspace.cfg file:

nano dspace/config/dspace.cfg

  1. Update the database settings with your PostgreSQL credentials:
db.url = jdbc:postgresql://localhost:5432/dspace
db.username = postgres
db.password = newpassword

  1. Save and Exit the dspace.cfg file.

  2. Configure the installation by running the following command:

./dspace/bin/dspace configure

Step 4: Build and Install DSpace

  1. Build and install DSpace by running the following commands:
./dspace/bin/dspace build
./dspace/bin/dspace install
  1. Start the DSpace web application by running the following command:

./dspace/bin/dspace start

  1. Verify that DSpace is running by visiting http://localhost:8080/xmlui/ in your web browser.

You have now successfully installed DSpace on macOS. You can now start using DSpace to manage and share your digital content.