Automated Debian-based ISO builder for Falcon Player (FPP)
FPP-HA for Home Assistant can be found at the FPP-HA repo
This repository automatically builds a bootable FPP-OS ISO that will automatically download and install FPP on a PC or virtual machine. It also includes an easy to use USB flashing tool for Windows, macOS, and Linux, as well as automated scripts for the most popular VM environments.
Our FPP Flasher application can also be used to image the latest version of FPP on to an SD card for Pi's and BeagleBones.
FPP-OS currently uses the master branch of FPP which contains the unstable version of FPP 10. Once FPP 10 is released, we will switch to stable builds.
FPP-OS is not officially supported by the FalconChristmas/FPP team. All issues from this installation should be logged to THIS repo. We will test and confirm whether the issue is isolated to our repo, and recreate the ticket on the FPP repo if necessary. The FPP team will not respond to any issues from this installation.
The installer will boot using UEFI (preferred) or Legacy BIOS. If your BIOS is set to UEFI, a gray screen will be seen during the OS install. If your BIOS is set to Legacy Boot, a blue screen will be seen during the OS install. Both work - but UEFI is preferred as it is modern and provides an extra level of security.
- CPU: Must be 64-Bit
- Memory (RAM): Minimum 512MB for bare metal, Minimum 1GB for VM's (Recommended 2GB-4GB) depending on size of show
- Disk Size: Minimum 4GB (Recommended 16-64GB) depending on size of show
- Network: Must have an internet connection
- Physical machine or VM instance must be dedicated to FPP
- Hardware must be compatible with Debian 13
Downloading the ISO is not typically required. The VM scripts and the FPP Flasher tool will download the ISO automatically. If you are installing on a VM, skip directly to the Installation Guide.
The easiest way to get started. Automatically flashes the latest ISO to your USB drive in one click.
| Platform | Download |
|---|---|
| Windows | FPP-Flasher-x.x.x-win.exe |
| macOS (Silicon) | FPP-Flasher-x.x.x-mac-arm64.dmg |
| macOS (Intel) | FPP-Flasher-x.x.x-mac-x64.dmg |
| Linux | FPP-Flasher-x.x.x-linux.AppImage |
Grab the latest flasher from the Releases page.
If you prefer to flash manually, grab the ISO directly from the Releases and follow the directions below:
Linux / macOS: Use Etcher. Select the ISO, choose your USB drive, and write.
OR
dd if=fpp-os-amd64.iso of=/dev/sdX bs=4M status=progress
syncReplace /dev/sdX with your USB device (e.g. /dev/sdb). Double-check the device — this will erase it.
Windows: Use Rufus or Etcher. Select the ISO, choose your USB drive, and write.
This guide covers installation on:
- Physical PC (bare metal)
- Proxmox VE (VM)
- VirtualBox
- VMware Workstation or Player
- VMware Fusion
- Parallels Desktop
- Hyper-V
- USB drive (4GB+)
- Completed the steps above to download and flash ISO to USB
- Insert the USB containing FPP-OS into the target PC.
- Boot into BIOS/UEFI (usually
F2,DEL, orF12). - Select USB as boot device.
- Installation will start
- Confirm hard drive contents will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS finishes and warns to remove install media and the system shuts down
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- See Post-Installation for next steps
- Proxmox VE installed
- Log into Proxmox web UI.
- Open your host shell
- Run the following command:
curl -fsSL -o fpp-os-proxmox.sh https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/fpp-os-proxmox.sh && curl -fsSL -o vm-scripts.sha256 https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256 && sha256sum -c <(grep fpp-os-proxmox.sh vm-scripts.sha256) && bash fpp-os-proxmox.sh
- Follow the prompts to create a VM
- Install will start in VM
- Confirm VM disk will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS finishes and warns to remove install media and the system shuts down
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- After reboot, login as root with password falcon, and run the following command
apt update && apt install qemu-guest-agent -y && systemctl enable qemu-guest-agent
- See Post-Installation for next steps
- Oracle VirtualBox installed
- Open macOS Terminal, Linux Terminal, or Windows PowerShell
- Run the following command (on macOS replace
sha256sumwithshasum -a 256):
Windows/Linux:
curl -fsSL -o fpp-os-vbox.py https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/fpp-os-vbox.py && curl -fsSL -o vm-scripts.sha256 https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256 && sha256sum -c <(grep fpp-os-vbox.py vm-scripts.sha256) && python3 fpp-os-vbox.py
macOS:
curl -fsSL -o fpp-os-vbox.py https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/fpp-os-vbox.py && curl -fsSL -o vm-scripts.sha256 https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256 && shasum -a 256 -c <(grep fpp-os-vbox.py vm-scripts.sha256) && python3 fpp-os-vbox.py
- Follow the prompts to create a VM
- Install will start in VM
- Confirm VM disk will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS finishes warns to remove install media and the system shuts down (VirtualBox usually does this automatically)
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- After reboot, login as root with password falcon, and run the following command
apt update && apt install virtualbox-guest-utils -y
- See Post-Installation for next steps
- VMware Workstation or Player installed
- Open PowerShell as Administrator (WIN+X, Select PowerShell (Admin) or Terminal (Admin))
- Run the following command:
$s="fpp-os-vmwarewks.ps1"; curl.exe -fsSL -o $s "https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/$s"; curl.exe -fsSL -o "v.sha256" "https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256"; $e=((gc v.sha256) -match [regex]::Escape($s))[0] -split ' '|select -first 1; if((Get-FileHash $s -Alg SHA256).Hash -eq $e){& $s}else{throw "Checksum mismatch"}
- Follow the prompts to create a VM
- Install will start in VM
- Confirm VM disk will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS and warns to remove install media and the system shuts down (VMware usually does this automatically)
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- After reboot, login as root with password falcon, and run the following command
apt update && apt install open-vm-tools -y
- See Post-Installation for next steps
- VMware Fusion installed
- Open macOS Terminal
- Run the following command:
curl -fsSL -o fpp-os-vmfusion.sh https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/fpp-os-vmfusion.sh && curl -fsSL -o vm-scripts.sha256 https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256 && shasum -a 256 -c <(grep fpp-os-vmfusion.sh vm-scripts.sha256) && bash fpp-os-vmfusion.sh
- Follow the prompts to create a VM
- Install will start in VM
- Confirm VM disk will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS and warns to remove install media and the system shuts down (VMware usually does this automatically)
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- After reboot, login as root with password falcon, and run the following command
apt update && apt install open-vm-tools -y
- See Post-Installation for next steps
- Parallels Desktop installed
- Open macOS Terminal
- Run the following command:
curl -fsSL -o fpp-os-parallels.sh https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/fpp-os-parallels.sh && curl -fsSL -o vm-scripts.sha256 https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256 && shasum -a 256 -c <(grep fpp-os-parallels.sh vm-scripts.sha256) && bash fpp-os-parallels.sh
- Follow the prompts to create a VM
- Install will start in VM. Open Parallels Desktop to continue
- Confirm VM disk will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS and warns to remove install media and the system shuts down (Parallels usually does this automatically)
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- After reboot, login as root with password falcon, and run the following command
apt update && apt install parallels-tools -y
- See Post-Installation for next steps
- Windows with Hyper-V installed
- Open PowerShell as Administrator (WIN+X, Select PowerShell (Admin) or Terminal (Admin))
- Run the following command:
$s="fpp-os-hyperv.ps1"; curl.exe -fsSL -o $s "https://raw.githubusercontent.com/jessica12ryan/fpp-os/latest/vmscripts/$s"; curl.exe -fsSL -o "v.sha256" "https://github.com/jessica12ryan/fpp-os/releases/latest/download/vm-scripts.sha256"; $e=((gc v.sha256) -match [regex]::Escape($s))[0] -split ' '|select -first 1; if((Get-FileHash $s -Alg SHA256).Hash -eq $e){& $s}else{throw "Checksum mismatch"}
- Follow the prompts to create a VM
- Install will start in VM
- Confirm VM disk will be overwritten by selecting yes, then wait for OS to finish installing
- Installation of OS and warns to remove install media and the system shuts down (Hyper-V usually does this automatically)
- On first boot, FPP is installed automatically — this may take 10–30 minutes depending on internet speed
- System will reboot when completed
- After reboot, login as root with password falcon, and run the following command
apt update && apt install linux-image-virtual hv-kvp-daemon-init -y
- See Post-Installation for next steps
Browse to the web directory presented on your console screen after install, or open a webbrowser and browse to fpp.local Complete the FPP setup in your browser
| User | Password |
|---|---|
root |
falcon |
fpp |
falcon |
FPP install fails on first boot
Check the journal: journalctl -u fpp-install.service
The FPP Install Script requires internet access. Make sure your machine is connected via ethernet.
This repository is MIT licensed. FPP itself is licensed under its own terms — see FalconChristmas/fpp.