Newer
Older
cerebro is an open source(MIT License) elasticsearch web admin tool.
##Installation
- Download from [https://github.com/lmenezes/cerebro/releases](https://github.com/lmenezes/cerebro/releases)
- Run bin/cerebro(or bin/cerebro.bat if on Windows)
- Access on http://localhost:9000
Some settings in cerebro can be set by specifying them as Java System properties, while others need to be specified on the configuration file(conf/application.conf).
For an extensive list of Java System properties accepted, check https://www.playframework.com/documentation/2.5.x/ProductionConfiguration
### HTTP server address and port
You can run cerebro listening on a different port(9000) and host(0.0.0.0):
```
bin/cerebro -Dhttp.port=1234 -Dhttp.address=127.0.0.1
```
### Path of RUNNING_PID
By default, the RUNNING_PID is placed on the root directory of cerebro, but it is recommendable to place it somewhere that is cleared on restart(/var/run). Make sure the location exists and that cerebro has write permissions to it.
```
bin/cerebro -Dpidfile.path=/var/run/cerebro.pid
```
It is also possible to avoid the creation of the RUNNING_PID file by setting the path to /dev/null on the configuration file:
```yaml
pidfile.path = "/dev/null"
```
A list of predefined hosts can be defined for quicker access by editing conf/application.conf file. If host is password protected, authentication should be also set.
```yaml
hosts: [
{
host: http://localhost:9200
},
{
host = "http://some-authenticated-host:9200",
auth = {
username = "username"
password = "secret-password"
}
]