OpenSearch/docs/reference/setup/install.asciidoc

[[install-elasticsearch]]
== Installing Elasticsearch

[float]
=== Hosted Elasticsearch

You can run Elasticsearch on your own hardware, or use our
https://www.elastic.co/cloud/elasticsearch-service[hosted Elasticsearch Service]
on Elastic Cloud. The Elasticsearch Service is available on both AWS and GCP.
{ess-trial}[Try out the
Elasticsearch Service for free].

[float]
=== Installing Elasticsearch Yourself

Elasticsearch is provided in the following package formats:

[horizontal]
Linux and MacOS `tar.gz` archives::

The `tar.gz` archives are available for installation on any Linux distribution and MacOS.
+
<<targz>>

Windows `.zip` archive::

The `zip` archive is suitable for installation on Windows.
+
<<zip-windows>>

`deb`::

The `deb` package is suitable for Debian, Ubuntu, and other Debian-based
systems.  Debian packages may be downloaded from the Elasticsearch website or
from our Debian repository.
+
<<deb>>

`rpm`::

The `rpm` package is suitable for installation on Red Hat, Centos, SLES,
OpenSuSE and other RPM-based systems.  RPMs may be downloaded from the
Elasticsearch website or from our RPM repository.
+
<<rpm>>

`msi`::

beta[] The `msi` package is suitable for installation on Windows 64-bit systems with at least
.NET 4.5 framework installed, and is the easiest choice for getting started with
Elasticsearch on Windows. MSIs may be downloaded from the Elasticsearch website.
+
<<windows>>

`docker`::

Images are available for running Elasticsearch as Docker containers. They may be
downloaded from the Elastic Docker Registry.
+
{ref}/docker.html[Install {es} with Docker]

`brew`::

Formulae are available from the Elastic Homebrew tap for installing
{es} on macOS with the Homebrew package manager.
+
{ref}/brew.html[Install {es} on macOS with Homebrew]

[float]
[[config-mgmt-tools]]
=== Configuration Management Tools

We also provide the following configuration management tools to help with
large deployments:

[horizontal]
Puppet:: https://github.com/elastic/puppet-elasticsearch[puppet-elasticsearch]
Chef::   https://github.com/elastic/cookbook-elasticsearch[cookbook-elasticsearch]
Ansible:: https://github.com/elastic/ansible-elasticsearch[ansible-elasticsearch]


include::install/targz.asciidoc[]

include::install/zip-windows.asciidoc[]

include::install/deb.asciidoc[]

include::install/rpm.asciidoc[]

include::install/windows.asciidoc[]

include::install/docker.asciidoc[]

include::install/brew.asciidoc[]