First round of documentation

This commit is contained in:
Chris Stackpole 2021-07-10 21:14:29 -05:00
parent eb0c36e9e8
commit 8bdaa246e8

View File

@ -1,3 +1,45 @@
# RockyRpi
Scripts and kickstarts for building Rocky Linux for Raspberry Pi
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/`