How to Install Archivematica on Fedora Server

Pre-requisites

Before we begin, make sure that your Fedora server is updated with the latest software packages.

sudo dnf update -y

You should also ensure that your server has the following:

To install Docker and Docker Compose, you can follow the official Docker documentation for Fedora by visiting https://docs.docker.com/engine/install/fedora/.

Step 1: Download and Extract Archivematica

First, create a directory where we will download and extract the Archivematica files.

sudo mkdir /opt/archivematica

Then, navigate to the directory and download the latest version of Archivematica.

sudo wget https://github.com/archivematica/archivematica/releases/download/v1.12.1/archivematica-1.12.1.tar.gz

Extract the downloaded file.

sudo tar -xvzf archivematica-1.12.1.tar.gz -C /opt/archivematica

Step 2: Set Up the Archivematica Environment

Navigate to the extracted Archivematica directory.

cd /opt/archivematica/archivematica-1.12.1

All the required environment variables are stored in .env file. Copy the sample file and modify it with the required configuration.

sudo cp .env-sample .env

Open the file with your favorite editor and make the following changes:

# Set the domain name or IP address of your server
PUBLIC_IP=your_server_IP

# Set the username of the dedicated Archivematica user created above
ARCHIVEMATICA_USER=new_archivematica_user

# Set the path to the Archivematica storage directory
ARCHIVEMATICA_STORAGE_DIR=/opt/archivematica/sharedDirectory

# Set the path to the database directory
DATABASE_DIR=/opt/archivematica/sharedDirectory/Database

# Set the path to the Elasticsearch data directory
ELASTICSEARCH_DATA_DIR=/opt/archivematica/sharedDirectory/elasticsearch-data

# Set the path to the PostgreSQL data directory
POSTGRES_DATA_DIR=/opt/archivematica/sharedDirectory/postgresql-data

Save and close the file.

Step 3: Start the Archivematica Services

Start the services using Docker Compose.

sudo docker-compose up -d

This will start all the required services, including PostgreSQL, Elasticsearch, and RabbitMQ. You can check the status of the running services by running the following command.

sudo docker-compose ps

If all the services are running correctly, you should see output similar to this:

   Name                Command                        State                    Ports
-----------------------------------------------------------------------------------------------
archivematica_mcp_1   sh -c bin/wait-for-it.sh d ...   Up (healthy)   8000/tcp
archivematica_mc ...   sh -c bin/wait-for-it.sh d ...   Up (healthy)   8000/tcp
archivematica_nginx   nginx -g daemon off;             Up             0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp
archivematica_rabbit  docker-entrypoint.sh rabbi ...   Up             25672/tcp, 4369/tcp, 5671-5672/tcp, 15671/tcp, 15672/tcp
archivematica_whoa    /whoa-startup.sh                 Up             22/tcp
database              docker-entrypoint.sh postgres    Up             5432/tcp
elasticsearch        /usr/local/bin/docker-entr ...   Up             9200/tcp, 9300/tcp

Step 4: Set Up Archivematica

Access the Archivematica User Interface by navigating to your server's IP address in a web browser. You should see the Archivematica dashboard, which is not fully configured yet.

archivematica-dashboard.png

Click on the "Setup" button to complete the setup process.

archivematica-setup.png

Follow the wizard to configure your Archivematica settings, including the following:

Once completed, click on the "Activate" button to finish the setup and start using Archivematica.

archivematica-activate.png

Conclusion

In this tutorial, we have walked through the steps required to install Archivematica on a Fedora server. With Archivematica set up, you can now easily manage your digital archives and ensure their long-term preservation.

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!