Dspace 7 Installation On Windows 10 π π
Create a Database:
Crucial Windows Step: Enable pgcrypto extension.
The steps above are for development or testing only. For a production Windows Server deployment:
You now have a complete, working DSpace 7 repository on Windows 10, ready for customization, theme development, or local testing.
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
Installing DSpace 7 on Windows 10 is a multi-step process involving setting up a Java-based backend (REST API) and a Node.js-based frontend (User Interface). 1. System Requirements & Prerequisites dspace 7 installation on windows 10
Before starting, ensure your Windows 10 machine meets these minimum requirements:
RAM: At least 8-12GB (4GB minimum, but performance will be poor). Storage: 20GB of free disk space. Java: JDK 11 or 17 (Open JDK or Oracle JDK). Build Tools: Apache Maven 3.3+ and Apache Ant 1.10+. Database: PostgreSQL 11+ with the pgcrypto extension.
Search Engine: Apache Solr 8.9+ (DSpace 7 requires Solr to be installed separately). Web Server: Apache Tomcat 9. Frontend Tools: Node.js v16 or 18 and Yarn. 2. Configure Environment Variables
You must add the following to your system's Environment Variables (System Properties > Advanced > Environment Variables):
JAVA_HOME: Path to your JDK folder (e.g., C:\Program Files\Java\jdk-11). ANT_HOME: Path to your Ant folder. MAVEN_HOME: Path to your Maven folder.
Path Variable: Add the bin directories for Java, Ant, Maven, and PostgreSQL to your system Path. 3. Database Setup (PostgreSQL) DSpace 7 Installation Guide for Windows 10 | PDF - Scribd
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 Database:
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
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. Crucial Windows Step : Enable pgcrypto extension
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
git clone https://github.com/DSpace/dspace-angular.git
cd dspace-angular
npm install
npm run start
Then access: http://localhost:4000
After running mvn package, find the war file at:
C:\dspace-src\dspace-server-webapp\target\dspace-server-webapp-7.6.war
Copy it to Tomcatβs webapps folder:
copy C:\dspace-src\dspace-server-webapp\target\dspace-server-webapp-7.6.war C:\tomcat9\webapps\ROOT.war
(renaming to ROOT.war makes the API accessible at http://localhost:8080 directly).