feat: one-shot Ubuntu setup script, crapto1 mirror URLs, Windows non-ProxSpace build docs#3211
Open
PhenixStar wants to merge 1 commit intoRfidResearchGroup:masterfrom
Open
Conversation
…e build docs - setup-ubuntu.sh: one-shot setup script for Debian/Ubuntu/Kali that installs all build deps, handles ModemManager via udev rule (preferred over full disable), installs device permissions, adds user to required groups. Idempotent and safe to re-run. - tools/Makefile: update crapto1/craptev1 download URLs from the unreachable crapto1.netgarage.org to a working GitHub mirror (ApertureLabsLtd/craptern). Prevents build hangs on fresh installs. - doc/md/Installation_Instructions/Windows-Non-ProxSpace-Build.md: new guide documenting 3 approaches to building on Windows without using ProxSpace's MSYS2 terminal (PowerShell wrapper, WSL2, native MSYS2).
|
You are welcome to add an entry to the CHANGELOG.md as well |
iceman1001
reviewed
Apr 6, 2026
|
|
||
| get_craptev1: | ||
| $(WGET) http://crapto1.netgarage.org/craptev1-v1.1.tar.xz | ||
| $(WGET) https://raw.githubusercontent.com/ApertureLabsLtd/craptern/master/craptev1-v1.1.tar.xz |
Collaborator
There was a problem hiding this comment.
first, blapost doesn't prohibits binary distributions of his source. Hence the wget was pointing to his own distribution.
second, the aperturelasltd doesn't work since it doesn't exist any longer, Adam Laurie has taken over it.
remove these two changes.
Collaborator
|
this PR can be split into two. One with the doc for windows-non-proxspace. Easy merge. |
Collaborator
|
ping |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary\n\n###
setup-ubuntu.sh— One-shot Linux setup\n\nA single-command setup script for Debian/Ubuntu/Kali that:\n- Installs all build dependencies via apt-get (including Qt6 with Qt5 fallback)\n- Creates a udev rule to ignore Proxmark3 VID from ModemManager (preferred over disabling ModemManager entirely, which would break cellular modems)\n- Runsmake accessrightsfor device permissions\n- Adds user todialoutandplugdevgroups\n- Fully idempotent — safe to re-run on an already-configured machine\n\nUsage:\nbash\ngit clone https://github.com/RfidResearchGroup/proxmark3.git && cd proxmark3\nbash setup-ubuntu.sh\n# Log out and back in, then:\nmake -j$(nproc)\n\n\n###tools/Makefile— Fix crapto1/craptev1 download URLs\n\nThe upstream hostcrapto1.netgarage.orghas been unreachable since at least September 2024, causingmake get_craptev1andmake get_crapto1to hang indefinitely. Updated both URLs to use the ApertureLabsLtd/craptern GitHub mirror.\n\n###doc/md/Installation_Instructions/Windows-Non-ProxSpace-Build.md\n\nNew documentation covering three approaches to building on Windows without the ProxSpace MSYS2 terminal:\n1. PowerShell + ProxSpace toolchain (withBuild-Proxmark3.ps1wrapper)\n2. WSL2 (treat as Linux build)\n3. Native MSYS2 installation (always up-to-date packages)\n\n## Testing\n\n-setup-ubuntu.shtested on Ubuntu 22.04 LTS (clean install)\n- crapto1 mirror URL verified accessible\n- Windows build docs tested on Windows 11 with ProxSpace v3.11 + Iceman master"