Skip to content

Getting Started

Welcome to the EMBSEC Lab Development Kit! This guide will help you set up your development environment and run your first embedded security lab.

Prerequisites

Before you begin, ensure you have:

  • A Unix-like operating system (Linux, macOS, or WSL2 on Windows)
  • Basic familiarity with C programming and the command line
  • At least 4GB of free disk space

Quick Start

The fastest way to get started:

# Clone the repository
git clone https://gitlab.com/embsec/kit.git
cd kit

# One-time setup
make setup

# Build and run your first lab
make qemu-build
make qemu-01-buffer-overflow

What's Next?

  1. Installation Guide - Detailed setup instructions for all platforms
  2. Quick Start Tutorial - Step-by-step guide to running labs
  3. Your First Lab - Walkthrough of the buffer overflow lab

Choosing Your Environment

  • No hardware required
  • Consistent environment
  • Built-in debugging support
  • Perfect for learning

Hardware (TM4C123GH6PM)

  • Real embedded experience
  • Hardware debugging skills
  • Performance testing
  • Advanced challenges

Getting Help