Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/elastic/stack-docker

Project no longer maintained.
https://github.com/elastic/stack-docker

Last synced: about 2 months ago
JSON representation

Project no longer maintained.

Host: GitHub
URL: https://github.com/elastic/stack-docker
Owner: elastic
License: apache-2.0
Archived: true
Created: 2017-02-01T04:01:15.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2020-03-19T20:22:23.000Z (over 4 years ago)
Last Synced: 2024-09-22T02:33:37.682Z (about 2 months ago)
Language: Shell
Homepage:
Size: 177 KB
Stars: 1,183
Watchers: 388
Forks: 450
Open Issues: 33
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# ARCHIVED

This project is no longer maintained. For alternative getting started
experiences, you may want to try one of these options:

- Start a
[free trial on Elastic Cloud](https://www.elastic.co/cloud/elasticsearch-service/signup),
our hosted service.
- Read our
[Running the Elastic Stack on Docker](https://www.elastic.co/guide/en/elastic-stack-get-started/current/get-started-docker.html)
guide.
- Take a look at [our Helm charts](https://github.com/elastic/helm-charts) for
launching the stack via Kubernetes.

# stack-docker
This example Docker Compose configuration demonstrates many components of the
Elastic Stack, all running on a single machine under Docker.

## Prerequisites
- Docker and Docker Compose.
* Windows and Mac users get Compose installed automatically
with Docker for Windows/Mac.

* Linux users can read the [install instructions](https://docs.docker.com/compose/install/#install-compose) or can install via pip:
```
pip install docker-compose
```

* Windows Users must set the following 2 ENV vars:
* `COMPOSE_CONVERT_WINDOWS_PATHS=1`
* `PWD=/path/to/checkout/for/stack-docker`
* for example I use the path: `/c/Users/nick/elastic/stack-docker`
* Note: you're paths must be in the form of `/c/path/to/place` using `C:\path\to\place` will not work
* You can set these two ways:
1. Temporarily add an env var in powershell use: `$Env:COMPOSE_CONVERT_WINDOWS_PATHS=1`
2. Permanently add an env var in powershell use: `[Environment]::SetEnvironmentVariable("COMPOSE_CONVERT_WINDOWS_PATHS", "1", "Machine")`
> Note: you will need to refresh or create a new powershell for this env var to take effect
3. in System Properties add the environment variables.

* At least 4GiB of RAM for the containers. Windows and Mac users _must_
configure their Docker virtual machine to have more than the default 2 GiB of
RAM:

![Docker VM memory settings](screenshots/docker-vm-memory-settings.png)

* Linux Users must set the following configuration as `root`:

```
sysctl -w vm.max_map_count=262144
```
By default, the amount of Virtual Memory [is not enough](https://www.elastic.co/guide/en/elasticsearch/reference/current/vm-max-map-count.html).

## Starting the stack

First we need to:

1. set default password
2. create keystores to store passwords
3. install dashboards, index patterns, etc.. for beats and apm

This is accomplished using the setup.yml file:
```
docker-compose -f setup.yml up
```

Please take note after the setup completes it will output the password
that is used for the `elastic` login.

Now we can launch the stack with `docker-compose up -d` to create a demonstration Elastic Stack with
Elasticsearch, Kibana, Logstash, Auditbeat, Metricbeat, Filebeat, Packetbeat,
and Heartbeat.

Point a browser at [`http://localhost:5601`](http://localhost:5601) to see the results.
> *NOTE*: Elasticsearch is now setup with self-signed certs.