Access to Memory (AtoM) is a free and open-source software for managing and providing access to digital archives. In this tutorial, we will guide you through the process of installing AtoM on MXLinux.
Before we start, make sure you have the following prerequisites:
The first step is to update the package list and install the required packages. Open the terminal and run the following commands:
sudo apt-get update
sudo apt-get install apache2 mariadb-server php php-mysqli php-mbstring php-curl php-gd libapache2-mod-php openssl zip unzip sendmail
The above command will install the Apache webserver, MariaDB database server, and all the necessary PHP dependencies.
Next, we need to download and extract the AtoM package. Go to the AtoM website and download the latest version of the software:
https://www.accesstomemory.org/
Once the download is complete, open the terminal and navigate to the download directory:
cd ~/Downloads/
Now extract the downloaded archive:
unzip atom-x.x.x.zip
This will extract the AtoM files in the current directory.
We need to move the AtoM files to the document root of the Apache webserver. By default, the document root is /var/www/html/. Run the following command to move the files to the document root:
sudo mv atom /var/www/html/
The next step is to set the appropriate permissions on the AtoM files. Run the following command to set the owner and group of the files to the webserver:
sudo chown -R www-data:www-data /var/www/html/atom/
We need to create a database for AtoM. Run the following commands to login to the MariaDB server and create a new database named 'atom':
sudo mysql -u root -p
# Enter your MySQL root password when prompted
CREATE DATABASE atom;
GRANT ALL PRIVILEGES ON atom.* TO 'atomuser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
Replace 'atomuser' and 'password' with your preferred username and password.
The final step is to configure Apache to serve the AtoM files. Run the following commands to create a new virtual host configuration file for AtoM:
sudo nano /etc/apache2/sites-available/atom.conf
Copy and paste the following configuration into the file:
<VirtualHost *:80>
ServerName your_domain.com
ServerAdmin webmaster@your_domain.com
DocumentRoot /var/www/html/atom
<Directory /var/www/html/atom/>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Replace "your_domain.com" with your actual domain or IP address.
Save and close the file by pressing 'Ctrl+x', 'y', and 'Enter'.
Finally, enable the new virtual host and restart Apache with the following commands:
sudo a2ensite atom.conf
sudo systemctl restart apache2
Open your browser and navigate to the URL of your new AtoM installation. The default URL is:
http://your_domain.com/
Follow the instructions to complete the AtoM installation. Make sure to select the MariaDB database and use the 'atomuser' credentials you created in step 5.
Congratulations, you have successfully installed Access to Memory (AtoM) on MXLinux! You can now start managing and providing access to digital archives.
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!
