This is an earlier version of the OpenSearch documentation. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Run OpenSearch Dashboards using RPM Package Manager (RPM)

OpenSearch Dashboards is the default visualization tool for data in OpenSearch. It also serves as a user interface for many of the OpenSearch plugins, including security, alerting, Index State Management, SQL, and more.

Install OpenSearch Dashboards from a package

1. Download the RPM package for the desired version directly from the OpenSearch downloads page. The RPM package can be download for both x64 and arm64 architectures.
2. Import the public GPG key. This key verifies that your OpenSearch instance is signed.

    sudo rpm --import https://artifacts.opensearch.org/publickeys/opensearch.pgp
   

3. From the command line interface (CLI), you can install the package with rpm or yum. x64

    # Install the x64 package using yum.
    sudo yum install opensearch-dashboards-1.3.9-linux-x64.rpm
    # Install the x64 package using rpm.
    sudo rpm -ivh opensearch-dashboards-1.3.9-linux-x64.rpm
   

   arm64

    # Install the arm64 package using yum.
    sudo yum install opensearch-dashboards-1.3.9-linux-arm64.rpm
    # Install the arm64 package using rpm.
    sudo rpm -ivh opensearch-dashboards-1.3.9-linux-arm64.rpm
   

4. After the installation succeeds, enable OpenSearch Dashboards as a service.

    sudo systemctl enable opensearch-dashboards
   

5. Start OpenSearch Dashboards.

    sudo systemctl start opensearch-dashboards
   

6. Verify that OpenSearch Dashboards launched correctly.

    sudo systemctl status opensearch-dashboards
   

Install OpenSearch Dashboards from a local YUM repository

YUM, the primary package management tool for Red Hat-based operating systems, allows you to download and install the RPM package from the YUM repository library.

1. Create a local repository file for OpenSearch Dashboards:

   sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/1.x/opensearch-dashboards-1.x.repo -o /etc/yum.repos.d/opensearch-dashboards-1.x.repo
   

2. Verify that the repository was created successfully.

    sudo yum repolist
   

3. Clean your YUM cache, to ensure a smooth installation:

   sudo yum clean all
   

4. With the repository file downloaded, list all available versions of OpenSearch-Dashboards:

   sudo yum list opensearch-dashboards --showduplicates
   

5. Choose the version of OpenSearch Dashboards you want to install:
   • Unless otherwise indicated, the highest minor version of OpenSearch installs.

     sudo yum install opensearch-dashboards
     

   • To install a specific version of OpenSearch Dashboards:

     sudo yum install 'opensearch-dashboards-1.3.9'
     

6. During installation, the installer will present you with the GPG key fingerprint. Verify that the information matches the following:

   Fingerprint: c5b7 4989 65ef d1c2 924b a9d5 39d3 1987 9310 d3fc
   

   • If correct, enter yes or y. The OpenSearch installation continues.
7. Once complete, you can run OpenSearch Dashboards.

    sudo systemctl start opensearch-dashboards