Installing CollectionSpace

Owned by Jessi Weithman
Apr 18, 2024

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.

Keep in mind that 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, consider engaging an experienced system administrator.

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

Optional Configuration

Under Development

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