How to Install Access to Memory (AtoM) on Manjaro

Access to Memory (AtoM) is an open source application used for managing archival collections. In this tutorial, we will learn how to install AtoM on Manjaro.

Prerequisites

Before installing AtoM, make sure your system meets the following requirements:

  • Manjaro Linux installed
  • Ruby 2.4+
  • PHP 7.1+
  • Sqlite or MySQL/MariaDB
  • Apache or Nginx installed and configured

Step 1: Install Dependencies

First, let's update the system and install the required dependencies:

sudo pacman -Syu
sudo pacman -S ruby php php-{gd,sqlite,xml,curl,zip} curl nano

Step 2: Install AtoM

We can install AtoM using two methods: the manual installation method or the Docker container method.

Manual Installation Method

  1. Go to AtoM's official website at https://www.accesstomemory.org/.
  2. Download the latest version of AtoM from the Downloads section. Choose the tarball version.
  3. Extract the tarball archive file to the /var/www/html directory.
sudo tar -xvzf atom-3.0.1.tar.gz -C /var/www/html/
  1. Change the owner of the AtoM directory and its content so that Apache can access it.
sudo chown -R http:http /var/www/html/atom/

Docker Container Method

  1. Install Docker on your Manjaro system using the following command:
sudo pacman -S docker
  1. Start the Docker service.
sudo systemctl start docker.service
  1. Create a Docker container for AtoM:
sudo docker run -p 80:80 -d artefactual/atom

Step 3: Configure Apache for AtoM

Here's how to configure Apache to use AtoM:

  1. Enable the PHP module:
sudo systemctl enable php-fpm
sudo systemctl start php-fpm
  1. Create a new Apache virtual host configuration file:
sudo nano /etc/httpd/conf/extra/vhosts/atom.conf

Paste the following configuration into the file:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html/atom/
    Options FollowSymLinks
    <Directory /var/www/html/atom/>
            AllowOverride All
            Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

  1. Save the file and exit.

  2. Restart Apache to apply the changes.

sudo systemctl restart httpd

Step 4: Access AtoM

After completing the above steps, you can access AtoM by visiting http://localhost in your web browser.

Conclusion

In this tutorial, we've learned how to install AtoM on Manjaro using both the manual installation and Docker container methods. We've also configured Apache to use AtoM. Enjoy using AtoM!