Installing Phoniebox future3

Install Raspberry Pi OS Lite


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!

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 open it

  3. Select Raspberry Pi OS Lite (32-bit) (without desktop environment) as the operating system (only the 32 bit version is supported) (you can use the settings menu of the Raspberry Pi Imager to configure SSH and WiFi in a more userfriendly way, or do it manually as described in the next step)

  4. Select your Micro SD card (your card will be formatted)

  5. Click Write

  6. Wait for the imaging process to be finished (it’ll take a few minutes)

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.


    $ nano wpa_supplicant.conf


    D:\> notepad wpa_supplicant.conf
  6. Insert the following content, update your country, Wifi credentials and save the file.

    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
  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, username is pi and password is raspberry. 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-

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-

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


For all branches except the current Release, 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 Steps to install.

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

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