Skip to content

Latest commit

 

History

History
83 lines (65 loc) · 2.51 KB

README.md

File metadata and controls

83 lines (65 loc) · 2.51 KB

HaccTheHub

Logo

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

Installation

  1. Clone the repo
git clone https://github.com/J4FSec/HaccTheHub.git
  1. Install dependencies for the backend
cd HaccTheHub/backend
python3 -m pip install -r requirements.txt
  1. And dependencies for the frontend
cd ../client
npm install

Usage

  1. Start up Docker
  2. Start the backend
cd ../backend
python3 main.py
  1. 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.

  1. Fork the project
  2. Create a new branch for the new feature (git checkout -b feature/EpicFeature)
  3. Commit your changes (git commit -m "Add EpicFeature")
  4. Push to the branch (git push origin feature/EpicFeature)
  5. Open a pull request.

License

Distributed under the GNU Affero General Public License v3.0. See LICENSE for more information.

Authors

Contributors

  • @Nehozun - Completely re-made the frontend. We'd be lost without him.

Acknowledgement