+++
title = "Which Elasticsearch & OpenSearch Versions Bonsai Supports"
weight = 79
updated = 2026-10-08
aliases = ["/docs/which-versions-bonsai-supports", "/docs/managed-search/elasticsearch-and-opensearch/version-support/", "/docs/deployment/version-support/"]

[extra]
nav_title = "Supported Versions"
weight = 80
+++

Bonsai supports a large number of Elasticsearch versions in regions all over the
world. [Multitenant class](@/docs/platform/bonsai-architecture/index.md) clusters
usually have more limited options in terms of
available regions and versions,
while [single tenant](@/docs/platform/bonsai-architecture/index.md) class clusters
have far more
options.

If you need a version or geographic region that is not listed
here, [reach out to our support](mailto:support@bonsai.io) and let us know what
you need. We can get you a quote and timeline for getting up and running.

Versions are listed by major version; new clusters get the latest release we support within it.

## Multitenant Class

Bonsai operates a fleet
of [shared resource](@/docs/platform/bonsai-architecture/index.md) nodes in Oregon,
Virginia, Ireland,
Frankfurt, and Sydney. The Elasticsearch versions available on these nodes do
not change often.

Sandbox clusters run the latest version of OpenSearch we support and may
be subject to automatic upgrades when a new version is released.

For all other multitenant plans, when Bonsai adds support for a new version, we
will create a new server group rather than upgrading an existing group. The
exception to this is a potential patch upgrade in response to some critical
vulnerability. In other words, users will not be upgraded in place unless there
is a vulnerability to address or if they are on a Sandbox plan.
Read [How Bonsai Handles Elasticsearch Releases](@/docs/cluster-management/version-upgrades/how-bonsai-handle-version-releases/index.md)
for more information.

This table shows which versions of Elasticsearch are available for multitenant
plans.

| Plan                  | Elasticsearch Versions | OpenSearch Versions |
|:----------------------|:-----------------------|:--------------------|
| Sandbox               | —                      | 3                   |
| All other multitenant | 7                      | 2 / 3               |

## Multitenant Version Support by Region

Multitenant plans are supported in a handful of popular regions, although the
versions available to free plans is limited. Additional regions are available to
Business and Enterprise subscriptions.

| Cloud | Region    | Location      | Elasticsearch 7 | OpenSearch 2   | OpenSearch 3         |
|:------|:----------|:--------------|:----------------|:---------------|:---------------------|
| AWS   | us-east-1 | Virginia, USA | Standard Plans  | Standard Plans | Standard, Free Plans |
| AWS   | us-west-2 | Oregon, USA   | Standard Plans  | —              | Standard Plans       |
| AWS   | eu-west-1 | Ireland, EU   | Standard Plans  | Standard Plans | Standard Plans       |

Free plans are only offered in us-east-1 (Virginia, USA).

## Heroku Add-ons

Heroku add-ons have their own list of versions, and default to OpenSearch on
every plan.

If the engine or version you request isn't available for your plan in your
app's region, the add-on is not created. See
[Choosing a search engine and version](@/docs/heroku/add-bonsai-to-your-heroku-app/index.md#choosing-a-search-engine-and-version)
for how to request one.

## Heroku Hobby and Ephemeral Plans

The free Heroku Hobby plan, the Staging plan, and ephemeral add-ons (the ones
Heroku creates for Review Apps and CI) are only available as
**OpenSearch 3** in **AWS us-east-1** (Virginia, USA). Asking these plans
for Elasticsearch or another version fails, and the add-on is not created.

Heroku creates add-ons in the same region as the app, so a Hobby, Staging, or
ephemeral add-on for an app outside Heroku's US region (for example, Europe)
will be refused. For apps in those regions, use a Standard or Business plan instead. Review
Apps and CI apps get Bonsai's review-app plan, whatever plan `app.json` names,
so Bonsai is only available to Review Apps and CI apps in Heroku's US region. See
[Add Bonsai to your Heroku app](@/docs/heroku/add-bonsai-to-your-heroku-app/index.md#review-apps-and-heroku-ci)
for the `app.json` details.

## Single Tenant Class

Single tenant clusters can be deployed in Oregon, Virginia, Ireland, Frankfurt,
Sydney, and Tokyo. We support a variety of Elasticsearch versions for these
kinds of clusters and will default to the most recent minor version unless
something else is specified.

This table shows which versions of Elasticsearch are available for single tenant
plans.

| Plan              | Elasticsearch Versions | OpenSearch Versions |
|:------------------|:-----------------------|:--------------------|
| All single tenant | 7 to 9                 | 2 to 3              |

## Enterprise Deployments

Bonsai can deploy and manage whichever version of Elasticsearch or OpenSearch
your use case needs. Please reach out to us
at [support@bonsai.io](mailto:support@bonsai.io).

## Older Search Engine Version Pricing

For major search engine versions behind Bonsai's current primary supported
version (OpenSearch 2.x and Elasticsearch 7.x), clusters will be charged an
operational and maintenance fee to ensure that we can continue to support these
older versions, and that we can give your organization the time it needs to
decide when to upgrade to a new major version.

The fee will be assessed based on the following table:

| Search Engine Version               | Operational Fee |
|:------------------------------------|:----------------|
| OpenSearch 1.x or Elasticsearch 6.x | 20%             |
| Elasticsearch 5.x                   | 15% additional  |
| Elasticsearch 2.x                   | 10% additional  |
| Elasticsearch 1.x                   | 5% additional   |
