You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/GreedyBear/Installation.md
+9-17Lines changed: 9 additions & 17 deletions
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ The app administrator can enable/disable the extraction of source IPs for specif
39
39
This is used for honeypots that are not specifically implemented to extract additional information (so not Log4Pot and Cowrie).
40
40
41
41
Note that GreedyBear _needs_ a running instance of ElasticSearch of a TPoT to function.
42
-
If you don't have one, you can make the following changes to make GreeyBear spin up it's own ElasticSearch and Kibana instances.
42
+
If you don't have one, you can make the following changes to make GreeyBear spin up it's own ElasticSearch instance.
43
43
(...Care! This option would require enough RAM to run the additional containers. Suggested is >=16GB):
44
44
45
45
1. In `docker/env_file`, set the variable `ELASTIC_ENDPOINT` to `http://elasticsearch:9200`.
@@ -65,6 +65,14 @@ In the `env_file`, configure different variables as explained below.
65
65
-`SLACK_TOKEN`: Slack token of your Slack application that will be used to send/receive notifications
66
66
-`DEFAULT_SLACK_CHANNEL`: ID of the Slack channel you want to post the message to
67
67
68
+
## ElasticSearch compatibility.
69
+
Greedybear leverages a [python client](https://elasticsearch-dsl.readthedocs.io/en/latest/) for interacting with ElasticSearch which requires to be at the exact major version of the related T-POT ElasticSearch instance.
70
+
This means that there could problems if those versions do not match.
71
+
72
+
The actual version of the client installed is the 8.15.0 which allows to run TPOT version from 22.04.0 to 24.04.0 without any problems (and some later ones...we regularly check T-POT releases but we could miss one or two here.)
73
+
74
+
If you want to have compatibility with previous versions, you need to change the `elasticsearch-dsl` version [here](https://github.com/intelowlproject/GreedyBear/blob/main/requirements/project-requirements.txt) and [re-build](https://intelowlproject.github.io/docs/GreedyBear/Installation/#rebuilding-the-project-creating-custom-docker-build) locally the project.
75
+
68
76
## Update and Re-build
69
77
70
78
### Rebuilding the project / Creating custom docker build
$ docker-compose down # stop and destroy the currently running GreedyBear containers
87
95
$ docker-compose up # restart the GreedyBear application
88
96
```
89
-
90
-
## Installer for TPot Instance
91
-
92
-
The file 'installer_on_tpot.sh' allows the automatic installation of Greedybear on an existing TPot instance.
93
-
You can choose the type of Greedybear you want to install (http, https or local).
94
-
The installer will either clone Greedybear to '/opt/GreedyBear' or if Greedybear exists on your system you need to input the absolute path to the existing Greedybear folder.
95
-
It will prompt you for the necessary information/secrets needed.
0 commit comments