Archivematica 1.7 is our latest release.

Installing Archivematica

On this page

Overview

Archivematica is not a single application - dozens of different components and tools are required for a fully working installation. As a result, there are many possible deployment configurations.

These instructions are designed to get you up and running as quickly as possible, even if you are not familiar the various tools and applications that are bundled into Archivematica. Experience with the Linux command line is helpful, and to support a running production system it should be considered a requirement.

If you need assistance or clarification regarding the installation instructions, the Archivematica google group is a good place ask questions.

Note

For testing purposes, you may find it easier to install on a virtual machine using Vagrant. See the Quick Start Guide

Technical requirements

Operating system

Archivematica 1.7.0 installation instructions are provided here for the following operating systems:

  • Ubuntu 14.04 64-bit Server Edition
  • Ubuntu 16.04 64-bit Server Edition (beta)
  • CentOS 7 64-bit

Archivematica 1.7 is the first release to be tested on Ubuntu 16.04. Support for this OS is still considered beta; installation has been tested but production deployments are limited.

Other Linux distributions should work, but will require customization of these installation instructions.

Support for macOS is possibly in theory, but is not being tested, and would require more significant deviation from these instructions.

Archivematica is unlikely to ever run directly in a Windows environment. Consider the use of a virtualization platform to run Linux VMs.

Dependencies

Archivematica has a long list of software it depends on. All of these dependencies are installed when following the instructions below.

Note that it is possible to install some of the components on separate machines in order to improve performance, such as:

  • MySQL
  • Gearman
  • Elasticsearch (optional as of Archivematica 1.7, see below)

Using additional machines will require additional configuration. For more information, see Advanced.

Note

Archivematica 1.7 has been tested with MySQL 5.5, including the Percona and MariaDB alternatives. Archivematica uses MySQL 5.7 on Ubuntu 16.04.

Some of the tools run by Archivematica require Java to be installed (primarily Elasticsearch and fits). On Ubuntu 14.04, Open JDK 7 is used. On Ubuntu 16.04, Open JDK 8 is the default. It is possible to use Oracle Java 7 or 8 instead.

The remaining dependencies should be kept at the versions installed by Archivematica.

Elasticsearch

Installing Elasticsearch to provide a search index is now optional as of Archivematica version 1.7. Installing Archivematica without Elasticsearch means reduced consumption of compute resources and lower operational complexity. However, some functionality, such as the Backlog, Appraisal and Archival Storage tabs, is not available.

When Elasticsearch is used, Archivematica 1.7.0 requires version 1.x (tested with 1.7.6). Support for a more recent version of Elasticsearch is being developed and is planned for a future release.

Hardware

Archivematica is capable of running on almost any hardware supported by Linux; however, processing large collections will require better hardware.

Minimum hardware requirements

For small-scale functionality testing using small collections (transfers with 100 files or less, total file size 1 GB or smaller), we recommend the following minimum hardware requirements:

  • Processor: 2 CPU cores
  • Memory: 2GB+
  • Disk space (processing): 7GB plus two to three times the disk space required for the collection being processed (e.g., 3GB to process a 1GB transfer)

Instructions for new installations

Archivematica can be installed using packages or Ansible scripts in either CentOS/Red Hat or Ubuntu environments. It can also be installed using Docker. At this time, installation instructions are provided for officially tested and supported installation environments:

Manual install of OS packages on Ubuntu (14.04 and 16.04) is documented but not officially supported.

Installing Archivematica using Docker is not officially supported for production deployments. However, it is the preferred development environment for those who work on Archivematica’s code.

For more information about installation environments, please see the ansible-archivematica-src repo, the deploy-pub repo, and ask on the archivematica-tech mailing list for more details.

If you are upgrading from a previous version of Archivematica, please see the upgrading instructions.

Advanced installation options

There are many ways to install Archivematica, depending on the needs of the individual user. We have documented some common advanced installation setups.

Back to the top