HomeGitHubYouTubeDiscord

Getting Started

Raspberry Pi

Summary Instructions

  1. Copy the WROLPi image to a micro SD card.
  2. Boot the Raspberry Pi
  3. Choose your own username and password (do not use the wrolpi user).
  4. Finish installation steps, then reboot.
  5. Login using the user you created above.
  6. Modify fstab to mount your external drive to /media/wrolpi
    echo '/dev/sda1 /media/wrolpi auto defaults,nofail 0 0' | sudo tee -a /etc/fstab
  7. Finish the installation with the repair script: 
    /opt/wrolpi/repair.sh
  8. Reboot 
    sudo reboot
  9. Browse to your WROLPi interface at http://wrolpi.local

Comprehensive Instructions

1) Download

  1. Download the Raspberry Pi image from WROLPi.org

2) Image SD Card

Linux
  1. Plug in your SD card, find its device path with: 
    sudo blkid
  2. Extract and copy the WROLPi image to your drive (/dev/sdb in this example):
    xzcat WROLPi-v0.10-aarch64-desktop.img.xz | sudo dd of=/dev/sdb status=progress
Windows
  1. Copy the WROLPi image to your micro SD card using Raspberry Pi Imager

3) First boot

  1. Unplug your Raspberry Pi
  2. Insert the micro SD card from step 2 into your Raspberry Pi
  3. Connect any peripherals to your Raspberry Pi.
  4. Boot your Raspberry Pi.
  5. Choose your Country/Language/Timezone.
  6. Choose your own username and password (do not use the wrolpi user).
  7. Skip "Wi-Fi Selection", it is not required.
  8. Choose your favorite browser.
  9. Skip "Raspberry Pi Connect".
  10. Skip "Update Software".
  11. Restart.
  12. Login using the user you created above.
  13. Launch the Terminal application
    1. Modify fstab to mount your external drive to /media/wrolpi
      echo '/dev/sda1 /media/wrolpi auto defaults,nofail 0 0' | sudo tee -a /etc/fstab
    2. Finish the installation with the repair script: 
      /opt/wrolpi/repair.sh
    3. Reboot 
      sudo reboot

4) WROLPi Interface

  1. Join the Hotspot, or browse to https://wrolpi.local or, the IP address of your WROLPi!
    • If you want to view the WROLPi interface on a device within the same network, browse to https://wrolpi.local

Debian

Summary Instructions

  1. Copy the Debian WROLPi ISO to a thumb-drive.
  2. Insert the thumb-drive into the laptop, boot to the thumb-drive.
    1. Select "Start Installer"
    2. Install Debian 12.
  3. Unplug the thumb-drive after the installation has completed
  4. Login as the user you created during installation.
  5. Switch to the root user: 
    su -
  6. Finish the installation with the repair script: 
    /opt/wrolpi/repair.sh
  7. Reboot: 
    reboot
  8. Join the Hotspot, or browse to https://wrolpi.local or, the IP address of your WROLPi!