Files
mrs/docs/setup.md
2026-04-05 20:27:43 -04:00

4.6 KiB
Executable File

Setup

Hardware

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 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 that downloads zim files straight to the archive
  • Also create a page for making custom zim files and uploading them straight to the archive
docker run --rm -it -v $(pwd)/output:/output openzim/zimit https://example.com mysite