Contact Us

Installing Mach5 Search on AWS with S3 as the Data warehouse

This page contains instructions on how to deploy Mach5 Search as a fully-functional AWS Virtual Machine Instance, using an S3 bucket to store your data.


Make sure you have the following before you start with the installation:

  1. Install the AWS CLI (see installation details)
  2. Authorize aws cli with the user credentials. Run the following command if you haven’t logged in already -
    aws configure
  3. Make sure you have port 8888 available for Mach5 Search.
  4. Make sure the configured user has full access to AWS EC2 and S3 and ability to create roles and instance profiles in IAM.

Run the following command in your terminal and your VM will be up and running in less than 10 minutes (Note that the installation script below assumes the user’s default profile)

wget -O - | bash

After the installation is successfully completed, you will have a Mach5 Search instance running within your AWS environment. Navigate to the http://localhost:8888 to access the Mach5 Search Web UI.

What’s next?

The Mach5 UI has sample datasets and dashboards that you can play around with. Alternatively, you can index your own data and query it using ElasticSearch Compatible APIs available at http://localhost:8888/os/ . The UI also enables you to create Custom Visualizations and Dashboards.

Need Help?

If you're having trouble getting started, please let us know, and we'll guide you through it. You can reach us via

  1. Chat with us on our Discord channel
  2. Send us an email at, and we'll get back to you within 24 hours.
© 2021-2023 Mach5 Software, Inc. All rights reserved

When you visit or interact with our sites, services or tools, we or our authorised service providers may use cookies for storing information to help provide you with a better, faster and safer experience and for marketing purposes.