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.
Prerequisites
Make sure you have the following before you start with the installation:
- Install the AWS CLI (see installation details)
- Authorize aws cli with the user credentials. Run the following command if you haven’t logged in already -
aws configure
- Make sure you have port 8888 available for Mach5 Search.
- 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 - https://storage.googleapis.com/mach5-community/get_mach5_aws_s3.sh | 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
- Chat with us on our Discord channel
- Send us an email at info@mach5.io, and we'll get back to you within 24 hours.
