Dspace 7 Installation On Windows 10 Online
The default configuration assumes Unix paths. You need to edit several files.
| Problem | Solution |
|---------|----------|
| dspace command not found | Add C:\dspace\bin to your system PATH. |
| Access is denied on C:\dspace | Right-click properties → Security → give your user Full Control. |
| Tomcat doesn’t load server.war | Check logs/catalina.out in Tomcat. Most likely a path issue – ensure dspace.dir in local.cfg uses forward slashes and matches setenv.bat. |
| Angular UI shows 401 Unauthorized | Your REST URL is wrong. Ensure CORS is enabled in local.cfg (add rest.cors.allowed-origins = http://localhost:4200). |
| Database migration fails (JDBC driver) | Copy postgresql-*.jar into C:\dspace\lib and also into C:\tomcat9\lib. |
| Solr search not working | Start Solr separately: java -jar C:\dspace\webapps\solr.war – but DSpace 7 uses embedded Solr by default. Check solr.server in local.cfg. |
After installing Java, you must configure Windows environment variables.
Path variable → Add: %JAVA_HOME%\binMAVEN_HOME and point to your Maven folder.java -version
mvn -version (after installing Maven)
Tip: After any environment change, restart your command prompt or PowerShell.
This feature would result in a new Markdown file INSTALL-Windows.md added to the main DSpace repository, or a dedicated section on the DSpace Wiki under "Installation".
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
Installing DSpace 7 on Windows 10 is possible but significantly more complex than previous versions because it requires managing both a Backend (Java) and a Frontend (Node.js). While Linux is the more common environment for DSpace, you can set it up on Windows by carefully following these steps. System Requirements
Operating System: 64-bit Professional, Education, or Enterprise editions of Windows 10 are supported (Home edition is not).
Memory: 8–12 GB RAM recommended (DSpace 7 parts like Solr, Node.js, and Tomcat are memory-intensive). Storage: 20 GB minimum free disk space. Prerequisite Software
You must install and configure these before starting the DSpace installation:
Java JDK 11 or 17: Must be the full Development Kit (JDK), not just the JRE.
PostgreSQL (12.x – 17.x): Required database with the pgcrypto extension enabled.
Apache Solr (8.11.x): Essential for search; unlike older versions, Solr must be installed as a separate standalone service.
Apache Maven (3.5.4+) & Apache Ant (1.10.x): Tools used for building the DSpace backend. dspace 7 installation on windows 10
Apache Tomcat 9: The servlet engine to run the DSpace web application.
Node.js & Yarn: Required to build and run the new Angular frontend. Installation Steps 1. Backend Configuration
Database Setup: Create a dspace user and database in PostgreSQL with UTF-8 encoding.
Environment Variables: Set JAVA_HOME, ANT_HOME, and MAVEN_HOME in your Windows System Variables. Add their \bin folders to your Path.
Source Code: Download the DSpace 7 backend source code, modify local.cfg to match your database and installation directory, then run mvn package from the command line.
Deployment: Use ant fresh_install to build the files, then copy the webapps (like server) to your Tomcat webapps folder. 2. Frontend Configuration
Install Dependencies: Clone the dspace-angular repository and run yarn install.
Configure API: Update the environment.prod.ts file to point to your local backend REST API (usually http://localhost:8080/server/api).
Start UI: Run yarn start or yarn build to launch the user interface. Easier Alternative: Docker
The official DSpace team recommends using Docker Desktop for Windows. This allows you to run all components (Database, Solr, Backend, and Frontend) in pre-configured containers with a single command, bypassing most manual configuration issues on Windows. Performance Tuning DSpace - LYRASIS Wiki
Installing DSpace 7 on Windows 10 is a multi-stage process because the software is split into two distinct parts: a Java-based Backend (REST API) and an Angular-based Frontend (User Interface). 1. Hardware & System Requirements Operating System: Windows 10 (64-bit recommended).
RAM: 8–12 GB recommended (4 GB bare minimum for local testing). Storage: At least 20 GB of free disk space. 2. Prerequisite Software
Before installing DSpace itself, you must set up the environment:
Java: JDK 11 (Oracle or OpenJDK). Set your JAVA_HOME environment variable to the JDK installation path. Database: PostgreSQL 11 or higher (v14.7 is commonly used). Build Tools: Apache Maven (v3.3+) and Apache Ant (v1.10+). Servlet Container: Apache Tomcat 9. The default configuration assumes Unix paths
Search Engine: Solr 8.x (must be installed separately starting with version 7).
Frontend Requirements: Node.js (v16 or LTS) and the Yarn package manager. 3. Backend Installation Steps DSpace 7 Installation Guide for Windows 10 | PDF - Scribd
Installing DSpace 7 on Windows 10 is a multi-step process that involves setting up a backend (REST API) and a frontend (Angular UI)
. While most production instances use Linux, Windows 10 is supported for development and testing environments. LYRASIS Wiki System Requirements
Windows 10 (64-bit Professional/Education/Enterprise recommended). 2 GHz dual-core or higher. At least 4GB (8–12GB recommended for performance). Minimum 20GB free disk space. LYRASIS Wiki Step 1: Install Prerequisite Software
You must install and configure several backend and frontend tools: Install JDK 11 or 17 and set the environment variable. PostgreSQL
(version 12–17) and create a database user and database named Build Tools: Apache Maven (3.5.4+) and Apache Ant (1.10.x+). Search Engine: Apache Solr 8.x
. Unlike earlier versions, Solr must be installed separately for DSpace 7. Servlet Engine: Apache Tomcat 9 to host the backend. Frontend Tools: for the Angular UI. LYRASIS Wiki Step 2: Backend Installation (REST API) Configure Database: Enable the extension on your Build Source: Download the DSpace 7 backend source code, edit to point to your database and installation directory (e.g., ), and run mvn package Install Binaries: Navigate to the dspace-installer folder and run ant fresh_install Deploy to Tomcat: folder from your DSpace installation webapps to Tomcat's Initialize Database: dspace database migrate from the installation's LYRASIS Wiki Step 3: Frontend Installation (Angular UI) Download UI: Clone or download the dspace-angular repository. Install Dependencies: yarn install in the frontend directory. Configure: Create/edit config/config.prod.yml to point the UI to your local REST API (usually
Title: Step-by-Step Guide: Installing DSpace 7 on Windows 10 for Beginners
Introduction
DSpace is the world’s leading open-source repository system used by universities, libraries, and research institutions to manage and showcase their digital assets. With the release of DSpace 7, the platform has undergone a massive UI/UX overhaul, introducing a modern Angular frontend alongside a robust REST API backend.
However, installing DSpace 7 on Windows 10 can be tricky. Most official documentation is written for Linux, and Windows users often face path, permission, and dependency issues.
In this guide, I will walk you through a complete, clean installation of DSpace 7.6 (the latest stable version as of writing) on Windows 10. By the end, you’ll have a running local repository at http://localhost:4000.
Prerequisites
Before touching any code, you need to install the correct tools. Do not skip versions—DSpace is picky.
Step 1: Set Windows Environment Variables
Open System Properties > Environment Variables and add the following System Variables:
| Variable | Value |
| --- | --- |
| JAVA_HOME | C:\Java\jdk-11 |
| MAVEN_HOME | C:\maven |
| DSpace_HOME | C:\dspace |
Then, edit the Path variable and add:
Verify in a new Command Prompt:
java -version (should show 11.x)
mvn -version (should show 3.6+)
node -v (should show v16.x)
yarn -v (should show 1.22)
Step 2: Prepare PostgreSQL Database
CREATE USER dspace WITH PASSWORD 'dspace';
CREATE DATABASE dspace OWNER dspace;
GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;
\c dspace
CREATE EXTENSION IF NOT EXISTS pgcrypto;
\q
Step 3: Download and Build DSpace Backend (REST API)
Open a Command Prompt as Administrator.
cd C:\
git clone https://github.com/DSpace/DSpace.git dspace-src
cd dspace-src
git checkout dspace-7.6
Now create the Maven build configuration:
cd C:\dspace-src
mvn package
Wait 5–10 minutes for the build to succeed.
Step 4: Configure DSpace Backend
Navigate to the installation folder after Maven builds everything:
cd C:\dspace-src\dspace\target\dspace-installer
Copy the configuration template:
copy config\local.cfg.EXAMPLE config\local.cfg
Edit local.cfg (use Notepad++ or VS Code). Change the following lines:
# Database connection
db.url = jdbc:postgresql://localhost:5432/dspace
db.driver = org.postgresql.Driver
db.username = dspace
db.password = dspace