--- title: "OpenSearch With Wasabi" slug: "how-do-i-use-opensearch-with-wasabi" updated: 2026-05-30T23:03:24Z published: 2026-05-30T23:03:24Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt > Use this file to discover all available pages before exploring further. # OpenSearch With Wasabi ### [OpenSearch](https://opensearch.org/) has been validated for use with Wasabi. Follow the instructions below for more information. We are running this on an Ubuntu 24.04 System in single-node mode. You will have to restart the OpenSearch services after installing the "repository-s3" plugin. This procedure should be adjusted to your cluster and tested in a lab environment before attempting on a production system. Additionally, if you are running a different OS, you may need to adjust certain commands to fit your OS. ## Downloading and Configuring the OpenSearch Package 1. Download and extract the [OpenSearch-Package](https://opensearch.org/docs/latest/install-and-configure/). ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718220652902.png) ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718216469925.png) 2. Before running OpenSearch, be sure that the Linux parameter "vm.max_map_count" is at least 262144 and memory paging is Disabled. To stop memory paging, use the following command. ```shell sudo swapoff -a ``` 3. To increase the amount of memory mappings available for OpenSearch, change the following "sysctl" configuration file by adding the following line "vm.max_map_count=262144" to the conf file and restart the Kernel. ```shell sudo vi /etc/sysctl.conf ``` 4. To restart the kernel, execute the following command. ```shell sudo sysctl -p ``` 5. Verify the changes by executing the following command. ```shell cat /proc/sys/vm/max_map_count ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718215634885.png) ## Installing the Plugin and Setting the Wasabi Repository 1. Install the repository-s3 plugin by navigating to the OpenSearch directory that has been extracted. ```shell ./bin/opensearch-plugin install repository-s3 ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718217041264.png) 2. Set a password for OpenSearch using the following command. ```shell export OPENSEARCH_INITIAL_ADMIN_PASSWORD= ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718217421750.png) 3. Configure Wasabi account access keys and secret keys using the following commands. You will need to replace the access key and secret key with keys generated from your Wasabi account. For more information, refer to [3—Creating a User Account and Access Key](https://docs.wasabi.com/docs/creating-a-user-account-and-access-key). ```shell ./bin/opensearch-keystore add s3.client.default.access_key ./bin/opensearch-keystore add s3.client.default.secret_key ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718217485855.png) 4. Open the configuration folder and edit the opensearch.yml config file with the following configuration. Set the default region and endpoint URL per the bucket region that was created in the Wasabi account. ```none plugins.security.disabled: true ### to disable the ssl plugin security s3.client.default.endpoint: s3.ca-central-1.wasabisys.com ### endpoint url s3.client.default.region: ca-central-1 ### bucket region ``` 5. Start the OpenSearch by executing the startup script. ```shell ./opensearch-tar-install.sh ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718218208093.png) 6. From another terminal session, check if the OpenSearch is started by executing the following CURL command on port 9200. ```shell curl -X GET http://localhost:9200 ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718218300819.png) 7. Register the Wasabi bucket as a repository in OpenSearch once it is up and running. Replace the repository name to identify this repository. Replace the bucket name with the name of the bucket that is created in the Wasabi account. ```shell curl -XPUT "http://localhost:9200/_snapshot/ " -H 'Content-Type: application/json' -d' { "type": "s3", "settings": { "bucket": "", "base_path": “" } }' ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718218516644.png) 8. The above CURL command returns the following output after successful execution. ```shell {"acknowledged": true} ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718218572993.png) ## Taking Snapshots 1. To take a snapshot and save in the Wasabi bucket, execute the following command by replacing the repository-name with the name configured in the previous step. The following snapshot includes all indexes and the cluster state. ```shell curl -XPUT "http://localhost:9200/_snapshot//1" ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718219175833.png) You can also add a request body to include or exclude certain indexes or specify other settings. Snapshots can take a while to complete, so consider using this option by adding the query parameters at the end. ```shell curl -XPUT "http://localhost:9200/_snapshot//1?wait_for_completion=true" ``` 2. To check the Snapshot status, execute the following command. ```shell curl -XGET "http://localhost:9200/_snapshot/_status" ``` 3. Verify from the Wasabi Console that the snapshot is successfully saved to the bucket. ## Restoring Snapshots Create the new OpenSearch server and configure the repository to restore the snapshot. 1. Be sure that the basepath and repository name match the repository that was created initially. Once configured, execute the following command to check the list of snapshots that are available. ```shell curl -XGET "http://localhost:9200/_snapshot//_all" ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718219538728.png) 2. To restore the second snapshot, execute the following command by replacing the repository name. Before restoring, ensure that the indices in the snapshot have no naming conflict with the existing indices. ```shell curl -XPOST "http://localhost:9200/_snapshot//2/_restore" ``` ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1718219638045.png) For additional information, contact a Wasabi Customer Support representative: [support@wasabi.com](mailto:support@wasabi.com)