A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://github.com/elastic/start-local below:

elastic/start-local: Try Elasticsearch and Kibana locally

🚀 Try Elasticsearch and Kibana locally

Run Elasticsearch and Kibana on your local machine using a simple shell script. This setup uses Docker behind the scenes to install and run the services.

Important

This script is for local testing only. Do not use it in production! For production installations refer to the official documentation for Elasticsearch and Kibana.

This script comes with a one-month trial license. After the trial period, the license reverts to Free and open - Basic.

For a complete list of subscriptions and features, see our subscriptions page.

Run the start-local script using curl:

curl -fsSL https://elastic.co/start-local | sh

This script creates an elastic-start-local folder containing:

Select the version to install

By default, start-local uses the latest stable version of Elastic Stack. If you want, you can specify a different version using the -v parameter, as follows:

curl -fsSL https://elastic.co/start-local | sh -s -- -v 8.16.0

The previous command installs Elasticsearch and Kibana 8.16.0.

Using the -v parameter, you can also install beta releases, this can be useful for testing an upcoming release. For instance, you can install the 9.0.0-beta1 using the following command:

curl -fsSL https://elastic.co/start-local | sh -s -- -v 9.0.0-beta1

The 9.0.0-beta1 version was released on February 18, 2025.

Install only Elasticsearch

If you want to install only Elasticsearch, without Kibana, you can use the --esonly option as follows:

curl -fsSL https://elastic.co/start-local | sh -s -- --esonly

This command can be useful if you don't have enough resources and want to test only Elasticsearch.

After running the script:

The script generates a random password for the elastic user, displayed at the end of the installation and stored in the .env file.

Caution

HTTPS is disabled, and Basic authentication is used for Elasticsearch. This configuration is for local testing only. For security, Elasticsearch and Kibana are accessible only via localhost.

An API key for Elasticsearch is generated and stored in the .env file as ES_LOCAL_API_KEY. Use this key to connect to Elasticsearch with the Elastic SDK or REST API.

Check the connection to Elasticsearch using curl in the elastic-start-local folder:

source .env
curl $ES_LOCAL_URL -H "Authorization: ApiKey ${ES_LOCAL_API_KEY}"
🐳 Start and stop the services

You can use the start and stop commands available in the elastic-start-local folder.

To stop the Elasticsearch and Kibana Docker services, use the stop command:

cd elastic-start-local
./stop.sh

To start the Elasticsearch and Kibana Docker services, use the start command:

cd elastic-start-local
./start.sh

Docker Compose.

To remove the start-local installation:

cd elastic-start-local
./uninstall.sh

Warning

This erases all data permanently.

If the installation fails, an error log is created in error-start-local.log. This file contains logs from Elasticsearch and Kibana, captured using the docker logs command.

To change settings (e.g., Elasticsearch password), edit the .env file. Example contents:

ES_LOCAL_VERSION=8.15.2
ES_LOCAL_URL=http://localhost:9200
ES_LOCAL_CONTAINER_NAME=es-local-dev
ES_LOCAL_DOCKER_NETWORK=elastic-net
ES_LOCAL_PASSWORD=hOalVFrN
ES_LOCAL_PORT=9200
KIBANA_LOCAL_CONTAINER_NAME=kibana-local-dev
KIBANA_LOCAL_PORT=5601
KIBANA_LOCAL_PASSWORD=YJFbhLJL
ES_LOCAL_API_KEY=df34grtk...==

Important

After changing the .env file, restart the services using stop and start:

cd elastic-start-local
./stop.sh
./start.sh
⚠️ Advanced settings with ENV variables

We offer some environment (ENV) variables for changing the settings of start-local. We suggest to use these ENV variables only for advanced use cases, e.g. CI/CD integrations. Please use caution when using these settings.

If you need to set the Elasticsearch password manually, you can do it using the ES_LOCAL_PASSWORD.

You need to set the env variable before the execution of the script, as follows:

curl -fsSL https://elastic.co/start-local | ES_LOCAL_PASSWORD="supersecret" sh

This command will set the supersecret password for Elasticsearch.

Please note that this command can be dangerous if you use a weak password for Elasticsearch authentication.

By default, start-local creates an elastic-start-local folder. If you need to change it, you can use the ES_LOCAL_DIR env variable, as follows:

curl -fsSL https://elastic.co/start-local | ES_LOCAL_DIR="another-folder" sh

This command will creates the another-folder containing all the start-local files.

We use bashunit to test the script. Tests are in the /tests folder.

  1. Install bashunit:

    curl -s https://bashunit.typeddevs.com/install.sh | bash
  2. Run tests:

The tests run start-local.sh and check if Elasticsearch and Kibana are working.

Note

For URL pipeline testing, a local web server is used. This requires PHP.


RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4