# 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
```