How to Install Access to Memory (AtoM) on macOS

Access to Memory (AtoM) is an open-source web-based application for managing archival descriptions and digital objects. In this tutorial, you will learn how to install AtoM on macOS.

Prerequisites

Before installing AtoM, ensure that you have the following:

  • macOS High Sierra or newer
  • Apache, PHP, and MySQL installed
  • Terminal application

Steps

  1. Download the latest version of AtoM from the official website: https://www.accesstomemory.org/download/

  2. Once the download is complete, extract the contents of the archive.

  3. Open the Terminal application.

  4. Navigate to the extracted directory using the cd command. For example:

    cd ~/Downloads/atom-2.5.1

  5. Run the installation script using sudo. For example:

    sudo ./install.sh

  6. The installation script will prompt you to enter the MySQL database user, password, and database name. Enter the appropriate values and press Enter.

  7. Wait for the installation process to complete. This may take some time.

  8. Once the installation is complete, create a new Apache configuration file for AtoM. Run the following command:

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

  9. Paste the following code into the file:

    <VirtualHost *:80>
    ServerName atom
    DocumentRoot /var/www/html/atom
    <Directory /var/www/html/atom>
        AllowOverride All
    </Directory>
</VirtualHost>

  10. Press Ctrl + X, then Y, then Enter to save and exit the file.

  11. Enable the new configuration file by running:

    sudo a2ensite atom.conf

  12. Restart Apache by running:

    sudo service apache2 restart

  13. Open a web browser and go to the following URL: http://localhost/atom

  14. You should see the AtoM login page. Login with the default username (administrator) and password (administrator).

That's it! You have successfully installed AtoM on macOS. Make sure to change the default username and password as soon as possible.