Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleTry out DSpace before you install

If you'd like to quickly try out DSpace 9 before a full installation, see Try out DSpace 9 for instructions on a quick install via Docker.

...

Table of Content Zone
locationtop
stylesquare

UNIX-like OS or Microsoft Windows

  • UNIX-like operating system (Linux, HP/UX, Mac OSX, etc.) : Many distributions of Linux/Unix come with some of the dependencies below pre-installed or easily installed via updates.  You should consult your particular distribution's documentation or local system administrators to determine what is already available.
  • Microsoft Windows:  While DSpace can be run on Windows servers, most institutions tend to run it on a UNIX-like operating system.

Node.js (

v18

v20.19+

 or v20.x

or v22.x)

Note

As of DSpace 9.2, the user interface uses Angular v20 which requires Node v20.19.0 or later.  DSpace 9.1 or 9.0 are the last versions to support Node v18.19+.

  • Node.js can be found at https://nodejs.org/.  It may be available through your Linux distribution's package manager.  We recommend running a Long Term Support (LTS) version (even numbered releases).  Non-LTS versions (odd numbered releases) are not recommended.
  • Node.js is a Javascript runtime that also provides npm (Node Package Manager). It is used to both build and run the frontend.

PM2 (or another Process Manager for Node.js apps) (optional, but recommended for Production)

  • In Production scenarios, we highly recommend starting/stopping the User Interface using a Node.js process manager. There are several available, but our current favorite is PM2.  The rest of this installation guide assumes you are using PM2.
  • PM2 is very easily installed via NPM

    Code Block
    # You may need to run this command using "sudo" if you don't have proper privileges
    npm install --global pm2


DSpace Backend (see above)

  • The DSpace User Interface (Frontend) cannot function without an installed DSpace Backend.  Follow the instructions above.
  • The Frontend and Backend do not need to be installed on the same machine/server.  They may be installed on separate machines as long as the two machines can connect to one another via HTTP or HTTPS.

...