Running the StratoCyberLab on Windows 11

Requirements

The StratoCyberLab runs using docker and docker-compose. To install Docker on Ubuntu, follow the latest instructions at the Docker Official Page.

C:\Users\YourUsername> # Check that the docker version is >20.10
C:\Users\YourUsername> docker --version

Git is the next requirement. To install Git on Windows, check the Git Installation Guide.

C:\Users\YourUsername> # Check git is installed
C:\Users\YourUsername> git --version

Configure Git to handle well line terminators

C:\Users\YourUsername> git config --global core.autocrlf false
C:\Users\YourUsername> git config --global core.eol lf

Clone the repository

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

C:\Users\YourUsername> git clone https://github.com/stratosphereips/stratocyberlab.git
C:\Users\YourUsername> 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):

C:\Users\YourUsername> # Build the docker images
C:\Users\YourUsername> docker compose build
C:\Users\YourUsername> 
C:\Users\YourUsername> # Download the external docker images
C:\Users\YourUsername> docker compose pull
C:\Users\YourUsername> 
C:\Users\YourUsername> # Check images were build. Output is only an example and can differ.
C:\Users\YourUsername> docker image ls
REPOSITORY                 TAG       IMAGE ID       CREATED         SIZE
stratocyberlab-dashboard            latest    86b3c28ae4d2   9 minutes ago    654MB
stratocyberlab-hackerlab            latest    6dfe4273dacf   10 minutes ago   266MB
ollama/ollama                       latest    0f2f3f67bca4   19 hours ago     1.98GB

Start the StratoCyberLab

We use docker compose to start the containers:

C:\Users\YourUsername> 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.

Hello World Challenge

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

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!

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!