Skip to content

Latest commit

 

History

History
108 lines (77 loc) · 3.82 KB

installation.md

File metadata and controls

108 lines (77 loc) · 3.82 KB

Installing Phoniebox future3

Install Raspberry Pi OS Lite

Important

Currently, the installation does only work on Raspberry Pi's with ARMv7 and ARMv8 architecture, so 2, 3 and 4! Pi 1 and Zero's are currently unstable and will require a bit more work! Pi 4 and 5 are an excess ;-)

Before you can install the Phoniebox software, you need to prepare your Raspberry Pi.

  1. Connect a Micro SD card to your computer (preferable an SD card with high read throughput)
  2. Download the Raspberry Pi Imager and run it
  3. Click on "Raspberry Pi Device" and select "No filtering"
  4. Select Raspberry Pi OS Lite (32-bit) (without desktop environment) as the operating system. future3 does not support 64bit kernels (aarch64).
  5. Select your Micro SD card (your card will be formatted)
  6. After you click Next, a prompt will ask you if you like to customize the OS settings
    • Click Edit Settings
    • Switch to the General tab
      • Provide a hostname. (When on Mac, you will be able to use it to connect via SSH)
      • Username
      • Password
      • Wifi
      • Set locale settings
    • Switch to the Services tab. Enable SSH with "Use password authentication"
    • Click Save
  7. In the same dialog, click Yes
  8. Confirm the next warning about erasing the SD card with Yes
  9. Wait for the imaging process to be finished (it'll take a few minutes)
In case you forgot to customize the OS settings, follow these instructions after RPi OS has been written to the SD card.

Pre-boot preparation

You will need a terminal, like PuTTY for Windows or the Terminal app for Mac to proceed with the next steps.

  1. Open a terminal of your choice.

  2. Insert your card again if it has been ejected automatically.

  3. Navigate to your SD card e.g., cd /Volumes/boot for Mac or D: for Windows.

  4. Enable SSH by adding a simple file.

    $ touch ssh

  5. Set up your Wifi connection.

    Mac

    $ nano wpa_supplicant.conf

    Windows

    D:\> notepad wpa_supplicant.conf

  6. Insert the following content, update your country, Wifi credentials and save the file.

    country=DE
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
    ssid="network-name"
    psk="network-password"
}

  7. Eject your SD card and insert it into your Raspberry Pi.

  8. Start your Raspberry Pi by attaching a power supply.

  9. Login into your Raspberry Pi If raspberrypi.local does not work, find out your Raspberry Pi's IP address from your router.

Install Phoniebox software

Run the following command in your SSH terminal and follow the instructions

cd; bash <(wget -qO- https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/future3/main/installation/install-jukebox.sh)

This will get the latest stable release from the branch future3/main.

To install directly from a specific branch and/or a different repository specify the variables like this:

cd; GIT_USER='MiczFlor' GIT_BRANCH='future3/develop' bash <(wget -qO- https://raw.githubusercontent.com/MiczFlor/RPi-Jukebox-RFID/future3/develop/installation/install-jukebox.sh)

This will switch directly to the specified feature branch during installation.

Note

For all branches except the current Release future3/main, you will need to build the Web App locally on the Pi. This is not part of the installation process due to memory limitation issues. See Developer steps to install

If you suspect an error you can monitor the installation-process with

cd; tail -f INSTALL-<fullname>.log

After successful installation, continue with configuring your Phoniebox.