Loading

Elasticsearch Add-On for Heroku

Elastic Cloud Hosted

This documentation applies to Heroku users who want to make use of the Elasticsearch Add-On for Heroku that is available from the Heroku Dashboard, or that can be installed from the CLI.

The add-on runs on Elastic Cloud and provides access to Elasticsearch, the open source, distributed, RESTful search engine. Many other features of the Elastic Stack are also readily available to Heroku users through the Elasticsearch Add-On for Heroku console after you install the add-on. For example, you can use Kibana to visualize your Elasticsearch data.

To learn more about what plans are available for Heroku users and their cost, refer to the Elasticsearch add-on in the Elements Marketplace.

Warning

The Elasticsearch Add-on for Heroku has several limitations that do not apply to other Elastic Cloud sign-up methods. To get access to all Elastic Cloud functionality, consider signing up using another method.

Not all features of Elastic Cloud are available to Heroku users. Specifically, you cannot create additional deployments or use different deployment templates.

Generally, if a feature is shown as available in the Elasticsearch Add-on for Heroku console, you can use it.

Elasticsearch Machine Learning, Elastic APM and Elastic Fleet Server are not supported by the Elasticsearch Add-On for Heroku.

For other restrictions that apply to all of Elastic Cloud, refer to Restrictions and known problems.

To get started with the Elasticsearch Add-on for Heroku, install the add-on.

After you install, you can access your deployment:

The Elasticsearch Add-on for Heroku in on specific AWS regions only. To learn about the supported AWS regions and hardware, refer to the following pages:

Find more information about Elastic Cloud Hosted on the following pages. This information is subject to the Elasticsearch Add-on for Heroku limitations.

After have provisioned your first deployment, you’re ready to index data into the deployment and explore the advanced capabilities of Elasticsearch Add-on for Heroku.

There are several ways to ingest data into the deployment:

  • Use the sample data available from the Kibana home page without loading your own data. There are multiple data sets available and you can add them with one click.
  • Ingest your own data. Learn more.
  • Have existing Elasticsearch data? Consider your migration options.

You might want to add more layers of security to your deployment, such as:

  • Add more users to the deployment with third-party authentication providers and services like SAML, OpenID Connect, or Kerberos.
  • Do not use clients that only support HTTP to connect to Elastic Cloud. If you need to do so, you should use a reverse proxy setup.
  • Create traffic filters and apply them to your deployments.
  • If needed, you can reset the elastic password.

You might find that you need a larger deployment for the workload, or upgrade the Elasticsearch version for the latest features. All of this can be done after provisioning by changing your deployment configuration.