Quickstart Guide - zakharb/labshock GitHub Wiki

Follow these steps to get your virtual ICS lab up and running.

All main Distribution are supported:

  • Linux: Debian 12 / Ubuntu 24
  • Windows: 10/11
  • MacOS v15

Also Labshock is working under ARM architecture 😎


🟨 Install Docker on Debian & Ubuntu

#!/bin/bash
set -e
# Uninstall old Docker versions
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
    sudo apt-get remove -y $pkg || true
done
# Prepare system for Docker repository
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release

# Add Docker's official GPG key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/$(. /etc/os-release && echo "$ID")/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add Docker repository
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/$(. /etc/os-release && echo "$ID") \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Update and install Docker
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose

# To run Docker without root privileges
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

echo "✅ Docker installation completed."
docker --version

🟨 Install Docker Desktop on MacOS & Windows

For full support required version > v4.34

  • How to install Video: https://youtu.be/7PkIeSX6q6g
  • Download the Docker Desktop Image
  • Open Installer
  • Follow instructions
  • Open Docker
  • ⚠️ Enable Host network in settings ⚠️
Screenshot 2025-05-08 at 9 42 19 AM



🟨 Install Git

Check Official installation Guides



🟨 Install Labshock

Open your terminal and run:

# Clone repo
git clone https://github.com/zakharb/labshock.git
cd labshock/labshock

# Build Labshock
docker-compose build

# Build Labshock with Desktop
docker compose build

# Run Labshock
docker-compose up

# Run Labshock with Desktop
docker compose up



🟨 Update Labshock

Open your terminal and navigate to folder where Labshock located and run:

# Pull and build
git pull
cd labshock
docker-compose down -v
docker-compose build

# Run Labshock
docker-compose up



🟨 Cleanup Labshock

Stop all containers, remove images, volumes, etc

# Stop all containers
docker stop $(docker ps -aq)
# Remove all stopped containers
docker rm $(docker ps -aq)
# Removes all unused images
docker image prune -a  
# Volumes & Network 
docker volume rm $(docker volume ls -q)
docker network prune
# Clean system
docker system prune -a --volumes
docker system df

Next Steps: Start configuring your lab!

⚠️ **GitHub.com Fallback** ⚠️