Installing CollectionSpace

CollectionSpace must be installed and run on a server and is accessed by users via a web browser like Chrome, Firefox, Safari, or Edge. CollectionSpace does not support the Internet Explorer web browser. No additional software needs to be installed on an end-user's computer.

Using the Automated Installer (RECOMMENDED)

We've created an Automated Installer for performing an unattended installation of CollectionSpace on selected Linux systems. Using the automated installer on VPS or a VirtualBox server is the simplest way to get a CollectionSpace instance installed and running.

Installing via the Manual Steps

If you decide not to use the Automated Installer (and a VPS or VirtualBox), keep in mind that manually installing CollectionSpace on a server requires advanced knowledge and familiarity with command-line tools, networking settings, etc.  If you don't have experience with these tools, please consider using the Automated Installer.

For detailed instructions on manually installing CollectionSpace onto an Ubuntu 22.04 LTS server, click on this link: Installing on Ubuntu LTS

Optional Configuration

Elasticsearch (Experimental)

Beginning with version v4.3, you can configure CollectionSpace to work with an Elasticsearch cluster. Consult the Getting Started tutorial to learn more about Elasticsearch.

To use CollectionSpace with Elasticsearch, you'll first need to download and install Elasticsearch. Use the version of Elasticsearch required by your version of CollectionSpace:

Set up an Elasticsearch cluster following the documentation. The default configuration will create a cluster named "elasticsearch" which is the cluster CollectionSpace will attempt to work with by default.

To enable Elasticsearch indexing, edit the configuration file at '$CSPACE_JEESERVER_HOME/nuxeo-server/config/nuxeo.properties', and set elasticsearch.enabled to true.

By default, CollectionSpace will attempt to connect to an Elasticsearch cluster named "elasticsearch" running on the same server.  After you've done the basic installation of CollectionSpace, you can point CollectionSpace to a different cluster by changing the configuration file at '$CSPACE_JEESERVER_HOME/cspace/config/services/proto-elasticsearch-config.xml' and restarting the CollectionSpace server.

Be sure your Elasticsearch cluster is running before you start the CollectionSpace server.  This will ensure that all your CollectionSpace collection data will be indexed by Elasticsearch.

Related Documentation