https://github.com/santthosh/aws-es-kibana

AWS ElasticSearch Kibana Proxy
https://github.com/santthosh/aws-es-kibana

aws docker-container elasticsearch kibana-proxy proxy

Last synced: 3 days ago
JSON representation

AWS ElasticSearch Kibana Proxy

• Host: GitHub
• URL: https://github.com/santthosh/aws-es-kibana
• Owner: santthosh
• License: apache-2.0
• Created: 2016-03-30T12:09:29.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2023-09-23T22:15:20.000Z (over 1 year ago)
• Last Synced: 2025-02-10T12:06:51.672Z (10 days ago)
• Topics: aws, docker-container, elasticsearch, kibana-proxy, proxy
• Language: JavaScript
• Size: 231 KB
• Stars: 319
• Watchers: 11
• Forks: 134
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![npm version](https://badge.fury.io/js/aws-es-kibana.svg)](https://badge.fury.io/js/aws-es-kibana) ![dependencies](https://david-dm.org/santthosh/aws-es-kibana.svg)

[![Docker Stars](https://img.shields.io/docker/stars/santthosh/aws-es-kibana.svg)](https://registry.hub.docker.com/v2/repositories/santthosh/aws-es-kibana/stars/count/)

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/santthosh/aws-es-kibana)

# AWS ES/Kibana Proxy

AWS ElasticSearch/Kibana Proxy to access your [AWS ES](https://aws.amazon.com/elasticsearch-service/) cluster. 

This is the solution for accessing your cluster if you have [configured access policies](http://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-createupdatedomains.html#es-createdomain-configure-access-policies) for your ES domain

## Usage

Install the npm module 

    npm install -g aws-es-kibana

    

Set AWS credentials

                          

    export AWS_ACCESS_KEY_ID=XXXXXXXXXXXXXXXXXXX

    export AWS_SECRET_ACCESS_KEY=XXXXXXXXXXXXXXXXXXX

Run the proxy (do not include the `http` or `https` from your `cluster-endpoint` or the proxy won't function)

    aws-es-kibana 

Where cluster-endpoint can be either a URL (i.e. https://search-xxxxx.us-west-2.es.amazonaws.com) or a hostname (i.e. search-xxxxx.us-west-2.es.amazonaws.com). 

Alternatively, you can set the _AWS_PROFILE_ environment variable

    AWS_PROFILE=myprofile aws-es-kibana 

    

Example with hostname as cluster-endpoint:

![aws-es-kibana](https://raw.githubusercontent.com/santthosh/aws-es-kibana/master/aws-es-kibana.png)

### Run within docker container

If you are familiar with Docker, you can run `aws-es-kibana` within a Docker container

You can pull the official container for use

    docker pull santthosh/aws-es-kibana:latest

(or) Build the image

	docker build -t aws-es-kibana .

Run the container (do not forget to pass the required environment variables)

	docker run -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -p 127.0.0.1:9200:9200 aws-es-kibana -b 0.0.0.0 

## Credits

Adopted from this [gist](https://gist.github.com/nakedible-p/ad95dfb1c16e75af1ad5). Thanks [@nakedible-p](https://github.com/nakedible-p)