Skip to content

Running the StratoCyberLab on Fedora

Veronica Valeros edited this page Oct 7, 2024 · 1 revision

Requirements

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

Clone the repository

To get started, clone the repository to your favourite destination:

:~$ git clone https://github.com/stratosphereips/stratocyberlab.git
:~$ cd stratocyberlab

Build and Pull the Docker images

There are three components of the StratoCyberLab:

  1. HackLab: docker image with the tools to run tools and solve the challenges
  2. LLM Assistant: uses ollama docker image to assist in resolving the challenges and exercises
  3. 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

Start the StratoCyberLab

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  |         +----------------------------------------------------------+

Accessing the StratoCyberLab 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.

image

Hello World Challenge

To ensure things are working, head to the Hello World challenge and click on Start, and complete the submission test: image

Did we miss something?

If we miss some instructions, please open an issue or do a PR. Thanks for helping the StratoCyberLab grow and be better!