From 8bdaa246e8b1a2f54dcdd05a2b2f449db1002993 Mon Sep 17 00:00:00 2001 From: Stack Date: Sat, 10 Jul 2021 21:14:29 -0500 Subject: [PATCH] First round of documentation --- README.md | 44 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 43 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e04e53b..e8f9ff6 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,45 @@ # RockyRpi -Scripts and kickstarts for building Rocky Linux for Raspberry Pi \ No newline at end of file +Scripts and kickstarts for building Rocky Linux for Raspberry Pi + +# How to use +This install process is assuming that you are building from a Rocky Linux install on a Raspberry Pi. You can use any other aarch64-based system. Please follow the instructions in readme.image.txt for installing Rocky Linux to a Raspberry Pi 4. You will want to run the rootfs-expand script to have enough space availible. + +## Packages that need to be installed + +First install Epel release to enable the extra packages needed. + +`sudo dnf install -y epel-release` + +Then install the packages needed for this project: + +`sudo dnf install git tar python3 make python3-imgcreate python3-progress syslinux-extlinux` + +## Python 3 needs to be configured + +`sudo alternatives --set python /usr/bin/python3` + +## Configure Appliance-creator + +Go to [Fedora's Pagure](https://pagure.io/appliance-tools/releases) to get the latest release. At this time, release 011.1. + +`curl -O https://pagure.io/appliance-tools/archive/011.1/appliance-tools-011.1.tar.gz` +`tar -zxvf appliance-tools-011.1.tar.gz` +`cd appliance-tools-011.1/` +`sudo make install` + +## Configure repository. + +`cd ~` +`git clone https://git.rockylinux.org/skip/RockyRpi.git` +`cd RockyRpi/` + +## Update kickstart + +Any changes you want and need to make to the kickstart should happen now. This guide makes no assumptions on the correctness of your kickstart file. It is recommended to go through the process once to make sure it is all correct before tweaking to suit your needs. + +## Run the script + +The script requires a path as an argument where it will store the final image. The script will verify and create the directory, if necessary. + +`./Rocky8_Rpi4_mkimage.sh ~/images/`