proxmark3/doc/md/Installation_Instructions/Linux-Installation-Instructions.md
2019-09-01 19:52:14 +02:00

3.2 KiB

External resources

You might want to follow one of these external resources to get an overview, but please still read carefully this page as some instructions may have evolved.

Linux Installation Video Screenshot

Install the required dependencies

On Debian / Ubuntu / Kali / ParrotOS / Raspbian

First what we want to do is get an update for the system. If you need to upgrade do this before the install. An upgrade was carried out prior to following these instructions.

Update the packages list

sudo apt-get update

Install the requirements

sudo apt-get install git ca-certificates build-essential libreadline5 libreadline-dev \
libusb-0.1-4 libusb-dev pkg-config wget gcc-arm-none-eabi libnewlib-dev libqt4-dev

If you don't need the graphical components of the Proxmark3 client, you can skip the installation of libqt4-dev.

If you get some (non blocking) error at runtime such as Gtk-Message: Failed to load module "canberra-gtk-module" you may have to install libcanberra-gtk-module.

On ArchLinux

sudo pacman -Sy base-devel p7zip libusb readline arm-none-eabi-gcc arm-none-eabi-newlib git --needed

If you want graphical output (such as in hw tune):

sudo pacman -Su qt5-base

Clone the RRG/Iceman repository

git clone https://github.com/RfidResearchGroup/proxmark3.git

Check ModemManager

Very important: make sure ModemManager will not interfer, otherwise it could brick your Proxmark3! Read carefully this page about ModemManager and follow its instructions.

Check connection

Check the proxmark is being picked up by your computer. Plug it in, then:

sudo dmesg | grep -i usb

It should show up as a CDC device:

usb 2-1.2: Product: PM3
usb 2-1.2: Manufacturer: proxmark.org
cdc_acm 2-1.2:1.0: ttyACM0: USB ACM device

And a new /dev/ttyACM0 should have appeared.

Get permissions to use /dev/ttyACM0

Add current user to the proper group to get permission to use /dev/ttyACM0.

This step can be done from the RRG/Iceman Proxmark3 repo with:

make accessrights

Then, you need to logout and login in again for your new group membership to be fully effective.

To test you have the proper read & write rights, plug the Proxmark3 and execute:

[ -r /dev/ttyACM0 ] && [ -w /dev/ttyACM0 ] && echo ok

It must return ok. Otherwise this means you've a permissions problem to fix.

Compile and use the project

Now you're ready to follow the compilation instructions.