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.
Before we start, make sure your system meets the following requirements:
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
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
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
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.
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");
Set the proper permissions for the AtoM files:
cd /var/www/html/atom
chmod -R 755 .
chown -R www-data.www-data .
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:
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.
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!
