Skip to content

Draft README

metalefty edited this page May 10, 2023 · 8 revisions

AlmaLinux Official Raspberry Pi Image

This repository is the home of the Official AlmaLinux Raspberry Pi Image.

Images made possible by the incredible work contributed by the immortal Pablo Greco, Mark Verlinde and Fabian Arrotin.

AlmaLinux Raspberry Pi Quick Start

This has been tested on Raspberry Pi 3 and 4.

Please file any bugs on https://bugs.almalinux.org and feel free to discuss on our Community Chat, the Forums or Reddit.

Grab the image

Grab the image for AlmaLinux 8 or AlmaLinux 9. There are two variants of images, GNOME and console. After downloading the image, verify the CHECKSUM and burn it to an SD card using Fedora Media Writer , Balena Etcher, RPi Imager, dd or whatever tool you choose.

Pre-boot configuration

Modify user-data file in CIDATA volume to make additional customization to the image. Add SSH public keys at this step if you would like to login to Pi via SSH because SSH password authentication is disabled by default. See the wiki page How to use cloud-init to configure image for further information.

Boot & login

Insert your SD Card into your Raspberry Pi and boot!

The default user is almalinux, password is almalinux. Use sudo to become root.

Bonus Round #1: Connecting to Wi-Fi

You can configure to connect to Wi-Fi pre-boot. See the wiki page How to use cloud-init to configure image.

Step 1: First, let's make sure Wi-Fi is enabled. nmcli radio wifi it should respond with enabled. Great.

Step 2: Check out the list of local Wi-Fi networks next to you nmcli dev wifi list. You should see the one you want to connect to here.

Step 3: Connect to the Wi-Fi network. We'll use the --ask option so that we can provide the password silently. nmcli --ask dev wifi connect network-ssid

Step 4: Success! Your wlan0 interface should now pull an IP via DHCP and be active. You can verify this via nmcli con show to check physical layer connection and then ip a to see if you've gotten an IP.

Tips for GNOME image

If you chose the GNOME image, and your screen has a black border around it, apply this fix:

Step 1: Open a terminal

Step 2: sudo nano /boot/config.txt

Step 3: Add the following line: disable_overscan=1

Step 4: Type Ctrl+x on your keyboard to exit nano, and a little message at the bottom or the terminal will say, “save modified buffer?’. Type y for ‘yes’.

Step 5: reboot