CollectionSpace System Requirements

CollectionSpace System Requirements

About System Requirements
This document provides hardware and software requirements for a CollectionSpace server.

A dedicated Ubuntu 22.04 LTS server is recommended.

CollectionSpace is offered under the terms of an open source ECL 2.0 License. See Licensing for details.

 


This documentation is for institutions that self-host CollectionSpace. If you host CollectionSpace, installation, upgrades, and configurations are handled by your hosting provider.

Recommended Operating System

We strongly recommend installing CollectionSpace on a dedicated Ubuntu 22.04 LTS server. Most of our development and testing of CollectionSpace has taken place on Ubuntu 20.04.x LTS servers. That said, as far as we know, the CollectionSpace server runs fine on Mac OS X, Windows 7, and several other flavors of Linux.

To install CollectionSpace onto an Ubuntu 22.04 LTS server, you'll need to be very comfortable with the Linux bash shell and with using common Linux command-line tools. You will also need to have an account on the Ubuntu server that has elevated (i.e., sudo) privileges/permissions.

Supported Operating Systems

Although we regularly build and use CollectionSpace servers in multiple Linux environments and don't anticipate problems running CollectionSpace servers in other environments (other Unix-like OSes, Mac OS X, Microsoft Windows), CollectionSpace has been extensively tested ONLY on Ubuntu 22.04 LTS servers.

Successful Installations to Date

Operating systems on which the CollectionSpace server has been successfully installed and run to date include:

  • Linux distributions:

    • Ubuntu 22.04 LTS (Recommended)

  • Apple Mac OS:

    • Mac OS 15.6 (Sequoia)

  • Microsoft Windows:

    • Windows 10

Table 1-1 Hardware Requirements Summary

The hardware capabilities of your server will often have a greater impact on your system's overall performance than the capabilities of your client computers. Generally, the more memory and CPU you have available on your server, the better your CollectionSpace system will perform.

Requirement
Value
Requirement
Value
Physical memory (RAM)
2 GB RAM (4 GB or higher strongly recommended), 1 GB cache
Virtual memory / swap space
At least 1/2 amount of physical RAM
Disk space
40 GB (depends on the size of your collections data)
Processor
1 GHz minimum
System Architecture
Processor: Intel (x86), AMD64, and Intel EM64T
Table 1-2 Software Requirements for Installation
Requirement
Value Description
Requirement
Value Description
Database system: PostgreSQL server
PostgreSQL 9.1 or later is required and the most current stable production version is recommended. See PostgreSQL Installation for Linux or PostgreSQL for Windows, Mac OS, or Generic Linux
Java Development Kit (JDK)
JDK 8 (Java SE 1.8) or OpenJDK 8
Build tools: Ant
Ant 1.8.2 or higher
Build tools: Maven
Maven 3.0 or higher
ImageMagick
ImageMagick 6.0 or higher (See Installing ImageMagick)
FTP Client
Any FTP client tool (e.g. FileZilla)
Gzip
Any tool that handles gzip files (eg. tar (Linux, Mac OS X), winzip (Windows), 7-zip (Windows))

 


Server Machine Preparations

Prepare your server machine (UNIX or Windows) to run CollectionSpace by following the next steps:

  1. Install the required software described in Table 1-2 on the server machine. In particular, ensure that a PostgreSQL database server is installed and running. For some instructions on installing PostgreSQL under various operating systems, see the relevant guide in Installing CollectionSpace.

  2. Create a folder in which to download the CollectionSpace software.

After doing so, follow the instructions for installing the CollectionSpace server in the relevant installation guide in Installing CollectionSpace.


Client Recommendations

Since the client side of CollectionSpace is a standard web interface, the requirements for the client are relatively light. Clients need a web browser.

Because the CollectionSpace front-end runs in JavaScript within the browser, a faster client computer with more memory will yield better performance. The speed of the JavaScript interpreter in the client browser will also impact some aspects of performance.

Table 1-3 Client Software Recommendations
Requirement
Description
Requirement
Description
Operating System - Client
Windows or Mac
Browser
CollectionSpace application runs on most current browsers. QA testing is regularly performed on Chrome, Firefox, Safari and Edge.