permacomputing

commit 34cf55aaf5ff533ebf0921c34c0549bb5f6b3f78
parent 1c1ddd8412034eeca003b1ba70ed7cce95df62a6
Author: ugrnm <ugrnm@web>
Date:   Wed, 20 May 2026 17:43:55 +0200

heimdall tweaks

Diffstat:
M
unbrick01.mdwn
 | 
19
+++++++++++++++----

1 file changed, 15 insertions(+), 4 deletions(-)
diff --git a/unbrick01.mdwn b/unbrick01.mdwn
@@ -10,9 +10,21 @@
 - press `back` twice and scroll down to `Developer Options`
 - enable `OEM unlocking` and `USB debugging`. If `OEM unlocking` is not there, reboot the phone and try again.
 
-## Compile Heimdall
+## Installation Heimdall
 
-I needed a newer version of Heimdall which I couldn’t find without compiling it myself. To do this you can clone Heimdall from: [https://git.sr.ht/~grimler/heimdall](https://git.sr.ht/~grimler/heimdall).
+Two options: use the version provided by your OS, or compile from scratch if your OS does not provide a `heimdall` binary, or if this binary is too old. We need at least `v2.2.2`.
+
+### OS version
+
+On Debian (for instance):
+
+```sh
+sudo apt install heimdall-flash
+```
+
+### Compilation
+
+Upstream project is located at [https://git.sr.ht/~grimler/heimdall](https://git.sr.ht/~grimler/heimdall). Compilation steps:
 
 ```bash
 git clone https://git.sr.ht/~grimler/Heimdall
@@ -20,10 +32,9 @@ cd Heimdall
 mkdir build && cd build
 cmake -DDISABLE_FRONTEND=ON ..
 make -j$(nproc)
-sudo make install
 ```
 
-You can copy `heimdall` to your PATH (e.g. `cp bin/heimdall ~/.local/bin/`). Running `heimdall version` should say `v2.2.2` (or higher).
+You can copy the resulting `heimdall` binary to your `$PATH` (e.g. `cp bin/heimdall ~/.local/bin/`). or you can `sudo make install` and `heimdall` will be installed system-wide in `/usr/local/bin`.
 
 ## postmarketOS (pmbootstrap)