From 8d04a405f5e305ea0a596fad2205413fe8cfa985 Mon Sep 17 00:00:00 2001
From: josh <josh.deprez@gmail.com>
Date: Sat, 10 Aug 2024 15:47:37 +1000
Subject: [PATCH] More build/install notes

---
 README.md | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 2dcdaa8..1bb2581 100644
--- a/README.md
+++ b/README.md
@@ -51,17 +51,31 @@ TODO: explain the configuration file
 
 Building and running:
 
-```shell
-sudo apt install libpcap-dev
-go install gitea.drjosh.dev/josh/jrouter@latest
-sudo setcap 'CAP_NET_BIND_SERVICE=ep CAP_NET_RAW=ep' ~/go/bin/jrouter
-~/go/bin/jrouter
-```
+1. Install [Go](https://go.dev/dl).
 
+2. Run these commands (for Debian-variety Linuxen, e.g. Ubuntu, Raspbian, Mint...):
+
+  ```shell
+  sudo apt install git build-essential libpcap-dev
+  go install gitea.drjosh.dev/josh/jrouter@latest
+  sudo setcap 'CAP_NET_BIND_SERVICE=ep CAP_NET_RAW=ep' ~/go/bin/jrouter
+  ```
+
+3. Configure `jrouter.yaml`
+
+4. To run:
+  ```shell
+  ~/go/bin/jrouter
+  ```
+
+Notes:
+
+* `build-essential` is needed for `CGo`
+* `libpcap-dev` and `CGo` is needed for [gopacket](https://github.com/google/gopacket)
 * `NET_BIND_SERVICE` is needed to bind UDP port 387 (for talking between AIRs)
 * `NET_RAW` is needed for EtherTalk
 
-TODO: instructions for non-Linux machines
+TODO: instructions for non-Linux / non-Debian-like machines
 
 ## Bug reports? Feature requests? Complaints? Praise?