Installing Access to Memory (AtoM) on Elementary OS

Access to Memory (AtoM) is a web application that provides a platform for managing, sharing, and preserving cultural heritage and archival materials. In this tutorial, we will walk through the steps to install AtoM on the latest version of Elementary OS.

Prerequisites

Before we start, make sure your system meets the following requirements:

  • Elementary OS latest version
  • Apache web server
  • PHP 7.3 or later
  • MySQL 5.7 or later

Step 1: Install Required Packages

First, install all the required packages by running the following command in your terminal:

sudo apt install apache2 php7.4 libapache2-mod-php7.4 php7.4-mysql mysql-server

Step 2: Download and Extract AtoM

Next, download the latest version of AtoM from the official website:

wget https://storage.googleapis.com/releases.ica-atom.org/3.3.x/atom-3.3.0.tar.gz

After downloading the file, extract it using the following command:

tar xvfz atom-3.3.0.tar.gz

Step 3: Move Files to Web Directory

Once extracted, move the AtoM folder to your Apache web root directory. By default, the web root directory is located at /var/www/html/. You can use the following command to move the AtoM folder to the web root directory:

sudo mv atom-3.3.0 /var/www/html/atom

Step 4: Configure MySQL

Create a new MySQL database and user for AtoM. You can use the following commands to create a new database:

mysql -u root -p CREATE DATABASE atom_db; CREATE USER 'atom_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT ALL PRIVILEGES ON atom_db.* TO 'atom_user'@'localhost'; exit

Note: Replace "PASSWORD" with a strong password.

Step 5: Configure AtoM

First, rename the config-sample.php file to config.php:

sudo mv /var/www/html/atom/config/config-sample.php /var/www/html/atom/config/config.php

Next, edit the config.php file with your MySQL database details:

sudo nano /var/www/html/atom/config/config.php

Change the following lines to reflect your database configuration:

define('QubitDBHost', "localhost");
define('QubitDBName', "atom_db");
define('QubitDBUser', "atom_user");
define('QubitDBPass', "PASSWORD");

Step 6: Set Permissions

Set the proper permissions for the AtoM files:

cd /var/www/html/atom chmod -R 755 . chown -R www-data.www-data .

Step 7: Access AtoM

Finally, access the AtoM web interface using your web browser. Navigate to http://localhost/atom. You should now be able to login to the AtoM interface with the default username and password:

  • Username: admin
  • Password: admin

Congratulations, you have successfully installed AtoM on your Elementary OS system! You can now start using AtoM for managing, sharing, and preserving cultural heritage and archival materials.