Assume Breach Labs

A first course in defensive security

Learn security by doing — no VM, no setup pain.

Eleven hands-on labs that run in Docker and open in a friendly console or your browser. Real tools — nmap, Wireshark, John the Ripper, iptables — with the plumbing hidden. You just log in and start.

Get started

First time? About 10 minutes — most of it Docker installing. Done once.

1

Install Docker Desktop

Free, one-time, and the only software you need. Download for your system ↗, install it, and start it — wait until it shows “running”.

2

Download the labs — no git needed

⭳ Download the ZIP, then unzip it. You'll get a folder named assume-breach-labs-main — put it somewhere easy, like your Desktop.

On Windows, “Extract All” nests it one level deeper — assume-breach-labs-main\assume-breach-labs-main. That's normal: the inner folder (the one containing start.bat) is the one you want. Move it somewhere easy and delete the empty outer one.

3

Launch it

  1. Open the folder and double-click start.command.
    First time only: if macOS blocks it, right-click the file → OpenOpen.
  2. A Terminal window opens, the machines boot, and you land at the lab> prompt. Pick a module (see the cards below) and follow it.

Prefer the terminal? Open Terminal, type cd (with a trailing space), drag the folder onto the window, press Enter, then run ./start.sh

  1. One-time: install Git for Windows — it's the lab launcher. Run the installer and click Next through every screen; the defaults are all fine.
  2. Open the unzipped folder — the inner one, containing start.bat — and double-click start.bat.

If a window flashes open and vanishes: right-click an empty spot inside the folder → Open in Terminal, type .\start.bat and press Enter — the message stays on screen. It usually says Docker Desktop isn't running yet.

  1. Open a terminal in the folder — in most file managers, right-click → Open Terminal Here.
  2. Run ./start.sh and pick a module.

Or from any terminal: cd path/to/assume-breach-labs-main && ./start.sh

The twelve modules

Independent — pick any. Click a card for what it teaches and how to run it.

Part of the Assume-Breach series

Hands-on security labs across the lifecycle — plus two companion books and a game that tie it together. Found one? Here's the rest — or browse the whole series on the series home.