-
Notifications
You must be signed in to change notification settings - Fork 16
Running the StratoCyberLab on Fedora
The StratoCyberLab runs using docker and docker-compose. To install Docker on Fedora 40, follow the latest instructions at the Docker Official Page.
:~$ # Check that the docker version is >20.10
:~$ docker --version
Git is the next requirement. To install Git on Ubuntu, check the Git Installation Guide.
:~$ # Check git is installed
:~$ git --version
To get started, clone the repository to your favourite destination:
:~$ git clone https://github.com/stratosphereips/stratocyberlab.git
:~$ cd stratocyberlab
There are three components of the StratoCyberLab:
- HackLab: docker image with the tools to run tools and solve the challenges
- LLM Assistant: uses ollama docker image to assist in resolving the challenges and exercises
- Dashboard: web app to manage the challenges, access the hacklab through WebSSH, and load the LLM Assistant
Overall, make sure you have around 8-10GB of free space (3GB of docker images, and 5GB of LLM model):
:~$ # Build the docker images
:~$ docker compose build
:~$
:~$ # Download the external docker images
:~$ docker compose pull
:~$
:~$ # Check images were build. Output is only an example and can differ.
:~$ docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
stratocyberlab-hackerlab latest 75cd967c4917 About a minute ago 848MB
stratocyberlab-dashboard latest 4d2f3e0da9b2 2 minutes ago 646MB
ollama/ollama latest 1577d5e882da 12 days ago 3.27GB
We use docker compose to start the containers:
:~$ docker compose up
When the dockers are up, a banner should be shown on the terminal:
dashboard |
dashboard | ____ _ _ ____ _ _ _
dashboard | / ___|| |_ _ __ __ _| |_ ___ / ___| _| |__ ___ _ __| | __ _| |__
dashboard | \___ \| __| '__/ _` | __/ _ \| | | | | | '_ \ / _ \ '__| | / _` | '_ \
dashboard | ___) | |_| | | (_| | || (_) | |__| |_| | |_) | __/ | | |__| (_| | |_) |
dashboard | |____/ \__|_| \__,_|\__\___/ \____\__, |_.__/ \___|_| |_____\__,_|_.__/
dashboard | |___/
dashboard | | RUNNING, NAVIGATE TO http://127.0.0.1/ IN YOUR BROWSER |
dashboard | +----------------------------------------------------------+
The dashboard should be accessible at the address specified in the banner, as shown above. Upon opening the web page, you should see the dashboard. The challenges are on the left. The LLM assistant is on the right. Access the HackLab docker by clicking on the arrow at the bottom of the page. The following screenshot is illustrative and may change in future versions.
To ensure things are working, head to the Hello World
challenge and click on Start, and complete the submission test:
If we miss some instructions, please open an issue or do a PR. Thanks for helping the StratoCyberLab grow and be better!