System Requirements#

Arches works on Linux, Windows, or macOS. Most production implementations use Linux servers.

To begin development or make a test installation of Arches, you will need the following minimum resources:

Disk Space:
  • 2GB for all dependencies and Arches.

  • 8GB to store uploaded files, database backups, etc.

  • Depending on how many uploaded files (images, 3d models, etc) you will have, you may need much more disk space. We advise an early evaulation of how much space you think you’ll need, and then provision twice as much just to be safe…

Memory (RAM):
  • 4GB

  • This recommendation is based on the fact that ElasticSearch requires 2GB to run, and as per official ElasticSearch documentation no more than half of your system’s memory should be dedicated to ElasticSearch.

  • In production, you very likely need to increase your memory. In building the production (minified) frontend asset bundle, yarn (all by itself!) will require at least 8GB to run. If you don’t have enough memory, yarn will likely return an error, sometimes after several minutes or hours of processing. In production, you may also find it useful to allow ElasticSearch to use up to 32GB.

Software Dependencies#

Arches requires the following software packages to be installed and available. Ubuntu Linux users see below for an installation script.

Python >= 3.10:
Git >= 2.0:
PostgreSQL >= 12 with PostGIS 3:
  • macOS Use

  • Windows Use the EnterpriseDB installers, and use Stack Builder (included) to get PostGIS. After installation, add the following to your system’s PATH environment variable: C:\Program Files\PostgreSQL\12\bin. Make sure you write down the password that you assign to the postgres user.

Elasticsearch 8:
GDAL >= 2.2.x:
  • Windows Use the OSGeo4W installer, and choose to install the GDAL package (you don’t need QGIS or GRASS). After installation, add C:\OSGeo4W64\bin to your system’s PATH environment variable.

Node.js 16.x (recommended):
  • Installation: (choose the installer appropriate to your operating system).

  • NOTE: Arches may not be compatible with later versions of Node.js (after 16) (see discussion).

Yarn >= 1.22, < 2:

To support long-running task management, like large user downloads, you must install a Celery broker like RabbitMQ or Redis:


Scripted Dependency Installation#

For Ubuntu we maintain an script to install dependencies. It works for 18.04 and 20.04, and preliminary testing shows it to be compatible with 22.04 as well.

source ./

You will be prompted before each dependency is installed, or use yes | source ./ to install all components (Postgres/PostGIS, Node/Yarn, and ElasticSearch).