How to install ArchivesSpace on Manjaro

ArchivesSpace is an open-source web application designed for managing archives and special collections. This tutorial will guide you step-by-step on how to install ArchivesSpace on your Manjaro operating system.

Prerequisites

Before starting the installation process, please ensure that you have the following installed on your system:

• Java (JRE) version 8 or higher
• MySQL or PostgreSQL Server
• Git

Installation

1. Open your terminal application on Manjaro.

2. Clone the ArchivesSpace repository using Git:

   git clone https://github.com/archivesspace/archivesspace
   

3. Go to the cloned ArchivesSpace directory using the cd command:

   cd archivesspace
   

4. Run the build script to generate the ArchivesSpace application package:

   ./build/run build
   

5. Once the build process is complete, the ArchivesSpace package file will be located at build/archivesspace.zip.

6. Extract the package file to your desired location:

   unzip build/archivesspace.zip -d /path/to/extract/location
   

7. Navigate to the newly extracted directory:

   cd /path/to/extract/location
   

8. Create a config/config.rb file by copying the example file:

   cp config/config-example.rb config/config.rb
   

9. Modify the config/config.rb file to match your database configuration. Uncomment the relevant parts and provide your database settings.

   If you are using MySQL, modify the following section:

   AppConfig[:db_url] = "jdbc:mysql://localhost:3306/archivesspace?user=archivesspace&password=archivesspace&useUnicode=yes&characterEncoding=UTF-8&autoReconnectForPools=true&rewriteBatchedStatements=true&useSSL=false"
   

   If you are using PostgreSQL, modify the following section:

   AppConfig[:db_url] = "jdbc:postgresql://localhost:5432/archivesspace?user=archivesspace&password=archivesspace&sslmode=disable&ApplicationName=ArchivesSpace"
   

10. Initialize the ArchivesSpace database:

    scripts/setup-database.sh
    

11. Start the ArchivesSpace application:

    ./scripts/archivesspace.sh
    

12. Open your web browser and navigate to http://localhost:8080/.

Congratulations! You have successfully installed ArchivesSpace on Manjaro. You can now start using it to manage your archives and special collections.