leonjza / frida-boot

Frida Boot 👢- A binary instrumentation workshop, with Frida, for beginners!

frida-boot 👢

A binary instrumentation workshop, using Frida, for beginners!

quickstart

• git clone https://github.com/leonjza/frida-boot
• cd frida-boot
• ./docker.sh pull
• ./docker.sh run

After running the container, all of the offline workshop content will be available at http://localhost:9999.

slides & stream

This workshop was streamed on YouTube here.

The slides for the workshop can be found on Google Slides here, with a PDF copy available in the slides/ directory of this repository.

manually building

The Dockerfile in this repository can be used to manually build the container. Feel free to edit it to suit your needs.

docker build -t frida-boot:local .

frida-boot's Issues

Fix docker.sh script for Linux users

Currently, trying to run the docker.sh on unix environment (like WSL2) will result in error message like:
-bash: ./docker.sh: /bin/bash^M: bad interpreter: No such file or directory

The fix is replacing the Dos chars with Unix ones.

sed -i -e 's/\r$//' docker.sh

EDIT: I think the reason it happend was due to using Github desktop cloning on Windows instead of CLI in WSL

issues with docker desktop

the image does not run with docker desktop even when I have integrated windows subsystem for linux available. How can I get around this?

Docker run issue - repository does not exist

The command docker.sh run, falls with the following error, on Docker version 20.10.7, build f0df350, running on MacOS Catalina 10.15.7.

For some reason, the "docker.sh run" command was looking for the image 'security/frida-boot:latest' locally, which indeed does not exist.

The fix for me, was to move the repository name i.e. leonjza/frida-boot, next to the container name like so:
docker run --cap-add SYS_PTRACE --rm -it --name frida-boot leonjza/frida-boot -p 9999:80 -v $(pwd)/code:/root/code

This was a weird issue. Don't know if anyone else experienced it.