dspace/dspace-angular repository overview

DSpace Documentation⁠ | DSpace Releases⁠ | DSpace Wiki⁠ | Support⁠

⁠dspace-angular

⁠Overview

DSpace open source software is a turnkey repository application used by more than 2,000 organizations and institutions worldwide to provide durable access to digital resources. For more information, visit http://www.dspace.org/⁠

DSpace consists of both a Java-based backend and an Angular-based frontend.

• Backend (https://github.com/DSpace/DSpace/⁠) provides a REST API, along with other machine-based interfaces (e.g. OAI-PMH, SWORD, etc)
  • The REST Contract is at https://github.com/DSpace/RestContract⁠
• Frontend (https://github.com/DSpace/dspace-angular/⁠) is the User Interface built on the REST API

⁠Docker Images/Tags

Here's how we use our tags in DockerHub:

• Versioned released (e.g. dspace-7.5) - Correspond to the same release as available at https://github.com/DSpace/dspace-angular/releases⁠ These are the most stable tags as they correspond to a specific release.
  • *-dist releases of the versioned tag will only includes the prebuilt dist distribution folder. Therefore, these images can only be run in Production mode.
  • NOTE: These version tags are static and will not be updated after the release occurs. The next release will have a new version tag.
• dspace-7_x - Latest version of v7.x (i.e. dspace-7_x branch in GitHub), also including unreleased 7.x code. Includes all daily commits to our 7.x maintenance branch, so it will include unreleased code. This tagged image always builds/runs the user interface in Development mode.
  • NOTE: This tag is dynamic and updates whenever new code is added to the maintenance branch. Therefore it will also include security updates from any base images.
• dspace-7_x-dist - Latest version of v7.x (i.e. dspace-7_x branch in GitHub), also including unreleased 7.x code. Includes all daily commits to our 7.x maintenance branch, so it will include unreleased code. This tagged image only includes the prebuilt dist distribution folder. Therefore, this image can only be run in Production mode.
  • NOTE: This tag is dynamic and updates whenever new code is added to the maintenance branch. Therefore it will also include security updates from any base images.
• latest - Bleeding edge code on the main branch in GitHub. This should NEVER BE USED IN PRODUCTION as it may not be stable.
• latest-dist - Bleeding edge code on the main branch in GitHub. This should NEVER BE USED IN PRODUCTION as it may not be stable. This tagged image only includes the prebuilt dist distribution folder. Therefore, this image can only be run in Production mode.

The DSpace frontend (User Interface) should always be run with the same version backend. Backend images are available at https://hub.docker.com/r/dspace/dspace/tags⁠

⁠Downloads

• Backend (REST API): https://github.com/DSpace/DSpace/releases⁠
• Frontend (User Interface): https://github.com/DSpace/dspace-angular/releases⁠

⁠Documentation / Installation

Documentation for each release may be viewed online or downloaded via our Documentation Wiki⁠.

The latest DSpace Installation instructions are available at: https://wiki.lyrasis.org/display/DSDOC7x/Installing+DSpace⁠

⁠Contributing

See Contributing documentation⁠

⁠Getting Help

DSpace provides public mailing lists where you can post questions or raise topics for discussion. We welcome everyone to participate in these lists:

• [email protected]⁠ : General discussion about DSpace platform, announcements, sharing of best practices
• [email protected]⁠ : Technical support mailing list. See also our guide for How to troubleshoot an error⁠.
• [email protected]⁠ : Developers / Development mailing list

Great Q&A is also available under the DSpace tag on Stackoverflow⁠

Additional support options are at https://wiki.lyrasis.org/display/DSPACE/Support⁠

DSpace also has an active service provider network. If you'd rather hire a service provider to install, upgrade, customize or host DSpace, then we recommend getting in touch with one of our Registered Service Providers⁠.

⁠Issue Tracker

DSpace uses GitHub to track issues:

• Backend (REST API) issues: https://github.com/DSpace/DSpace/issues⁠
• Frontend (User Interface) issues: https://github.com/DSpace/dspace-angular/issues⁠

⁠License

DSpace source code is freely available under a standard BSD 3-Clause license⁠. The full license is available in the LICENSE⁠ file or online at http://www.dspace.org/license/⁠