SearchBlox can run within a Docker container.

🚧



SearchBlox docker image requires a minimum of 10GB disk space, 16GB RAM and 2 CPUs.

### Steps to run SearchBlox within Docker container

1. Install docker desktop on your system

2. Once the installation is complete launch the docker desktop application.

3. Click on the Images tab on the left side and then select Remote Repositories and select searchblox repository.

4. Click on pull on the right-hand side corresponding to the searchblox/searchblox image. _Use the docker pull command if you use docker CLI mode_: `docker pull searchblox/searchblox:v10.1`

5. Once the image is pulled it will show up in the Local tab.

6. Run the docker image using the following command in command prompt: `docker run -p 8443:8443 -p 8444:8444 -p 8446:8446 searchblox/searchblox:v10.1`

7. Open the SearchBlox Admin console with the following link once SearchBlox starts https://localhost:8443/console

8. Open Connectors Framework console with the following link https://localhost:8446

### SearchBlox Installation on Docker using third party Elasticsearch Integration

We recommend you to use the latest version of Elasticsearch considering security reasons. SearchBlox is tested with the latest Elasticsearch v7.17 on Elastic Cloud and Amazon Elasticsearch Service.

#### Elastic Cloud

The command to pull docker image to run SearchBlox using elastic cloud

`docker pull searchblox/searchblox:searchblox-enterprise-search-elastic-cloud-10.1`

Command reference to run the pulled docker image is

`docker run -e ES_HOST_NAME=<elastic cloud endpoint> -e ES_HOST_PORT=<elastic-cloud-port> -e ES_USR=<elastic-cloud-username> -e ES_PWD=<elastic-cloud-password> -p 8443:8443 -p <elastic-cloud-port>:<elastic-cloud-port> -p 8446:8446 searchblox/searchblox:searchblox-enterprise-search-elastic-cloud-10.1`

In the above command -e is used to specify the environment variables, -p is used to expose the port numbers outside the docker container.

All the environment variables are mandatory while using the docker run command. List of environment variables used in the command:

#### AWS Elasticsearch

The command to pull docker image to run SearchBlox using AWS Elasticsearch is:

`docker pull searchblox/searchblox:searchblox-enterprise-search-aws-elasticsearch-service-10.1`

Command reference to run the pulled docker image is:

`docker run -e AWS_ACCESS_KEY=<access-key> -e AWS_SECRET_KEY=<secret-key> -e AWS_ES_ENDPOINT=<aws-elastic-endpoint> -e AWS_REGION=<aws-region> -p 8443:8443 -p 8446:8446 searchblox/searchblox:searchblox-enterprise-search-aws-elasticsearch-service-10.1`

In the above command -e is used to specify the environment variables, -p is used to expose the port numbers outside the docker container.

All the environment variables are mandatory while using the docker run command. List of environment variables used:

📘

Note:

You can go inside the docker container and configure Elasticsearch settings within the SearchBlox YAML files and execute the run command without using environment variables. _References_: [SearchBlox for Elastic Cloud](🔗) [SearchBlox for AWS Elasticsearch](🔗)