1. System Requirements

To install OpenFDE on a Raspberry Pi with the Ubuntu 22.04 operating system, please ensure that you meet the following requirements.

Operating System

Hardware

Memory

2. Writing Operating System Image

First, download the Raspberry Pi image writing tool called Raspberry Pi Imager. You can find the download link onhttps://www.raspberrypi.com/software/

  1. select ubuntu 24.04.1 from Other general-purpose OS->Ubuntu

  2. select Raspberry Pi OS(64-bit) from the main page

3. Configure Installation Source And Certificates（Optional）​

When installing OpenFDE for the first time, you will need to obtain the complete software source and configure the installation source and certificates.

Note: If this is not your first time installing OpenFDE, you can skip the "Configure Installation Source and Certificates" section and proceed directly to the #install-openfde

3.1 Install wget and gpg​

sudo apt-get install wget gpg

3.2 Download the encryption key file from the official website and decrypt it locally​

wget -qO-  http://openfde.com/keys/openfde.asc | gpg --dearmor > packages.openfde.gpg

3.3 Copy the decrypted key file to the key folder of your local apt tool​

sudo install -D -o root -g root -m 644 packages.openfde.gpg /etc/apt/keyrings/packages.openfde.gpg

3.4 Configure the software repository address for OpenFDE​

sudo echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/packages.openfde.gpg] http://openfde.com/repos/ubuntu/ \
  "$(. /etc/os-release && echo "$PROJECT_CODENAME")" main" | \
  sudo tee /etc/apt/sources.list.d/openfde.list > /dev/null

3.5 Delete the downloaded key file​

rm -f packages.openfde.gpg

4. Install OpenFDE ​

4.1 Update Software Source​

sudo apt-get update

4.2 Install OpenFDE​

sudo apt-get install openfde

5. Upgrade OpenFDE​

Firstly update the software source.

sudo apt-get update

Upgrade OpenFDE to the latest version.

sudo apt-get install openfde

 

6. Kernel and cmdline of Raspberry PI OS

Raspberry Pi OS kernel has not been enabled cgroup_cpuset and cgroup_memory, and enabled the unified_cgropy_hierarchy. We need change it.

vim /boot/firmware/cmdline.txt

psi=1 cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

The default kernel of the Raspberry 5 is 2712 version, we need change it to v8 kernel to support 32 and 64 together.

The way to choose the kernel：

sudo apt install vim -y
vim /boot/firmware/config.txt
kernel=kernel8.img
#wq

You need a reboot to make the updates available . These modifies is included by the get-openfde.sh, you should not modify by manual.

7 Supported way to run OpenFDE

  1. Launch the OpenFDE application by clicking on its icon in the application list in a Wayland protocol desktop， such as Wayfire.

  2. Launch the OpenFDE as a desktop environment. By default, Raspberry Pi OS uses the raspi-desktop environment with automatic login enabled. To enable the option to choose the FDE desktop during login, the following modifications can be made.
    a.replace the pi-greeter with lightdm-gtk-greeter

    vim /etc/lightdm/lightdm.conf
greeter-session=lightdm-gtk-greeter

    b. cancel the automatic login

    sudo raspi-config   → 1 System Options  →  S5 Boot  /Auto Login → B3

    Reboot it, you' ll find the fde desktop by clicking the right top icon in a desktop list.