How to Install DSpace on Windows 10

DSpace is an open source software for managing digital assets (including documents, images, and videos) in a digital repository. In this tutorial, we will guide you through the installation process of DSpace on Windows 10.

Prerequisites

Before we begin, make sure you have the following:

  • Windows 10 (64-bit recommended)
  • Java Development Kit (JDK) 8 or higher
  • PostgreSQL 9.6 or higher
  • Apache Maven 3.5 or higher

Make sure you have administrative privileges to install software on your system.

Step 1: Download DSpace

Visit the official DSpace website at https://duraspace.org/dspace/ and navigate to the download page. Select the latest stable release and download the binary distribution package (.zip file).

Step 2: Install JDK

If you don't have JDK installed on your system, go to the official Oracle website and download the latest version. Follow the instructions to install JDK on your system.

Step 3: Install PostgreSQL

Download PostgreSQL from the official website and install it on your system. During installation, set a password for the default user (postgres).

Step 4: Create a Database for DSpace

DSpace requires a PostgreSQL database to store its data. Use the following steps to create a database:

  1. Open the PGAdmin application that comes with PostgreSQL.
  2. Log in using the default user (postgres) and the password you set during installation.
  3. Right-click on "Databases" and select "New Database".
  4. Give a name for the database (e.g. "dspace") and click "Save".

Step 5: Install Apache Maven

Download Apache Maven from the official website and install it on your system. Follow the instructions to install Maven.

Step 6: Extract DSpace Package

Extract the downloaded DSpace package to a directory of your choice (e.g. "C:\dspace").

Step 7: Configure DSpace

DSpace provides a configuration file that needs to be modified according to your system configuration. Use the following steps to configure DSpace:

  1. Navigate to the "dspace/config" directory.
  2. Rename the file "dspace.cfg.EXAMPLE" to "dspace.cfg".
  3. Open the "dspace.cfg" file in a text editor.
  4. Set the PostgreSQL connection parameters (database name, username, and password).
  5. Set the mail server configuration if you want to receive system notifications.
  6. Save the file.

Step 8: Build DSpace

Use the following steps to build DSpace:

  1. Open a command prompt and navigate to the "dspace" directory.
  2. Run the command "mvn package". This will build DSpace and create a WAR file.

Step 9: Deploy DSpace

Use the following steps to deploy DSpace:

  1. Navigate to the "dspace/target" directory.
  2. Copy the "dspace.war" file to the "webapps" directory of Tomcat (e.g. "C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps").
  3. Start Tomcat using the command "startup.bat" in the "bin" directory of Tomcat.

Step 10: Access DSpace

Open a web browser and go to http://localhost:8080/xmlui/. You should see the DSpace home page. If you see a login screen, enter "dspace@localhost" as the email address and "dspace" as the password.

Congratulations! You have successfully installed DSpace on Windows 10.