Introduction

Collective Access - Providence is an open-source web-based application designed for museums and other cultural heritage organizations. It provides a flexible and customizable platform to manage collections, archives, and digital assets. This tutorial will guide you through the steps to install Collective Access - Providence on Ubuntu Server Latest using Apache web server and MySQL database management system.

Prerequisites

Before you start, make sure you have the following:

Step 1: Update the System

Before installing any new software packages, it is important to update the Ubuntu Server system to its latest release. You can update the system using the following command:

sudo apt update && sudo apt upgrade

Enter the root password or sudo user password as prompted to continue.

Step 2: Install Required Dependencies

To install Collective Access - Providence, you must first install the required dependencies. The following command will install all the necessary dependencies:

sudo apt install apache2 php7.4 php7.4-curl php7.4-gd php7.4-json php7.4-mbstring php7.4-mysql php7.4-xml libapache2-mod-php7.4 mysql-server-8.0 unzip

During the installation process, you will be prompted for a root password for MySQL. Enter the desired password and confirm it.

Once the installation is complete, you can check the version of PHP installed by running the following command:

php --version

Step 3: Configure Apache Web Server

Next, you need to configure the Apache web server to host Collective Access - Providence. Open the default Apache configuration file using the following command:

sudo nano /etc/apache2/sites-available/000-default.conf

Add the following lines at the end of the file:

Alias /providence /var/www/html/providence
<Directory /var/www/html/providence>
        Options FollowSymLinks
        AllowOverride All
</Directory>

Save the file and exit the editor.

Step 4: Download and Install Collective Access - Providence

Download the latest version of Collective Access - Providence from the official website using the following command:

wget https://github.com/collectiveaccess/providence/archive/refs/tags/1.7.13.zip

Extract the downloaded file using the following command:

unzip 1.7.13.zip

Move the extracted files to the Apache web server document root directory using the following command:

sudo mv providence-1.7.13 /var/www/html/providence

Set the correct file permissions for the Collective Access - Providence directory using the following command:

sudo chown -R www-data:www-data /var/www/html/providence
sudo chmod -R 775 /var/www/html/providence/app/plugins

Step 5: Configure MySQL Database

Create a new database for Collective Access - Providence using the following command:

sudo mysql -u root -p

Enter the MySQL root password as prompted to enter the MySQL command prompt.

CREATE DATABASE providence;
GRANT ALL PRIVILEGES ON providence.* TO 'providenceuser'@'localhost' IDENTIFIED BY 'yourpassword';
FLUSH PRIVILEGES;
EXIT;

Replace 'yourpassword' with the desired password and note it down as you would need it later.

Step 6: Install Collective Access - Providence

Open your web browser and navigate to the following URL:

http://localhost/providence/app/install/index.php

You should see the Collective Access - Providence installation wizard. Follow the instructions on the screen to complete the installation process.

When prompted for the database connection details, enter the following:

Database type: MySQL
Database host: localhost
Database name: providence
Database username: providenceuser
Database password: yourpassword

Replace 'yourpassword' with the password you created in step 5.

Note down the administrator username and password as you would need it to log in to the Collective Access - Providence interface.

Step 7: Secure Your Installation

To secure your installation, you should change the default administrator username and password and configure SSL encryption.

To change your administrator password, log in to the Collective Access - Providence interface using the default username and password and navigate to the 'Users' section.

To configure SSL encryption, refer to the respective tutorials for Apache web server and Ubuntu Server Latest.

Conclusion

You have successfully installed Collective Access - Providence on Ubuntu Server Latest using Apache web server and MySQL database management system. You can now use Collective Access - Providence to manage your museum or cultural heritage organization's collections, archives, and digital assets.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!