Version 2.1 is a legacy release, and these documents are no longer being maintained.


Hardware and server environment

Please note that it is difficult to provide an authoritative baseline or recommended system specification for running AtoM because what is considered an “acceptable” performance level is subjective, and the performance of the application depends greatly on factors such as the how much data is in the database, and how many users are accessing the site simultaneously.

Furthermore, AtoM makes use of different components and services that could be deployed in a distributed manner (across multiple machines in a network) in order to accept an escalating number of users. The main goal of this documentation is to describe the configuration of AtoM and its dependencies on a single machine, but some aspects of a Multi-node deployment will also be described.

Software dependencies (required)

These are the minimum requirements, but please remember that in most of the cases you’ll experience better results working with the latest stable releases of each component.

  • A webserver like Apache or Nginx; Artefactual prefers the latter in development
  • Elasticsearch 1.3.0 or newer
  • MySQL 5.1 or newer
  • PHP 5.3.10 or newer (PHP 5.4 and PHP 5.5 work too)

Additionally, the following PHP extensions are mandatory:

  • cURL (php5-curl)
  • JSON (php5-json)
  • APC (php-apc, or php5-apcu in PHP 5.5)
  • PDO and PDO-MySQL (php5-mysql)
  • XSL (php5-xsl)
  • Readline (php5-readline, required in 14.04 only)


All these dependencies can run in a number of different operative systems, including Windows, Mac OS X, Solaris, FreeBSD or Linux. This documentation is based in Ubuntu Linux 12.04/14.04 LTS as it seems to be one of the most widely used Linux distributions. However, it should serve as a reference for other environments and distro flavours - we’ve also written specific guides for other operating systems such as Windows and :ref :installation-macosx.