init

2026-04-05 20:27:43 -04:00
commit 32a690d85b
32 changed files with 5325 additions and 0 deletions
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -0,0 +1,76 @@
+# Setup
+
+### Hardware
+- Raspberry Pi 5
+  - 4 GB - No AI
+  - 8 GB - Small AI
+  - 16GB - Medium AI
+- SD card (recommended 500 GB - 1 TB)
+  - Gutenberg Project (~80 GB)
+  - Khan Academy (~180 GB)
+  - Satellite Maps (150-300 GB)
+  - Vector Maps (60 - 100 GB)
+  - Wikipedia (~120 GB)
+- [Duel M.2 NVMe hat](https://www.amazon.ca/dp/B0D83784HS?ref=ppx_yo2ov_dt_b_fed_asin_title)
+- [M.2 A+E key to M key adapter](https://www.amazon.ca/dp/B0CP7F55S8?ref=ppx_yo2ov_dt_b_fed_asin_title)
+- [Intel AX210 WiFi modem](https://www.amazon.ca/dp/B0B39631G1?ref=ppx_yo2ov_dt_b_fed_asin_title)
+- [M.2 HaLow modem](https://www.seeedstudio.com/Wio-WM6180-Wi-Fi-HaLow-mini-PCIe-Module-p-6394.html?srsltid=AfmBOopb8Phtr-IBBvYRn5AB5NQNuGIK2tC3we4ceaA_0QiX1JD78-Qs)
+- BE-180 GPS Module or [BE-220 GPS Module](https://www.amazon.ca/Geekstory-Navigation-38400bps-Raspberry-Controller/dp/B0BV2MV2GN/ref=sr_1_16_sspa?crid=3N5GO07PGL65Y&dib=eyJ2IjoiMSJ9.Co3Uo8H4Xww9Sh693R4fJJokreDApWile1X8epOqTfZqvQbix_mZr566DdLs_cTuWwurRGQZHlt2nFhdAiW4SZZ1HvsdLlBsqUWOEF7gav47G8Z6xFNT97E1jQLuc0j-PuSRGgMPd0gktZenNz4PkQ.Jma35qmqkNfqByw4Rdk4N7H0eM4CILfcf67G4gV2CD4&dib_tag=se&keywords=gms%2Buart&qid=1758982047&sprefix=gms%2Buart%2Caps%2C84&sr=8-16-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9idGY&th=1)
+- [Lora WisBlock Mini](https://www.amazon.ca/RAKwireless-WisBlock-Meshtastic-Starter-RAK19003/dp/B0DFMMTQZM/ref=sr_1_3?crid=QS5X4FYBC5H4&dib=eyJ2IjoiMSJ9.yzgzN2wMOGRfrwlfFeUwsCia4FERbPXPTBnq2WddC2An9Ni_Z2GAgGhquS96QFbSDzvlGu2X070zss9ggbEKGSLgrvRwvmF_mueX5aukwK_xB3S0VFJCsagWRIXdIIrX3k5cF0Seo_NoyuhmfD5wZkR9b0MInx5oRSrJ37Pd0BjERXpxZ3udlIJYf4mBgaGjNDrWc5rYu31deOGOdBfD54lbsrogePm4lb1nhz5Bs81wZTuCCDIm7V0QzO-2mq3Aj2_TLjY-F4F09C1zUm7_fYs9bGPEFmZ6N-syZFNoV6A.oUArviz-pLwgnF9wPrvf-MNKLIyQxwe0hy7uWhXqOVo&dib_tag=se&keywords=wisblock&qid=1758982932&s=electronics&sprefix=wisblock%2Celectronics%2C79&sr=1-3&th=1)
+- [E-ink display & momentary switch](https://www.amazon.ca/dp/B0D5DGZXG3?ref=ppx_yo2ov_dt_b_fed_asin_title)
+- Rotary Encoder
+- USB C 4-pin breakout + 22 AWG wire
+- 4x SMA connectors + pigtails 6"
+- *Optional: Power bank - Off grid power*
+- *Optional: Copper tape - Increases reception*
+- *Optional: [SDR](https://www.amazon.ca/dp/B0747LVW59/ref=sspa_dk_detail_1?psc=1&pd_rd_i=B0747LVW59&pd_rd_w=N68sx&content-id=amzn1.sym.516c2169-755e-413a-a38a-68230f4ab66f&pf_rd_p=516c2169-755e-413a-a38a-68230f4ab66f&pf_rd_r=Z9QJD2SRSYTG0HNFHKWP&pd_rd_wg=NBvG6&pd_rd_r=32aa78ce-63df-481d-bc40-f802b5dbd8f2&sp_csd=d2lkZ2V0TmFtZT1zcF9kZXRhaWw) - RF/ADS-B Monitoring*
+- *Optional: [Extra WiFi Dongle](https://www.amazon.ca/dp/B01GC8XH0S?ref=ppx_yo2ov_dt_b_fed_asin_title) - Wireless monitoring without sacrificing mesh or AP*
+- *Optional: [NRF24LU1 2.4GHz transceiver](https://www.amazon.ca/dp/B09GCLCWYL?ref=ppx_yo2ov_dt_b_fed_asin_title) - HID hacking*
+
+
+### Instructions
+1) Flash your wisblock with meshtastic: https://flasher.meshtastic.org/
+2) Flash SD card with Raspbian, ensure Hostname/User/Wifi/SSH is setup
+3) Configure OS/Kernal & reboot: `raspi-config`
+    1) Update
+    2) Interface Options > SSH > Enable
+    3) Interface Options > VNC > Disable
+    4) Interface Options > SPI > Enable
+    5) Interface Options > Serial Port > Disable Login Shell > Enable Hardware
+    6) Advanced > Wayland > X11
+    7) Advanced > Expand Filesystem
+4) Run setup script: 'chmod +x setup.sh && ./setup.sh'
+5) Configure Guacamole
+    1) Login: `guacadmin/guacadmin`
+    2) guacadmin > settings
+    3) Users > Create user & delete guacadmin
+    4) Connections
+        1) Desktop
+            - Name: `Desktop`
+            - Protocol: `RDP`
+            - Network > Host: `127.0.0.1`
+            - Network > Port: `3389`
+            - Authentication > Security mode: `RDP Encryption`
+            - Performance > Disable Graphics Pipeline Extension: `true`
+            - *Optional: username / password*
+        2) Terminal
+            - Name: `Terminal`
+            - Protocol: `SSH`
+            - Network > Host: `127.0.0.1`
+            - Network > Port: `22`
+            - *Optional: username / password*
+6) Update filebrowser password
+7) Create open-webui admin account & allow registration
+8) Create element admin account
+9) Download [Kiwix](https://library.kiwix.com) zims
+
+##
+
+## TODO
+- Create a captive portal with onboarding, PWA, links to all tools
+- Create settings page for managing lora, mesh, wifi & AP
+- Create a proxy for the [kiwix library](https://library.kiwix.org) that downloads zim files straight to the archive
+- Also create a page for making custom zim files and uploading them straight to the archive
+```bash
+docker run --rm -it -v $(pwd)/output:/output openzim/zimit https://example.com mysite
+```