Introduction

Access to Memory (AtoM) is an open-source software that is used for creating, managing, and providing access to digital archives. In this tutorial, we will demonstrate how to install Access to Memory on the latest version of POP! OS.

Prerequisites

Install Dependencies

Before we proceed with the installation of Access to Memory, we need to install some dependencies. Run the following command in the terminal to install the dependencies:

sudo apt update
sudo apt install curl git unzip apache2 mysql-server mysql-client php php-curl php-gd php-json php-mbstring php-mysql php-xml php-zip php-intl

Download and Install AtoM

We will now download the latest version of AtoM from GitHub using the following command:

sudo git clone https://github.com/artefactual/atom /var/www/html/atom

Once the download is complete, navigate to the atom directory by running the following command:

cd /var/www/html/atom

Next, we will download the latest stable release of AtoM using the following command:

sudo git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

After that, we will install AtoM using the following command:

sudo bash setup.sh

This command will launch the configuration wizard. Follow the wizard’s prompts to configure AtoM according to your requirements.

Setup Permissions

We will now set up the necessary file permissions for AtoM. Run the following command:

sudo chown -R www-data:www-data /var/www/html/atom
sudo chmod -R 775 /var/www/html/atom

Create a Virtual Host

To access AtoM, we will create a virtual host. Open a new terminal window and run the following command to open the Apache configuration file:

sudo nano /etc/apache2/sites-available/atom.conf

Add the following lines to the configuration file:

<VirtualHost *:80>
  ServerAdmin webmaster@localhost
  DocumentRoot /var/www/html/atom
  ServerName atom.example.com

  <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>

Save and close the file. Then, run the following commands:

sudo a2ensite atom.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

Finalize Installation

Finally, we will complete the installation of AtoM by running the following command:

sudo php /var/www/html/atom/symfony/project/bin/fix-perms

This command will fix the directory permissions and make AtoM ready for use.

Accessing AtoM

AtoM can now be accessed by navigating to your browser and entering the following URL:

http://atom.example.com

If you have set up a DNS record for your server or web domain, then you can use the domain name instead of the IP address.

Conclusion

In this tutorial, we have demonstrated how to install Access to Memory on POP! OS. You can now manage and provide access to digital archives using this powerful open-source software.

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!