Chapter 10. Creating Kickstart files
You can create a Kickstart file by using the following different methods:
- Use the online Kickstart configuration tool.
- Copy the Kickstart file created as a result of a manual installation.
- Write the entire Kickstart file manually.
Convert the Red Hat Enterprise Linux 9 Kickstart file for Red Hat Enterprise Linux 10 installation.
For more information about the conversion tool, see Kickstart generator lab.
- In case of virtual and cloud environments, create a custom system image by using Image Builder.
Some highly specific installation options can be configured only by manual editing of the Kickstart file.
10.1. Creating a Kickstart file with the Kickstart configuration tool
Red Hat Customer Portal account holders can use the Kickstart Generator tool in the Customer Portal Labs to generate Kickstart files online. This tool will walk you through the basic configuration and enable you to download the resulting Kickstart file.
Prerequisites
- You have a Red Hat Customer Portal account and an active Red Hat subscription.
Procedure
- Open the Kickstart generator lab.
- Click the Go to Application button to the left of the heading and wait for the next page to load.
- Select Red Hat Enterprise Linux 10 in the drop-down menu and wait for the page to update.
Describe the system to be installed by using the fields in the form.
You can use the links on the left side of the form to quickly navigate between sections of the form.
To download the generated Kickstart file, click the red Download button at the top of the page.
Your web browser saves the file.
Install the pykickstart package.
# dnf install pykickstart
Run
ksvalidator
on your Kickstart file.$ ksvalidator -v RHEL10 /path/to/kickstart.ks
Replace /path/to/kickstart.ks with the path to the Kickstart file you want to verify.
The validation tool cannot guarantee the installation will be successful. It ensures only that the syntax is correct and that the file does not include deprecated options. It does not attempt to validate the
%pre
,%post
and%packages
sections of the Kickstart file.
10.2. Creating a Kickstart file by performing a manual installation
You can use the Kickstart file created by a manual installation of Red Hat Enterprise Linux. After a graphical installation completes, all choices made during the installation are saved into a Kickstart file named anaconda-ks.cfg
, located in the /root/
directory on the installed system. Use this file to reproduce the installation in the same way as before. Alternatively, copy this file, make any changes you need, and use the resulting configuration file for further installations.
Procedure
Install RHEL. For more details, see Interactively installing RHEL from installation media.
During the installation, create a user with administrator privileges.
- Finish the installation and reboot into the installed system.
- Log into the system with the administrator account.
Copy the file
/root/anaconda-ks.cfg
to a location of your choice. The file contains information about users and passwords.To display the file contents in terminal:
# cat /root/anaconda-ks.cfg
You can copy the output and save to another file of your choice.
- To copy the file to another location, use the file manager. Remember to change permissions on the copy, so that the file can be read by non-root users.
Install the pykickstart package.
# dnf install pykickstart
Run
ksvalidator
on your Kickstart file.$ ksvalidator -v RHEL10 /path/to/kickstart.ks
Replace /path/to/kickstart.ks with the path to the Kickstart file you want to verify.
The validation tool cannot guarantee the installation will be successful. It ensures only that the syntax is correct and that the file does not include deprecated options. It does not attempt to validate the %pre
, %post
and %packages
sections of the Kickstart file.
10.3. Converting a Kickstart file from previous RHEL installation
You can use the Kickstart Converter tool to convert a RHEL 8 Kickstart file for use in a RHEL 9 installation or convert a RHEL 9 Kickstart file for use in RHEL 10. For more information about the tool and how to use it to convert a RHEL Kickstart file, see Kickstart converter.
Procedure
After you prepare your kickstart file, install the pykickstart package.
# dnf install pykickstart
Run
ksvalidator
on your Kickstart file.$ ksvalidator -v RHEL10 /path/to/kickstart.ks
Replace /path/to/kickstart.ks with the path to the Kickstart file you want to verify.
The validation tool cannot guarantee the installation will be successful. It ensures only that the syntax is correct and that the file does not include deprecated options. It does not attempt to validate the %pre
, %post
and %packages
sections of the Kickstart file.
10.4. Creating a custom image by using Image Builder
You can use Red Hat Image Builder to create a customized system image for virtual and cloud deployments.
For more information about creating customized images, using Image Builder, see the Composing a customized RHEL system image document.