explaingit

qax-os/elastichd

3,755GoAudience · ops devopsComplexity · 2/5LicenseSetup · easy

TLDR

ElasticHD is a browser-based dashboard for managing Elasticsearch that lets you search data, manage indices, and write queries in plain SQL, all without installing anything beyond a single binary.

Mindmap

mindmap
  root((ElasticHD))
    What it does
      ES management UI
      Browser dashboard
      SQL to DSL converter
    Features
      Live data view
      Index management
      Type mapping editor
      Responsive layout
    SQL Support
      SELECT WHERE
      GROUP BY ORDER BY
      COUNT AVG MIN MAX
      Date histograms
    Setup
      Single binary
      Docker image
      Run with port flag
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Browse and search your Elasticsearch data from any browser without using command-line tools or raw JSON queries

USE CASE 2

Write a familiar SQL SELECT query and have ElasticHD automatically translate it to Elasticsearch DSL for you

USE CASE 3

Inspect and manage your Elasticsearch indices, type mappings, and live data from a mobile-friendly web interface

USE CASE 4

Connect to a password-protected Elasticsearch cluster by passing credentials directly in the URL when starting the dashboard

Tech stack

GoJavaScriptDocker

Getting it running

Difficulty · easy Time to first run · 5min
MIT, use freely for any purpose including commercial, with no conditions beyond keeping the copyright notice.

In plain English

ElasticHD is a visual management dashboard for Elasticsearch, a database system commonly used to store and search large amounts of text data. Instead of interacting with Elasticsearch through command-line tools or writing raw queries by hand, ElasticHD gives you a web interface that runs in any browser, with no additional software required beyond the single downloaded executable. The dashboard covers the common day-to-day tasks for managing an Elasticsearch setup. You can view live data, run searches, inspect and manage indices (which are like tables in a traditional database), and edit type mappings that control how data fields are stored. The interface adjusts to any screen size, so it can be used on desktops, tablets, or phones. One of the more distinctive features is a SQL-to-DSL converter. Elasticsearch uses its own query language called DSL (Domain Specific Language) that looks quite different from standard SQL. ElasticHD lets you write familiar SQL statements, such as SELECT, WHERE, GROUP BY, ORDER BY, and aggregation functions like COUNT, AVG, MIN, and MAX, and it translates them automatically into the equivalent Elasticsearch DSL. It also supports Elasticsearch-specific query types like date histograms, range grouping, and top-hits that go beyond what standard SQL covers. Setting it up is straightforward: download the pre-compiled binary for your operating system, run it from the command line with a port number, and open the resulting address in a browser. A Docker image is also available for containerized environments. If your Elasticsearch server requires a username and password, you include those directly in the connection URL. The project is licensed under the MIT License. Compatible with all versions of Elasticsearch.

Copy-paste prompts

Prompt 1
I have an Elasticsearch cluster running locally, show me the ElasticHD startup command to connect to it and open the dashboard on port 9800.
Prompt 2
Help me write an ElasticHD SQL query using GROUP BY and AVG to get the average response time per API endpoint from my logs index.
Prompt 3
My Elasticsearch index mapping needs to be updated, show me how to use ElasticHD's interface to edit the mapping for an existing index.
Prompt 4
I want to run ElasticHD with Docker against a remote Elasticsearch cluster that requires basic authentication, show me the docker run command with credentials.
Open on GitHub → Explain another repo

← qax-os on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.