Public Repository

Last pushed: 9 months ago
Short Description
This repo contains the Iceman fork / proxmark3 project from GitHub
Full Description


Latest release

tag v1.7.0

Known problems

Problem: No GUI, no data plot window
Solution: run vnc
Solution for linux ppl: add these two rows the run it.
-v /tmp/.X11-unix:/tmp/.X11-unix \


I am assuming you have the docker virtualbox installed to start with. Watch some videos at the end, they help.
If not, start here:
--> <--

step 2.
---> VirtualBox 5.1.16 Oracle VM VirtualBox Extension Pack <---
Download and install the extension pack for here:

This will enable the docker container to get access to the USBport. When installed you need to start up the Oracle VM Virtualbox manager.
You need to stop the docker-host running and change the settings for the host and enable USB.

you need to have the proxmark3 connected to your computer.

Run it

docker run -it \
--device="/dev/ttyACM0" \
--privileged \
-v $HOME/Downloads:/opt/proxmark3/Data \

If you are on Windows, this command connects your Download folder, and maps it into
/op/proxmark3/Data inside the container. This is how you transfer files out and in from the container.
Don't forget to copy your datadumps etc into Data folder. You can analyze them on your HOST OS.

---- Host changes

-- Running PM3 inside docker.

When you have it up and running

run this script.


It will pull the latest source from GitHub and compile it.

To flash

client/flasher /dev/ttyACM0 armsrc/obj/fullimage.elf
--> keeps waiting for device to come back online. press CTRL-C
mknod /dev/ttyACM0 c 166 0
client/flasher /dev/ttyACM0 armsrc/obj/fullimage.elf
mknod /dev/ttyACM0 c 166 0

Run the PM3 client:
cd client
./proxmark3 /dev/ttyACM0

Copying files out from the docker container

If you want to save your bin/eml/html files, you need to copy them to your host OS.
I mapped $HOME/Downloads folder into /opt/proxmark3/Data folder. Don't forget to save/move/copy your files like data dumps, dumpkeys.bin, *.eml etc into this folder.


[1.6.0] How to run the container: ref:
[1.6.0] How to connect:
[1.6.1] How to flash:

Uploaded a new image. This one contains the text editor Nano, if you need to edit the source.
I also added the bash-script to pull latest changes from GitHub and compile it.
Also added to copy the blacklist rule into /etc/udev/rules.d/
And the starting directory is now /opt/proxmark3 so you don't have to cd into it first.


tag [1.6.0]
tag [1.6.1]
tag [1.6.2]
tag [1.6.3]
tag [1.6.4]
tag [1.6.5]
tag [1.6.6]
tag [1.6.7]
tag [1.6.8]
tag [1.6.9]

HOW TO BUY A PROXMARK3 DEVICE (EU, most for buyers in Sweden)

Docker Pull Command