Proxmark3 Easy RFID Tool - Ubuntu setup guide

1 Complete Setup Guide for Installing Proxmark3 and RfidResearchGroup Proxmark3 on Ubuntu 22.04

1.1 Prerequisites

1. Update and Upgrade System:

  <syntaxhighlight lang="bash">
  sudo apt update
  sudo apt upgrade -y
  </syntaxhighlight>

2. Install Required Dependencies:

  <syntaxhighlight lang="bash">
  sudo apt-get install --no-install-recommends git ca-certificates build-essential pkg-config \
  libreadline-dev gcc-arm-none-eabi libnewlib-dev qtbase5-dev \
  libbz2-dev liblz4-dev libbluetooth-dev libpython3-dev libssl-dev libgd-dev
  </syntaxhighlight>

1.2 Cloning the Repositories

1. Clone the Proxmark3 Repository:

  <syntaxhighlight lang="bash">
  mkdir -p ~/git
  cd ~/git
  git clone https://github.com/Proxmark/proxmark3.git Proxmark_proxmark3
  </syntaxhighlight>

2. Clone the RfidResearchGroup Repository:

  <syntaxhighlight lang="bash">
  mkdir -p ~/git
  cd ~/git
  git clone https://github.com/RfidResearchGroup/proxmark3.git RfidResearchGroup_proxmark3
  </syntaxhighlight>

1.3 Building the Software

1. For Proxmark3:

  <syntaxhighlight lang="bash">
  cd ~/git/Proxmark_proxmark3
  make clean
  make all
  </syntaxhighlight>

2. For RfidResearchGroup:

  <syntaxhighlight lang="bash">
  cd ~/git/RfidResearchGroup_proxmark3
  make clean
  make all
  </syntaxhighlight>

1.4 Setting Up Permissions

1. Add User to Dialout Group:

  <syntaxhighlight lang="bash">
  sudo usermod -aG dialout $USER
  </syntaxhighlight>

2. Setup Access Rights:

  <syntaxhighlight lang="bash">
  cd ~/git/RfidResearchGroup_proxmark3
  make accessrights
  </syntaxhighlight>

3. Disable ModemManager (if applicable):

  <syntaxhighlight lang="bash">
  sudo systemctl stop ModemManager
  sudo systemctl disable ModemManager
  </syntaxhighlight>

1.5 Flashing the Firmware (RfidResearchGroup Only)

1. Install the Proxmark3 client:

  <syntaxhighlight lang="bash">
  sudo make install
  </syntaxhighlight>

2. Flash the BOOTROM & FULLIMAGE:

  <syntaxhighlight lang="bash">
  pm3-flash-all
  </syntaxhighlight>
  If specifying the port manually:
  <syntaxhighlight lang="bash">
  proxmark3 /dev/ttyACM0 --flash --unlock-bootloader --image bootrom.elf --image fullimage.elf
  </syntaxhighlight>

3. Button Trick (if flasher can't detect Proxmark3):

  Unplug Proxmark3, press and hold the button, plug it into USB, release the button. Two LEDs should stay on.

4. Forcing Flashing if Firmware Mismatch:

  <syntaxhighlight lang="bash">
  pm3-flash-all --force
  </syntaxhighlight>

1.6 Running the Client

1. Connect the Proxmark3 device to your computer.

2. Run the Client:

  - For Proxmark3:
    <syntaxhighlight lang="bash">
    cd ~/git/Proxmark_proxmark3/client
    ./proxmark3 /dev/ttyACM0
    </syntaxhighlight>
  - For RfidResearchGroup:
    <syntaxhighlight lang="bash">
    cd ~/git/RfidResearchGroup_proxmark3/client
    ./pm3
    </syntaxhighlight>

1.7 References

- [Proxmark3 GitHub Repository](https://github.com/Proxmark/proxmark3) - [RfidResearchGroup GitHub Repository](https://github.com/RfidResearchGroup/proxmark3) - [RfidResearchGroup Compilation Instructions](https://github.com/RfidResearchGroup/proxmark3/blob/master/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)