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

Windows

Every single piece of software required by AtoM is compatible with Windows. However, you should know that the process may not be straightforward at all if you are not familiar with server environments under the Windows platform.

Artefactual does not test installations on non-Ubuntu platforms, so we are only able to offer limited support - we suggest trying to coordinate with other users via our User forum. We’ve tried to provide a few suggestions below to get you started.

Virtualizing Linux

We strongly believe that Linux is the best choice for installing AtoM, but if for whatever reason you are unable to switch to a different platform, you may want to consider running a virtualized Linux instance in Windows. Some of the most popular virtualization tools in Windows are:

You should be able to use a virtual appliance in the virtualization tool of your choice. However, Artefactual does not maintain production-ready virtual applicances - so you will need an experienced technical administator to help you create and configure one if that is the approach you’d like to take. We do provide a Vagrant box for developers and users interested in testing AtoM on their laptops, but the Vagrant box is not intended for production use!

See also

If you intend to continue using Windows, please proceed by following the instructions provided below. Be warned that installing AtoM in a Windows environment can be tricky, however, so be prepared for some hassle!

Web servers

The good news is that the support of PHP in IIS 7 or above is excellent. Check out the official website: http://php.iis.net.

You can also use Apache or Nginx; we have tried both and had success with Windows configurations.

There is also the option of using WampServer or XAMPP, two software stacks that provide you with all the packages that you need in order to run AtoM out of the box: MySQL, Apache and PHP. It’s definitely a very good option for inexperienced users.

Elasticsearch

You can run Elasticsearch in Windows as long as you can install Java. Download the latest version available and run bin/elasticsearch.bat in the Windows Terminal.