Dspace 7 Installation On Windows 10 ✯ [SECURE]

Prerequisites

• Windows 10 (64-bit)
• Java Development Kit (JDK) 11 or higher
• Apache Maven 3.6.3 or higher
• Git 2.20.1 or higher
• PostgreSQL 12 or higher
• Java Runtime Environment (JRE) 11 or higher

Step 1: Install Java Development Kit (JDK)

1. Download the JDK 11 or higher from the official Oracle website: https://www.oracle.com/java/technologies/javase-jdk11-downloads.html
2. Run the installer and follow the prompts to install the JDK.
3. Set the JAVA_HOME environment variable:
   • Right-click on Computer or This PC and select Properties.
   • Click on Advanced system settings on the left side.
   • Click on Environment Variables.
   • Under System Variables, scroll down and find the New button.
   • Enter JAVA_HOME as the variable name and the path to the JDK installation directory (e.g., C:\Program Files\Java\jdk-11.0.7) as the variable value.
   • Click OK to close all the windows.

Step 2: Install Apache Maven

1. Download Apache Maven 3.6.3 or higher from the official Apache website: https://maven.apache.org/download.cgi
2. Extract the downloaded zip file to a directory of your choice (e.g., C:\Program Files\Apache Software Foundation\apache-maven-3.6.3).
3. Set the M2_HOME environment variable:
   • Follow the same steps as in Step 1 to create a new environment variable.
   • Enter M2_HOME as the variable name and the path to the Apache Maven installation directory (e.g., C:\Program Files\Apache Software Foundation\apache-maven-3.6.3) as the variable value.
   • Click OK to close all the windows.
4. Add Maven to the system's PATH:
   • Right-click on Computer or This PC and select Properties.
   • Click on Advanced system settings on the left side.
   • Click on Environment Variables.
   • Under System Variables, scroll down and find the Path variable.
   • Click Edit.
   • Click New and enter the path to the Maven bin directory (e.g., C:\Program Files\Apache Software Foundation\apache-maven-3.6.3\bin).
   • Click OK to close all the windows.

Step 3: Install Git

1. Download Git 2.20.1 or higher from the official Git website: https://git-scm.com/download/win
2. Run the installer and follow the prompts to install Git.
3. Add Git to the system's PATH:
   • Follow the same steps as in Step 2 to add Git to the system's PATH.

Step 4: Install PostgreSQL

1. Download PostgreSQL 12 or higher from the official PostgreSQL website: https://www.postgresql.org/download/
2. Run the installer and follow the prompts to install PostgreSQL.
3. Create a new database and user for DSpace:
   • Open a command prompt and run the following command: psql -U postgres
   • Create a new database: CREATE DATABASE dspace;
   • Create a new user: CREATE ROLE dspace WITH PASSWORD 'dspace';
   • Grant privileges to the new user: GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;
   • Quit the psql shell: \q

Step 5: Clone the DSpace 7 Repository

1. Open a command prompt and navigate to a directory of your choice (e.g., C:\Users\username\Documents).
2. Clone the DSpace 7 repository: git clone https://github.com/DSpace/DSpace.git
3. Change into the cloned repository: cd DSpace

Step 6: Build and Install DSpace 7

1. Build DSpace 7 using Maven: mvn clean package
2. Install DSpace 7: mvn install

Step 7: Configure DSpace 7

1. Create a new configuration file: copy config/dspace.cfg.example config/dspace.cfg
2. Edit the configuration file: notepad config/dspace.cfg
   • Update the database settings:
     • db.name = dspace
     • db.user = dspace
     • db.password = dspace
   • Update the other settings as needed.

Step 8: Run DSpace 7

1. Start the DSpace 7 server: mvn exec:java -Dexec.mainClass="org.dspace.app.launcher.DSpaceLauncher"
2. Access DSpace 7 in your web browser: http://localhost:8080

Congratulations! You have successfully installed DSpace 7 on Windows 10.

This guide follows a production-inspired setup using the recommended approach: Backend (REST API) + Frontend (Angular UI) , running locally. We'll use PostgreSQL, Tomcat 9, and Node.js.

4. Test backend

Open browser: http://localhost:8080/server/
You should see the DSpace REST API HAL browser.

Chapter 2: Building the Backend (REST API)

We build DSpace from source (only way for Windows).

4. Run Angular dev server

npm start

Wait – it compiles. Then open: http://localhost:4000

🎉 You should see the DSpace 7 login page.

Final Running State

After all steps, you have:

• PostgreSQL – running as Windows service
• Tomcat 9 – running, serving REST API on port 8080
• Angular dev server – running on port 4000
• DSpace 7 – fully functional

To stop:

• Ctrl+C in Angular terminal
• Run shutdown.bat in Tomcat bin folder

Alternative: Docker (Easier)

If you just want to test DSpace 7 on Windows 10, Docker is easier:

git clone https://github.com/DSpace/dspace-docker.git
cd dspace-docker
docker-compose -f docker-compose.yml up -d

Access at http://localhost:4000

Installing DSpace 7 on Windows 10 involves setting up a backend (REST API) and a frontend (Angular UI). It requires at least 8–12 GB of RAM for a stable experience. LYRASIS Wiki 1. Install Prerequisites

Ensure these specific versions are installed and added to your System Environment Variables Java JDK 11 or 17 : Required for the backend. Set to your JDK path. Apache Maven 3.5.4+ : Used to build the source code. Add the folder to your Path. Apache Ant 1.10.x+ : Used for the final installation step. PostgreSQL 12–17 : The primary database. Apache Solr 8.11.1+ : Now installed separately from DSpace. Apache Tomcat 9 : The servlet engine for the backend. Node.js & Yarn : Required for building the frontend. LYRASIS Wiki 2. Database Setup or the command line, perform the following: Create User with a password of your choice. Create Database , owned by the user, with Enable pgcrypto : Run the command CREATE EXTENSION pgcrypto; on your new database. LYRASIS Wiki 3. Install Backend (REST API) Download Source DSpace 7 source code and unzip it. dspace/config/local.cfg.EXAMPLE and update your database credentials and dspace.dir : Open a command prompt in the source folder and run mvn package : Navigate to dspace/target/dspace-installer ant fresh_install : Copy the folder from your installation directory (e.g., C:/dspace/webapps/server ) to Tomcat’s Spoken Tutorial 4. Install Frontend (Angular UI) Download Frontend : Unzip the dspace-angular Install Dependencies yarn install in the frontend directory. config/config.prod.yml and set the REST API host and port (typically localhost:8080 yarn build:prod : Start the UI using file for Windows compatibility. 5. Finalization Admin Account : Create your first administrator by running C:/dspace/bin/dspace create-administrator Verification : Access the backend at dspace 7 installation on windows 10

While there are no formal peer-reviewed academic "papers" exclusively dedicated to installing DSpace 7 on Windows 10, there are comprehensive technical guides and studies on the benefits of upgrading to version 7.

DSpace 7 introduces a significant architectural shift, splitting into a Backend (Java-based Server API) and a Frontend (Angular-based User Interface), both of which can be installed on Windows 10. Core Installation Requirements

According to technical documentation from LYRASIS Wiki, the following software must be configured before installing DSpace 7: Java JDK: Version 11 or 17 (OpenJDK or Oracle JDK).

Database: PostgreSQL (Version 11–16 recommended) with a dedicated dspace user and database. Search Engine: Apache Solr (Version 8.11.x).

Servlet Container: Apache Tomcat (Version 9) for the backend. Build Tools: Apache Maven (3.6+) and Apache Ant (1.10+). Frontend Tools: Node.js (v16+) and Yarn. Key Installation Steps for Windows 10

Detailed procedural guides, such as those found on Scribd, outline these primary phases:

Backend Setup: Configure environment variables like JAVA_HOME, install PostgreSQL, and build the DSpace source using Maven (mvn package).

Deployment: Use Ant to install the backend binaries (ant fresh_install) to a directory like C:\dspace and move the server webapp into Tomcat's webapps folder.

Frontend Setup: Install the DSpace-Angular UI using Yarn and configure it to point to the backend's REST API.

Configuration: Update the local.cfg file to reflect your site's URL and database credentials. Recommended Alternative: Docker

For Windows 10 users, the LYRASIS Wiki strongly recommends using Docker for a "quick install." This method packages all components (Database, Solr, API, UI) into containers, avoiding manual configuration of each dependency, though it requires at least 6GB–8GB of RAM. Related Research Try out DSpace 7 - Confluence Mobile - LYRASIS Wiki

Installing DSpace 7 on Windows 10 is a complex process because the platform has transitioned to a modern, decoupled architecture. Unlike previous versions, DSpace 7 consists of two distinct parts: a Java-based REST API (backend) and an Angular-based User Interface (frontend).

While DSpace is natively designed for Linux environments, you can successfully run it on Windows 10 for development or testing purposes by following this structured guide. 🛠️ Prerequisites and System Requirements

Before starting, ensure your Windows 10 machine has at least 8GB of RAM (16GB recommended) and the following software installed: Java JDK 11 or 17: The backend runs on Java. Apache Maven 3.6+: Used to build the Java source code. PostgreSQL 11-15: The database engine. Apache Tomcat 9: The web server for the backend. Node.js (v16 or v18): Required for the Angular frontend. Yarn: Package manager for the frontend. Git for Windows: To clone the repositories. Solr 8.11: The search engine component. 1. Database Setup (PostgreSQL) Install PostgreSQL and open pgAdmin 4.

Create a new Login/Group Role named dspace with a password (e.g., dspace).

Create a new Database named dspace, owned by the dspace user. Enable the pgcrypto extension on the dspace database: Open Query Tool and run: CREATE EXTENSION pgcrypto; 2. Backend Installation (Server) Download and Configure

Download the DSpace 7 Server source code from GitHub or the official website. Extract the files to a directory like C:\dspace-src. Navigate to C:\dspace-src\dspace\config. Copy local.cfg.EXAMPLE and rename it to local.cfg.

Edit local.cfg with your database credentials and installation path: dspace.dir = C:/dspace db.url = jdbc:postgresql://localhost:5432/dspace dspace.server.url = http://localhost:8080/server dspace.ui.url = http://localhost:4000 Build the Backend Open Command Prompt as Administrator in C:\dspace-src. Run: mvn package

Once finished, navigate to C:\dspace-src\dspace\target\dspace-installer. Run: ant fresh_install

Note: You may need to install Apache Ant if not already present. 3. Configuring Apache Tomcat Prerequisites

Copy the contents of C:\dspace\webapps to your Tomcat webapps folder.

In Tomcat’s conf/server.xml, ensure the connector is set to UTF-8:

Start the Tomcat service. You should be able to access the API at http://localhost:8080/server. 4. Solr Search Engine Setup Download Solr 8.11.x and extract it.

Copy the DSpace Solr cores from C:\dspace\solr to your Solr server/solr/configsets directory. Start Solr: bin\solr.cmd start.

Create the DSpace cores (authority, oai, search, statistics) using the Solr admin interface or command line. 5. Frontend Installation (User Interface) Clone the dspace-angular repository.

Open a terminal in the folder and run: npm install (or yarn install). Create a config/config.prod.yml file. Set the rest connection settings to point to your backend: ssl: false, host: localhost, port: 8080, nameSpace: /server Build the UI: npm run build:prod. Start the UI: npm run serve:ssr. Access the interface at http://localhost:4000. 💡 Troubleshooting Tips

Memory Issues: If Maven or Node.js crashes, increase your heap size (e.g., set NODE_OPTIONS=--max_old_space_size=4096).

File Paths: Always use forward slashes / in local.cfg even on Windows to avoid escape character errors.

Administrator Rights: Always run your command prompts or PowerShell windows as an Administrator to prevent permission errors during the build.

If you'd like to dive deeper into a specific step, tell me if you need help with: Configuring HTTPS for local production testing Setting up Solr cores manually via the command line

Creating the first administrator account using the dspace CLI

Installing DSpace 7 on Windows 10 is a unique endeavor because the software is split into two distinct parts: a (Angular UI) and a (Java-based REST API)

. While most production instances run on UNIX-like systems, you can successfully set it up on Windows 10 for development or small-scale use. LYRASIS Wiki 1. The Modern Way: Docker on Windows

The recommended approach for most users on Windows 10 is using Docker Desktop

. This avoids the headache of manually installing and linking multiple services. LYRASIS Wiki Why it's easier

: It automatically bundles the database, Solr search index, REST API, and user interface. System Demand : You must allocate at least 6GB–8GB of RAM specifically to Docker for DSpace to run smoothly. Prerequisites : You only need to install Docker Desktop for Windows Google Groups 2. Manual Installation Prerequisites

If you choose a full manual installation, you'll need to manage a stack of specific software versions: www.unirepos.com : JDK 11 or 17 (OpenJDK or

: PostgreSQL (v11 through v17 depending on your DSpace 7 minor version). : Apache Solr 8.x or 9.x.

: In DSpace 7, Solr must be installed separately; it is no longer built-in. Build Tools : Apache Maven 3.5.4+ and Apache Ant 1.10.x+. Web Server : Apache Tomcat 9 or 10.1.x. LYRASIS Wiki 3. Key Challenges on Windows 10 1 Minimum System requirements for DSpace installation Windows 10 (64-bit) Java Development Kit (JDK) 11

To install DSpace 7 on Windows 10, you must set up two distinct components: the Backend (REST API) and the Frontend (Angular User Interface). 1. Hardware & System Requirements Operating System: Windows 10 (64-bit recommended).

Memory (RAM): 8–12 GB minimum for a stable local environment (4 GB is the absolute bare minimum but prone to issues). Storage: 20 GB or more of disk space. 2. Prerequisite Software

Install and configure these core dependencies before attempting the DSpace installation:

Java JDK 11: Required for the backend. Set the JAVA_HOME environment variable to your JDK path (e.g., C:\Program Files\Java\jdk-11.0.x).

PostgreSQL 11+: DSpace uses this for its relational database. Ensure the pgcrypto extension is installed. Apache Tomcat 9: The servlet container for the backend.

Apache Solr 8.x: Essential for search functionality. Note that Solr must now be installed separately from DSpace.

Apache Maven 3.3+ & Apache Ant 1.10+: Tools used to build and install the DSpace code. Node.js & Yarn: Required for the Angular frontend. 3. Backend Installation Steps

Database Setup: Create a dspace user and database in PostgreSQL. Grant all privileges to the user and run CREATE EXTENSION pgcrypto;.

Configuration: Rename local.cfg.EXAMPLE to local.cfg in your source directory and update the database credentials and the dspace.dir path (e.g., C:/dspace). Build & Install: Navigate to the source folder and run mvn package.

Go to dspace\target\dspace-installer and run ant fresh_install.

Deployment: Copy the server folder from your DSpace installation webapps directory to the Tomcat webapps folder. 4. Frontend Installation Steps

Download Source: Clone or download the dspace-angular repository.

Install Dependencies: Run yarn install in the frontend directory.

Configure Environment: Create a config.prod.yml (or similar for your version) and point the rest host to your local backend (typically localhost:8080/server).

Launch: For development, use yarn start. For a production-like local setup on Windows, use PM2 in cluster mode as required for Windows compatibility.

These video guides provide step-by-step visual walkthroughs for both the backend and frontend setup on Windows: DSpace Installation on Windows OS-English 3K views · 4 years ago YouTube · Spoken-Tutorial IIT Bombay Installation dspace 7.x version on Windows 10/11. 14K views · 3 years ago

YouTube · Hoang Loc Official Guitar Viet Nam and OpenSource

1. Download PostgreSQL 14 from enterprisedb.com.
2. Run installer:
   • Installation directory: C:\PostgreSQL\14
   • Data directory: C:\PostgreSQL\data
   • Set password for postgres user (remember it: dspace is typical).
   • Port: 5432 (default)
3. Add PostgreSQL bin directory to PATH: C:\PostgreSQL\14\bin
4. Create a DSpace database and user:
   • Open SQL Shell (psql) or psql -U postgres
   • Run:

     CREATE USER dspace WITH PASSWORD 'dspace';
     CREATE DATABASE dspace OWNER dspace;
     GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;
     

5. Verify: psql -U dspace -d dspace -h localhost connects successfully.

Download the Core Software

Create a folder on your C:\ drive (or another drive) named dspace-install. Inside, place the following installers (download them first):

1. Java JDK 11 (or 17) – from Adoptium (Eclipse Temurin) or Oracle.
2. PostgreSQL 14 or 15 – official installer from EnterpriseDB.
3. Apache Tomcat 9 – zip version (not the Windows installer).
4. Apache Maven 3.8.x+ – zip archive.
5. Node.js (LTS version, e.g., 18.x or 20.x) – MSI installer.
6. Git for Windows (optional but highly recommended) – to clone DSpace source.
7. DSpace 7 source code – either git clone or download the dspace-7.6.1.zip (latest stable as of writing) from GitHub.

Important: DSpace 7 requires Java 11 (Java 17 works in later point releases, but 11 is safest for 7.6). Do not use Java 8.

Handle server – set to demo mode

handle.canonical.prefix = http://localhost:8080/handle