Contact Us

Installing Mach5 Search on Google Cloud with BigQuery as the Data warehouse

This page contains instructions on how to deploy Mach5 Search as a fully-functional Google Compute Engine Virtual Machine Instance, using BigQuery to store your data.


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

  1. Install the gcloud CLI (see installation details)
  2. Authorize gcloud to access the Cloud Platform with Google user credentials. Run the following command if you haven’t logged in already -
      gcloud auth login
  3. Set up a valid GCP project with Billing enabled (click here to know more about how to set a project with gcloud) -
      gcloud config set project PROJECT_ID
  4. Make sure you have port 8888 available for Mach5 Search
  5. Make sure the configured user has permissions to -
    • roles/iam.securityAdmin
    • roles/iam.serviceAccountCreator
    • roles/bigquery.dataOwner
    • roles/iam.serviceAccountUser
    • roles/compute.instanceAdmin.v1

Installation instructions:

Run the following command in your terminal and your VM will be up and running in less than 5 minutes -

wget -O - | bash

After the installation is successfully completed, you will have a Mach5 Search instance running within your Google Cloud Project. 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.