You're viewing version 3.2 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Run OpenSearch Dashboards on Windows

Perform the following steps to install OpenSearch Dashboards on Windows.

Make sure you have a zip utility installed.

1. Download the opensearch-dashboards-3.2.0-windows-x64.zip archive.

2. To extract the archive contents, right-click to select Extract All.

   Note: Some versions of the Windows operating system limit the file path length. If you encounter a path-length-related error when unzipping the archive, perform the following steps to enable long path support:

   1. Open Powershell by entering powershell in the search box next to Start on the taskbar.
   2. Run the following command in Powershell:

      Set-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem LongPathsEnabled -Type DWORD -Value 1 -Force
      

   3. Restart your computer.

3. Configure OpenSearch Dashboards.

   There are two ways to configure OpenSearch Dashboards, depending on whether OpenSearch is configured with security enabled or disabled.

   In order for any changes to the opensearch_dashboards.yml file to take effect, a restart of OpenSearch Dashboards is required.

   1. Option 1 – With security enabled:

      Configuration file \path\to\opensearch-dashboards-3.2.0\config\opensearch_dashboards.yml comes packaged with following basic settings:

       opensearch.hosts: [https://localhost:9200]
       opensearch.ssl.verificationMode: none
       opensearch.username: kibanaserver
       opensearch.password: kibanaserver
       opensearch.requestHeadersWhitelist: [authorization, securitytenant]
              
       opensearch_security.multitenancy.enabled: true
       opensearch_security.multitenancy.tenants.preferred: [Private, Global]
       opensearch_security.readonly_mode.roles: [kibana_read_only]
       # Use this setting if you are running opensearch-dashboards without https
       opensearch_security.cookie.secure: false
      

   2. Option 2 – With OpenSearch security disabled:

      If you are using OpenSearch with security disabled, remove the Security plugin from OpenSearch Dashboards using the following command:

       \path\to\opensearch-dashboards-3.2.0\bin\opensearch-dashboards-plugin.bat remove securityDashboards
      

      The basic opensearch_dashboards.yml file should contain:

       opensearch.hosts: [http://localhost:9200]
      

      Note the plain http method, instead of https.

4. Run OpenSearch Dashboards.

   There are two ways of running OpenSearch Dashboards:

   1. Run the batch script using the Windows UI:

      1. Navigate to the top directory of your OpenSearch Dashboards installation and open the opensearch-dashboards-3.2.0 folder.
      2. Open the bin folder and run the batch script by double-clicking the opensearch-dashboards.bat file. This opens a command prompt with an OpenSearch Dashboards instance running.

   2. Run the batch script from Command Prompt or Powershell:

      1. Open Command Prompt by entering cmd, or Powershell by entering powershell, in the search box next to Start on the taskbar.
      2. Change to the top directory of your OpenSearch Dashboards installation.

         cd \path\to\opensearch-dashboards-3.2.0
         

      3. Run the batch script to start OpenSearch Dashboards.

         .\bin\opensearch-dashboards.bat
         

To stop OpenSearch Dashboards, press Ctrl+C in Command Prompt or Powershell, or simply close the Command Prompt or Powershell window.