You're viewing version 2.5 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-2.5.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. 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-2.5.0 folder.
      2. If desired, modify opensearch_dashboards.yml located in the config folder, to change the default OpenSearch Dashboards settings.
      3. 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-2.5.0
         

      3. If desired, modify config\opensearch_dashboards.yml.
      4. 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.