4Mar
HaccTheHub – Open Source Self-Hosted Cyber Security Learning Platform
Open source self-hosted cyber security learning platform
About The Project
HaccTheHub is an open source project that provides cyber security
The HaccTheHub system consists of 3 main parts:
- Docker: containing all of the boxes creating the environment in which we'll be learning on.
- The backend: controlling Docker and responsible for starting/destroying indivisual box in the system and managing the networking that joins them into a unified system.
- The frontend: GUI for the user to interact with the system via their web browser.
Built With
Getting Started
To get HaccTheHub up and running, you would need to setup the followings
Prerequisites
- Docker (refer to Docker's Documentation for setup)
- Python 3 (Download) or just install
python3
from your package manager. - Node.js 16 (Download) or use your package manager
Installation
- Clone the repo
git clone https://github.com/J4FSec/HaccTheHub.git
- Install dependencies for the backend
cd HaccTheHub/backend
python3 -m pip install -r requirements.txt
- And dependencies for the frontend
cd ../client
npm install
Usage
- Start up Docker
- Start the backend
cd ../backend
python3 main.py
- And the frontend
cd ../client
npm start
The WebUI should now be accessible via http://localhost:8080.
Contributing
Any contributions are much appreciated. If you have a suggestion, please fork the repo and create a pull request. You can also open an issue with the tag enhancement
.
- Fork the project
- Create a new branch for the new feature (
git checkout -b feature/EpicFeature
) - Commit your changes (
git commit -m "Add EpicFeature"
) - Push to the branch (
git push origin feature/EpicFeature
) - Open a pull request.
License
Distributed under the GNU Affero General Public License v3.0. See LICENSE
for more information.
Authors
- Dong Duong (@Cu64) - dongduongdev@gmail.com
- watch-dog-man (@watch-dog-man)
Contributors
- @Nehozun - Completely re-made the frontend. We'd be lost without him.