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.
Before you start, make sure you have the following:
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.
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
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.
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
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.
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.
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.
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!