This documentation is dedicated to the all new TheHive 4. As of this writing, the latest release is TheHive 4.0-RC1.
The application stack of TheHive 4 has been completely changed. TheHive 4 does not rely on Elasticsearch anymore to store its data and the backend has been rewritten to support graph databases.
TheHive now supports different data and files storage methods. However, even for a standalone, production server, we strongly recommend using Apache Cassandra as a scalable and fault-tolerant database. Files (attached to cases) can be stored on the local filesystem.
For cluster configurations, we strongly recommend using Apache Hadoop as a distributed filesystem to store files.
Hardware requirements depends on the number of concurrent users and how they use the system. The following table give some information to choose the hardware.
| Number of users | CPU | RAM |
|---|---|---|
| < 3 | 2 | 4-8 |
| < 10 | 4 | 8-16 |
| < 20 | 8 | 16-32 |
- Installation and configuration guides : contain step-by-step installation instructions for TheHive 4 for different operating systems as well as corresponding binary archives.
- Migration guide: how to migrate your data from TheHive 3.4.0+.
- Administration guides: can help you leverage or enable more advanced features, or setup a more complex architecture.
- User guides: including a Quick start guide to get your instance of TheHive ready to use.
Webhooks have not been integrated in TheHive 4.0-RC1. They are now part of a new notification system that is almost ready but which still needs some work. We couldn't integrate it in RC1. However, it will be introduced in a future RC, before the stable release and then webhooks will make a reappearance.
TheHive is an open source and free software released under the AGPL (Affero General Public License). We, TheHive Project, are committed to ensure that TheHive will remain a free and open source project on the long-run.
Information, news and updates are regularly posted on TheHive Project Twitter account and on the blog.
We welcome your contributions. Please feel free to fork the code, play with it, make some patches and send us pull requests using issues.
We do have a Code of conduct. Make sure to check it out before contributing.
Please open an issue on GitHub if you'd like to report a bug or request a feature. We are also available on Gitter to help you out.
If you need to contact the Project's team, send an email to support@thehive-project.org.
Important Note:
- If you have problems with TheHive4py, please open an issue on its dedicated repository.
- If you encounter an issue with Cortex or would like to request a Cortex-related feature, please open an issue on its dedicated GitHub repository.
- If you have troubles with a Cortex analyzer or would like to request a new one or an improvement to an existing analyzer, please open an issue on the analyzers' dedicated GitHub repository.
We have set up a Google forum at https://groups.google.com/a/thehive-project.org/d/forum/users. To request access, you need a Google account. You may create one using a Gmail address or without it.