5FuLmjsZ

1
2Pykickstart
3latest
4
5    Kickstart documentation
6        Chapter 1. Introduction
7            What are Kickstart Installations?
8            How Do You Perform a Kickstart Installation?
9            Creating the Kickstart File
10            Special Notes for Referring to Disks
11        Chapter 2. Kickstart Commands in Fedora
12        Chapter 3. Kickstart Commands in Red Hat Enterprise Linux
13        Chapter 4. Pre-installation script
14        Chapter 5. Package Selection
15        Chapter 6. Post-installation Script
16        Chapter 7. Handling Errors
17        Chapter 8. Handling Tracebacks
18        Chapter 9. Pre-install Script
19        Chapter 10. Making the Kickstart File Available
20        Chapter 11. Making the Installation Tree Available
21        Chapter 12. Starting a Kickstart Installation
22    Testing pykickstart
23
24    Docs » Kickstart Documentation
25    Edit on GitHub
26
27Kickstart Documentation
28Authors:	Chris Lumens <clumens@redhat.com> and other members of the Anaconda installer team
29
30Contents
31
32    Kickstart Documentation
33        Chapter 1. Introduction
34            What are Kickstart Installations?
35            How Do You Perform a Kickstart Installation?
36            Creating the Kickstart File
37            Special Notes for Referring to Disks
38        Chapter 2. Kickstart Commands in Fedora
39            auth or authconfig
40            authselect
41            autopart
42            autostep
43            bootloader
44            btrfs
45            cdrom
46            clearpart
47            graphical or text or cmdline
48            device
49            deviceprobe
50            dmraid
51            driverdisk
52            eula
53            fcoe
54            firewall
55            firstboot
56            group
57            reboot or poweroff or shutdown or halt
58            harddrive
59            hmc
60            ignoredisk
61            install
62            interactive
63            iscsi
64            iscsiname
65            keyboard
66            lang
67            langsupport
68            lilo
69            lilocheck
70            liveimg
71            logging
72            logvol
73            mediacheck
74            method
75            module
76            monitor
77            mount
78            mouse
79            multipath
80            network
81            nfs
82            nvdimm
83            ostreesetup
84            part or partition
85            raid
86            realm
87            repo
88            reqpart
89            rescue
90            rootpw
91            selinux
92            services
93            skipx
94            snapshot
95            sshkey
96            sshpw
97            timezone
98            updates
99            install or upgrade
100            url
101            user
102            vnc
103            volgroup
104            xconfig
105            zerombr
106            zfcp
107            %include
108            %ksappend
109        Chapter 3. Kickstart Commands in Red Hat Enterprise Linux
110            auth or authconfig
111            authselect
112            autopart
113            autostep
114            bootloader
115            btrfs
116            cdrom
117            clearpart
118            graphical or text or cmdline
119            device
120            deviceprobe
121            dmraid
122            driverdisk
123            eula
124            fcoe
125            firewall
126            firstboot
127            group
128            reboot or poweroff or shutdown or halt
129            harddrive
130            hmc
131            ignoredisk
132            install
133            interactive
134            iscsi
135            iscsiname
136            key
137            keyboard
138            lang
139            langsupport
140            lilo
141            lilocheck
142            liveimg
143            logging
144            logvol
145            mediacheck
146            method
147            monitor
148            mount
149            mouse
150            multipath
151            network
152            nfs
153            nvdimm
154            ostreesetup
155            part or partition
156            raid
157            realm
158            repo
159            reqpart
160            rescue
161            rootpw
162            selinux
163            services
164            skipx
165            snapshot
166            sshkey
167            sshpw
168            syspurpose
169            timezone
170            unsupported_hardware
171            updates
172            install or upgrade
173            url
174            user
175            vnc
176            volgroup
177            xconfig
178            zerombr
179            zfcp
180            %include
181            %ksappend
182        Chapter 4. Pre-installation script
183            Example
184        Chapter 5. Package Selection
185            Group-level options
186        Chapter 6. Post-installation Script
187            Examples
188        Chapter 7. Handling Errors
189        Chapter 8. Handling Tracebacks
190        Chapter 9. Pre-install Script
191        Chapter 10. Making the Kickstart File Available
192            Creating a Kickstart Boot Diskette
193            Creating a Kickstart Boot CD-ROM
194            Making the Kickstart File Available on the Network
195        Chapter 11. Making the Installation Tree Available
196        Chapter 12. Starting a Kickstart Installation
197            Boot Diskette
198            CD-ROM #1 and Diskette
199            With Driver Disk
200            Boot CD-ROM
201            Other kickstart options
202            Example Kickstart Script
203            More Kickstart usage examples
204
205Chapter 1. Introduction
206What are Kickstart Installations?
207
208Many system administrators would prefer to use an automated installation method to install Fedora or Red Hat Enterprise Linux on their machines. To answer this need, Red Hat created the kickstart installation method. Using kickstart, a system administrator can create a single file containing the answers to all the questions that would normally be asked during a typical installation.
209
210Kickstart files can be kept on a server system and read by individual computers during the installation. This installation method can support the use of a single kickstart file to install Fedora or Red Hat Enterprise Linux on multiple machines, making it ideal for network and system administrators.
211
212The Fedora installation guide at http://docs.fedoraproject.org/en-US/index.html has a detailed section on kickstart.
213How Do You Perform a Kickstart Installation?
214
215Kickstart installations can be performed using a local CD-ROM, a local hard drive, or via NFS, FTP, or HTTP.
216
217To use kickstart, you must:
218
219    Create a kickstart file.
220    Create a boot diskette with the kickstart file or make the kickstart file available on the network.
221    Make the installation tree available.
222    Start the kickstart installation.
223
224This chapter explains these steps in detail.
225Creating the Kickstart File
226
227The kickstart file is a simple text file, containing a list of items, each identified by a keyword. You can create it by using the Kickstart Configurator application or by writing it from scratch. The Fedora or Red Hat Enterprise Linux installation program also creates a sample kickstart file based on the options that you selected during installation. It is written to the file /root/anaconda-ks.cfg. You should be able to edit it with any text editor or word processor that can save files as ASCII text.
228
229First, be aware of the following issues when you are creating your kickstart file:
230
231    While not strictly required, there is a natural order for sections that should be followed. Items within the sections do not have to be in a specific order unless otherwise noted. The section order is:
232        Command section – Refer to Chapter 2 for a list of kickstart options. You must include the required options.
233        The %packages section – Refer to Chapter 3 for details.
234        The %pre, %pre-install, %post, %onerror, and %traceback sections – These sections can be in any order and are not required. Refer to Chapter 4, Chapter 5, and Chapter 6 for details.
235    The %packages, %pre, %pre-install, %post, %onerror, and %traceback sections are all required to be closed with %end
236    Items that are not required can be omitted.
237    Omitting any required item will result in the installation program prompting the user for an answer to the related item, just as the user would be prompted during a typical installation. Once the answer is given, the installation will continue unattended unless it finds another missing item.
238    One installation source command from the list of commands in the method proxy command must be specified for the fully automated kickstart installation. This is required even for Fedora – the closest mirror can’t be chosen by the kickstart file.
239    Lines starting with a pound sign (#) are treated as comments and are ignored.
240    If deprecated commands, options, or syntax are used during a kickstart installation, a warning message will be logged to the anaconda log. Since deprecated items are usually removed within a release or two, it makes sense to check the installation log to make sure you haven’t used any of them. When using ksvalidator, deprecated items will cause an error.
241
242Special Notes for Referring to Disks
243
244Traditionally, disks have been referred to throughout Kickstart by a device node name (such as sda). The Linux kernel has moved to a more dynamic method where device names are not guaranteed to be consistent across reboots, so this can complicate usage in Kickstart scripts. To accommodate stable device naming, you can use any item from /dev/disk in place of a device node name. For example, instead of:
245
246part / --fstype=ext4 --onpart=sda1
247
248You could use an entry similar to one of the following:
249
250part / --fstype=ext4 --onpart=/dev/disk/by-path/pci-0000:00:05.0-scsi-0:0:0:0-part1
251part / --fstype=ext4 --onpart=/dev/disk/by-id/ata-ST3160815AS_6RA0C882-part1
252
253This provides a consistent way to refer to disks that is more meaningful than just sda. This is especially useful in large storage environments.
254
255You can also use shell-like entries to refer to disks. This is primarily intended to make it easier to use the clearpart and ignoredisk commands in large storage environments. For example, instead of:
256
257ignoredisk --drives=sdaa,sdab,sdac
258
259You could use an entry similar to the following:
260
261ignoredisk --drives=/dev/disk/by-path/pci-0000:00:05.0-scsi-*
262
263Finally, anywhere you want to refer to an existing partition or filesystem (say, in the part --ondisk=) option, you may also refer to the device by its filesystem label or UUID. This is done as follows:
264
265part /data --ondisk=LABEL=data
266part /misc --ondisk=UUID=819ff6de-0bd6-4bf4-8b72-dbe41033a85b
267
268Chapter 2. Kickstart Commands in Fedora
269
270The following commands can be placed in a kickstart file. If you prefer to use a graphical interface for creating your kickstart file, you can use the Kickstart Configurator application.
271
272Most commands take arguments. If an argument is followed equals mark (=), a value must be specified after it.
273
274In the example commands, options in ‘’‘[square brackets]’‘’ are optional arguments for the command.
275
276pykickstart processes arguments to commands just like the shell does:
277
278If a list of arguments can be passed in, the arguments must be separated by
279commas and not include any extra spaces.  If extra spaces are required in the
280list of arguments, the entire argument must be surrounded by double quotes.
281If quotes, spaces, or other special characters need to be added to the
282arguments list, they must be escaped.
283
284auth or authconfig
285
286auth|authconfig [options]
287
288New in version Fedora3.
289
290This required command sets up the authentication options for the system. This is just a wrapper around the authconfig program, so all options recognized by that program are valid for this command. See the manual page for authconfig for a complete list.
291
292By default, passwords are normally encrypted and are not shadowed.
293
294Changed in version Fedora28.
295
296The authconfig program is deprecated. This command will use the authconfig compatibility tool, but you should use the authselect command instead.
297
298positional arguments:
299
300[options]
301
302    See man authconfig.
303
304    New in version Fedora3.
305
306authselect
307
308authselect [options]
309
310New in version Fedora28.
311
312This command sets up the authentication options for the system. This is just a wrapper around the authselect program, so all options recognized by that program are valid for this command. See the manual page for authselect for a complete list.
313
314positional arguments:
315
316[options]
317
318    See man authselect.
319
320    New in version Fedora28.
321
322autopart
323
324autopart [--encrypted] [--passphrase PASSPHRASE] [--escrowcert <url>]
325     [--backuppassphrase] [--nolvm] [--type TYPE] [--cipher CIPHER]
326     [--fstype FSTYPE] [--nohome] [--noboot] [--noswap]
327     [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
328     [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
329     [--pbkdf-iterations PBKDF_ITERATIONS]
330
331New in version Fedora3.
332
333Automatically create partitions – a root (/) partition, a swap partition, and an appropriate boot partition for the architecture. On large enough drives, this will also create a /home partition.
334
335The autopart command can’t be used with the logvol, part/partition, raid, reqpart, or volgroup in the same kickstart file.
336
337optional arguments:
338
339--encrypted
340
341    Should all devices with support be encrypted by default? This is equivalent to checking the “Encrypt” checkbox on the initial partitioning screen.
342
343    New in version Fedora9.
344
345--passphrase PASSPHRASE
346
347    Only relevant if --encrypted is specified. Provide a default system-wide passphrase for all encrypted devices.
348
349    New in version Fedora9.
350
351--escrowcert <url>
352
353    Only relevant if --encrypted is specified. Load an X.509 certificate from <url>. Store the data encryption keys of all encrypted volumes created during installation, encrypted using the certificate, as files in /root.
354
355    New in version Fedora12.
356
357--backuppassphrase
358
359    Only relevant if --escrowcert is specified. In addition to storing the data encryption keys, generate a random passphrase and add it to all encrypted volumes created during installation. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as files in /root (one file for each encrypted volume).
360
361    New in version Fedora12.
362
363--nolvm
364
365    Don’t use LVM when partitioning.
366
367    New in version Fedora16.
368
369    Changed in version Fedora17.
370
371    The same as --type=plain
372
373--type TYPE
374
375    Select automatic partitioning scheme. Must be one of the following: [‘thinp’, ‘partition’, ‘btrfs’, ‘lvm’, ‘plain’]. Plain means regular partitions with no btrfs or lvm.
376
377    New in version Fedora17.
378
379    Changed in version Fedora20.
380
381    Partitioning scheme ‘thinp’ was added.
382
383--cipher CIPHER
384
385    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
386
387    New in version Fedora18.
388
389--fstype FSTYPE
390
391    Use the specified filesystem type on the partitions. Note that it cannot be used with --type=btrfs since btrfs is both a partition scheme and a filesystem. eg. --fstype=ext4.
392
393    New in version Fedora21.
394
395--nohome
396
397    Do not create a /home partition.
398
399    New in version Fedora26.
400
401--noboot
402
403    Do not create a /boot partition.
404
405    New in version Fedora26.
406
407--noswap
408
409    Do not create a swap partition.
410
411    New in version Fedora26.
412
413--luks-version LUKS_VERSION
414
415    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
416
417    New in version Fedora29.
418
419--pbkdf PBKDF
420
421    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
422
423    New in version Fedora29.
424
425--pbkdf-memory PBKDF_MEMORY
426
427    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
428
429    New in version Fedora29.
430
431--pbkdf-time PBKDF_TIME
432
433    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
434
435    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
436
437    New in version Fedora29.
438
439--pbkdf-iterations PBKDF_ITERATIONS
440
441    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
442
443    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
444
445    New in version Fedora29.
446
447autostep
448
449autostep [--autoscreenshot]
450
451New in version Fedora3.
452
453Kickstart installs normally skip unnecessary screens. This makes the installer step through every screen, displaying each briefly.
454
455This is mostly used for debugging.
456
457optional arguments:
458
459--autoscreenshot
460
461    Take a screenshot at every step during installation and copy the images over to /root/anaconda-screenshots after installation is complete. This is most useful for documentation.
462
463    New in version Fedora3.
464
465bootloader
466
467bootloader [--append APPENDLINE] [--location {mbr,partition,none,boot}]
468       [--password PASSWORD] [--driveorder DRIVEORDER] [--timeout TIMEOUT]
469       [--default DEFAULT] [--iscrypted] [--md5pass _MD5PASS]
470       [--boot-drive BOOTDRIVE] [--leavebootorder] [--extlinux]
471       [--disabled] [--nombr] [--upgrade]
472
473New in version Fedora3.
474
475This required command specifies how the boot loader should be installed.
476
477There must be a biosboot partition for the bootloader to be installed successfully onto a disk that contains a GPT/GUID partition table, which includes disks initialized by anaconda. This partition may be created with the kickstart command part biosboot --fstype=biosboot --size=1. However, in the case that a disk has an existing biosboot partition, adding a part biosboot option is unnecessary.
478
479optional arguments:
480
481--append APPENDLINE
482
483    Specifies kernel parameters. The default set of bootloader arguments is “rhgb quiet”. You will get this set of arguments regardless of what parameters you pass to –append, or if you leave out –append entirely. For example:
484
485    ``bootloader --location=mbr --append="hdd=ide-scsi ide=nodma"``
486
487    New in version Fedora3.
488
489--linear
490
491    New in version Fedora3.
492
493    Removed in version Fedora4.
494
495--nolinear
496
497    New in version Fedora3.
498
499    Removed in version Fedora4.
500
501--location {mbr,partition,none,boot}
502
503    Specifies where the boot record is written. Valid values are the following: mbr (the default), partition (installs the boot loader on the first sector of the partition containing the kernel), or none (do not install the boot loader).
504
505    Note bootloader –location=none is different from bootloader –location=none –disabled. –location=none prevents extra installation steps that makes the target machine bootable, e.g. write to MBR on x86 BIOS systems. However, the corresponding RPM packages are still installed, and –disabled can be appended to prevent it. bootloader –disabled only does not prevent the installation of the bootloader and Anaconda will complain if no other options are provided.
506
507    New in version Fedora3.
508
509--password PASSWORD
510
511    If using GRUB, sets the GRUB boot loader password. This should be used to restrict access to the GRUB shell, where arbitrary kernel options can be passed.
512
513    New in version Fedora3.
514
515--useLilo
516
517    New in version Fedora3.
518
519    Removed in version Fedora4.
520
521--driveorder DRIVEORDER
522
523    New in version Fedora3.
524
525--timeout TIMEOUT
526
527    Specify the number of seconds before the bootloader times out and boots the default option.
528
529    New in version Fedora8.
530
531--default DEFAULT
532
533    Sets the default boot image in the bootloader configuration.
534
535    New in version Fedora8.
536
537--lba32
538
539    New in version Fedora3.
540
541    Deprecated since version Fedora12.
542
543    Removed in version Fedora14.
544
545--iscrypted
546
547    If given, the password specified by --password= is already encrypted and should be passed to the bootloader configuration without additional modification.
548
549    New in version Fedora15.
550
551--md5pass _MD5PASS
552
553    If using GRUB, similar to --password= except the password should already be encrypted.
554
555    New in version Fedora3.
556
557    Changed in version Fedora15.
558
559    If using GRUB, similar to --password= except the password should already be encrypted.
560
561--boot-drive BOOTDRIVE
562
563    Specifies which drive the bootloader should be written to and thus, which drive the computer will boot from.
564
565    New in version Fedora17.
566
567--leavebootorder
568
569    On EFI or ISeries/PSeries machines, this option prevents the installer from making changes to the existing list of bootable images.
570
571    New in version Fedora18.
572
573--extlinux
574
575    Use the extlinux bootloader instead of GRUB. This option only works on machines that are supported by extlinux.
576
577    New in version Fedora19.
578
579--disabled
580
581    Do not install the boot loader.
582
583    Note bootloader –location=none is different from bootloader –location=none –disabled. –location=none prevents extra installation steps that makes the target machine bootable, e.g. write to MBR on x86 BIOS systems. However, the corresponding RPM packages are still installed, and –disabled can be appended to prevent it. bootloader –disabled only does not prevent the installation of the bootloader and Anaconda will complain if no other options are provided.
584
585    New in version Fedora21.
586
587--nombr
588
589    New in version Fedora21.
590
591--upgrade
592
593    New in version Fedora3.
594
595    Deprecated since version Fedora29.
596
597btrfs
598
599btrfs [--noformat] [--useexisting] [--label LABEL] [--data DATALEVEL]
600  [--metadata METADATALEVEL] [--subvol] [--parent PARENT] [--name NAME]
601  [--mkfsoptions MKFSOPTS]
602
603New in version Fedora17.
604
605Defines a BTRFS volume or subvolume. This command is of the form:
606
607btrfs <mntpoint> --data=<level> --metadata=<level> --label=<label> <partitions*>
608
609for volumes and of the form:
610
611btrfs <mntpoint> --subvol --name=<path> <parent>
612
613for subvolumes.
614
615The <partitions*> (which denotes that multiple partitions can be listed) lists the BTRFS identifiers to add to the BTRFS volume. For subvolumes, should be the identifier of the subvolume’s parent volume.
616
617<mntpoint>
618
619Location where the file system is mounted.
620
621optional arguments:
622
623--noformat
624
625    Use an existing BTRFS volume (or subvolume) and do not reformat the filesystem.
626
627    New in version Fedora17.
628
629--useexisting
630
631    Same as --noformat.
632
633    New in version Fedora17.
634
635--label LABEL
636
637    Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created. This option has no meaning for subvolumes.
638
639    New in version Fedora17.
640
641--data DATALEVEL
642
643    RAID level to use (0, 1, 10) for filesystem data. Optional. This option has no meaning for subvolumes.
644
645    New in version Fedora17.
646
647--metadata METADATALEVEL
648
649    RAID level to use (0, 1, 10) for filesystem/volume metadata. Optional. This option has no meaning for subvolumes.
650
651    New in version Fedora17.
652
653--subvol
654
655    Create BTRFS subvolume.
656
657    New in version Fedora17.
658
659--parent PARENT
660
661    New in version Fedora17.
662
663--name NAME
664
665    Subvolume name.
666
667    New in version Fedora17.
668
669--mkfsoptions MKFSOPTS
670
671    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
672
673    New in version Fedora23.
674
675The following example shows how to create a BTRFS volume from member partitions on three disks with subvolumes for root and home. The main volume is not mounted or used directly in this example – only the root and home subvolumes:
676
677part btrfs.01 --size=6000 --ondisk=sda
678part btrfs.02 --size=6000 --ondisk=sdb
679part btrfs.03 --size=6000 --ondisk=sdc
680
681btrfs none --data=0 --metadata=1 --label=f17 btrfs.01 btrfs.02 btrfs.03
682btrfs / --subvol --name=root LABEL=f17
683btrfs /home --subvol --name=home f17
684
685cdrom
686
687cdrom
688
689New in version Fedora3.
690
691Install from the first CD-ROM/DVD drive on the system.
692clearpart
693
694clearpart [--all] [--drives DRIVES] [--initlabel] [--linux] [--none]
695      [--list DEVICES] [--disklabel DISKLABEL] [--cdl]
696
697New in version Fedora3.
698
699Removes partitions from the system, prior to creation of new partitions. By default, no partitions are removed.
700
701If the clearpart command is used, then the --onpart command cannot be used on a logical partition.
702
703optional arguments:
704
705--all
706
707    Erases all partitions from the system.
708
709    New in version Fedora3.
710
711--drives DRIVES
712
713    Specifies which drives to clear partitions from. For example, the following clears the partitions on the first two drives on the primary IDE controller:
714
715    ``clearpart --all --drives=sda,sdb``
716
717    New in version Fedora3.
718
719--initlabel
720
721    Initializes the disk label to the default for your architecture (for example msdos for x86 and gpt for Itanium). This is only meaningful in combination with the ‘–all’ option.
722
723    New in version Fedora3.
724
725--linux
726
727    Erases all Linux partitions.
728
729    New in version Fedora3.
730
731--none
732
733    Do not remove any partitions. This is the default
734
735    New in version Fedora3.
736
737--list DEVICES
738
739    Specifies which partitions to clear. If given, this supersedes any of the --all and --linux options. This can be across different drives:
740
741    ``clearpart --list=sda2,sda3,sdb1``
742
743    New in version Fedora17.
744
745--disklabel DISKLABEL
746
747    Set the default disklabel to use. Only disklabels supported for the platform will be accepted. eg. msdos and gpt for x86_64 but not dasd.
748
749    New in version Fedora21.
750
751--cdl
752
753    Reformat any LDL DASDs to CDL format.
754
755    New in version Fedora28.
756
757graphical or text or cmdline
758
759graphical|text|cmdline [--non-interactive]
760
761New in version Fedora3.
762
763Controls which display mode will be used during installation. If cmdline is chosen all required installation options must be configured via kickstart otherwise the installation will fail.
764
765optional arguments:
766
767--non-interactive
768
769    Perform the installation in a completely non-interactive mode. This mode will kill the installation when user interaction will be required. Can’t be used with cmdline mode. This option is especially useful for automated testing purpose.
770
771    New in version Fedora26.
772
773device
774
775device [--opts MODULEOPTS]
776
777New in version Fedora3.
778
779On most PCI systems, the installation program will autoprobe for Ethernet and SCSI cards properly. On older systems and some PCI systems, however, kickstart needs a hint to find the proper devices. The device command, which tells the installation program to install extra modules, is in this format:
780
781device <moduleName> --opts=<options>
782
783<moduleName>
784
785Replace with the name of the kernel module which should be installed.
786
787Deprecated since version Fedora24.
788
789optional arguments:
790
791--opts MODULEOPTS
792
793    Options to pass to the kernel module. For example:
794
795    --opts="aic152x=0x340 io=11"
796
797    New in version Fedora3.
798
799deviceprobe
800
801deviceprobe
802
803New in version Fedora3.
804
805Deprecated since version Fedora29.
806dmraid
807
808dmraid --name NAME --dev DEVICES
809
810New in version Fedora6.
811
812Deprecated since version Fedora24.
813
814optional arguments:
815
816--name NAME
817
818    New in version Fedora6.
819
820--dev DEVICES
821
822    New in version Fedora6.
823
824driverdisk
825
826driverdisk [--source SOURCE] [--biospart BIOSPART] [partition [partition ...]]
827
828New in version Fedora3.
829
830Driver diskettes can be used during kickstart installations. You need to copy the driver disk’s contents to the root directory of a partition on the system’s hard drive. Then you need to use the driverdisk command to tell the installation program where to look for the driver disk.
831
832positional arguments:
833
834partition
835
836    Partition containing the driver disk.
837
838    New in version Fedora3.
839
840optional arguments:
841
842--source SOURCE
843
844    Specify a URL for the driver disk. NFS locations can be given with nfs:host:/path/to/img.
845
846    New in version Fedora3.
847
848--biospart BIOSPART
849
850    BIOS partition containing the driver disk (such as 82p2).
851
852    New in version Fedora4.
853
854--type TYPE
855
856    New in version Fedora3.
857
858    Deprecated since version Fedora12.
859
860    Removed in version Fedora14.
861
862eula
863
864eula [--agreed]
865
866New in version Fedora20.
867
868Automatically accept Red Hat’s EULA
869
870optional arguments:
871
872--agreed, --agree, --accepted, --accept
873
874    Accept the EULA. This is mandatory option!
875
876    New in version Fedora20.
877
878fcoe
879
880fcoe --nic NIC [--dcb] [--autovlan]
881
882New in version Fedora12.
883
884Discover and attach FCoE storage devices accessible via specified network interface
885
886optional arguments:
887
888--nic NIC
889
890    Name of the network device connected to the FCoE switch
891
892    New in version Fedora12.
893
894--dcb
895
896    Enable Data Center Bridging awareness in installer. This option should only be enabled for network interfaces that require a host-based DCBX client. Configurations on interfaces that implement a hardware DCBX client should not use it.
897
898    New in version Fedora13.
899
900--autovlan
901
902    Perform automatic VLAN discovery and setup. This option is enabled by default.
903
904    New in version Fedora28.
905
906firewall
907
908firewall [--disable] [--enable] [--port PORTS] [--trust TRUSTS]
909     [--service SERVICES] [--ftp] [--http] [--smtp] [--ssh]
910     [--remove-service REMOVE_SERVICES] [--use-system-defaults]
911
912New in version Fedora3.
913
914This option corresponds to the Firewall Configuration screen in the installation program
915
916optional arguments:
917
918--disable, --disabled
919
920    Do not configure any iptables rules.
921
922    New in version Fedora3.
923
924--enable, --enabled
925
926    Reject incoming connections that are not in response to outbound requests, such as DNS replies or DHCP requests. If access to services running on this machine is needed, you can choose to allow specific services through the firewall.
927
928    New in version Fedora3.
929
930--high HIGH
931
932    New in version Fedora3.
933
934    Deprecated since version Fedora3.
935
936    Removed in version Fedora9.
937
938--medium MEDIUM
939
940    New in version Fedora3.
941
942    Deprecated since version Fedora3.
943
944    Removed in version Fedora9.
945
946--port PORTS
947
948    You can specify that ports be allowed through the firewall using the port:protocol format. You can also specify ports numerically. Multiple ports can be combined into one option as long as they are separated by commas. For example:
949
950    ``firewall --port=imap:tcp,1234:ucp,47``
951
952    New in version Fedora3.
953
954--trust TRUSTS
955
956    Listing a device here, such as eth0, allows all traffic coming from that device to go through the firewall. To list more than one device, use –trust eth0 –trust eth1. Do NOT use a comma-separated format such as –trust eth0, eth1.
957
958    New in version Fedora3.
959
960--service SERVICES
961
962    This option provides a higher-level way to allow services through the firewall. Some services (like cups, avahi, etc.) require multiple ports to be open or other special configuration in order for the service to work. You could specify each individual service with the --port option, or specify --service= and open them all at once.
963
964    Valid options are anything recognized by the firewall-cmd program in the firewalld package. If firewalld is running:
965
966    ``firewall-cmd --get-services``
967
968    will provide a list of known service names.
969
970    New in version Fedora10.
971
972--ftp
973
974    New in version Fedora3.
975
976    Changed in version Fedora10.
977
978--http
979
980    New in version Fedora3.
981
982    Changed in version Fedora10.
983
984--smtp
985
986    New in version Fedora3.
987
988    Changed in version Fedora10.
989
990--ssh
991
992    New in version Fedora3.
993
994    Changed in version Fedora10.
995
996--telnet TELNET
997
998    New in version Fedora3.
999
1000    Deprecated since version Fedora10.
1001
1002    Removed in version Fedora14.
1003
1004--remove-service REMOVE_SERVICES
1005
1006    New in version Fedora20.
1007
1008--use-system-defaults
1009
1010    Don’t configure the firewall at all. This instructs anaconda to do nothing and allows the system to rely on the defaults that were provided with the package or ostree. If this option is used with other options then all other options will be ignored.
1011
1012    New in version Fedora28.
1013
1014firstboot
1015
1016firstboot [--disable] [--enable] [--reconfig]
1017
1018New in version Fedora3.
1019
1020Determine whether the Setup Agent starts the first time the system is booted. If enabled, the initial-setup package must be installed. If not specified, the setup agent (initial-setup) is disabled by default.
1021
1022optional arguments:
1023
1024--disable, --disabled
1025
1026    The Setup Agent is not started the first time the system boots.
1027
1028    New in version Fedora3.
1029
1030--enable, --enabled
1031
1032    The Setup Agent is started the first time the system boots.
1033
1034    New in version Fedora3.
1035
1036--reconfig
1037
1038    Enable the Setup Agent to start at boot time in reconfiguration mode. This mode enables the language, mouse, keyboard, root password, security level, time zone, and networking configuration options in addition to the default ones.
1039
1040    New in version Fedora3.
1041
1042group
1043
1044group --name NAME [--gid GID]
1045
1046New in version Fedora12.
1047
1048Creates a new user group on the system. If a group with the given name or GID already exists, this command will fail. In addition, the user command can be used to create a new group for the newly created user.
1049
1050optional arguments:
1051
1052--name NAME
1053
1054    Provides the name of the new group.
1055
1056    New in version Fedora12.
1057
1058--gid GID
1059
1060    The group’s GID. If not provided, this defaults to the next available non-system GID.
1061
1062    New in version Fedora12.
1063
1064reboot or poweroff or shutdown or halt
1065
1066reboot|poweroff|shutdown|halt [--eject] [--kexec]
1067
1068New in version Fedora3.
1069
1070reboot
1071
1072Reboot after the installation is complete. Normally, kickstart displays a message and waits for the user to press a key before rebooting.
1073
1074poweroff
1075
1076Turn off the machine after the installation is complete. Normally, kickstart displays a message and waits for the user to press a key before rebooting.
1077
1078shutdown
1079
1080At the end of installation, shut down the machine. This is the same as the poweroff command. Normally, kickstart displays a message and waits for the user to press a key before rebooting.
1081
1082halt
1083
1084At the end of installation, display a message and wait for the user to press a key before rebooting. This is the default action.
1085
1086Changed in version Fedora18.
1087
1088The ‘halt’ command was added!
1089
1090optional arguments:
1091
1092--eject
1093
1094    Attempt to eject CD or DVD media before rebooting.
1095
1096    New in version Fedora6.
1097
1098--kexec
1099
1100    Use kexec to reboot into the new system, bypassing BIOS/Firmware and bootloader.
1101
1102    New in version Fedora23.
1103
1104harddrive
1105
1106harddrive [--biospart BIOSPART] [--partition PARTITION] --dir DIR
1107
1108New in version Fedora3.
1109
1110Install from a directory of ISO images on a local drive, which must be either vfat or ext2. In addition to this directory, you must also provide the install.img in some way. You can either do this by booting off the boot.iso or by creating an images/ directory in the same directory as the ISO images and placing install.img in there.
1111
1112optional arguments:
1113
1114--biospart BIOSPART
1115
1116    BIOS partition to install from (such as 82p2).
1117
1118    New in version Fedora3.
1119
1120--partition PARTITION
1121
1122    Partition to install from (such as, sdb2).
1123
1124    New in version Fedora3.
1125
1126--dir DIR
1127
1128    Directory containing both the ISO images and the images/install.img. For example:
1129
1130    ``harddrive --partition=hdb2 --dir=/tmp/install-tree``
1131
1132    New in version Fedora3.
1133
1134hmc
1135
1136hmc
1137
1138New in version RedHatEnterpriseLinux7.
1139
1140Install from an installation medium via SE/HMC on z Systems.
1141ignoredisk
1142
1143ignoredisk [--drives IGNOREDISK] [--only-use ONLYUSE] [--interactive]
1144
1145New in version Fedora3.
1146
1147Controls anaconda’s access to disks attached to the system. By default, all disks will be available for partitioning. Only one of the following three options may be used.
1148
1149optional arguments:
1150
1151--drives IGNOREDISK
1152
1153    Specifies those disks that anaconda should not touch when partitioning, formatting, and clearing.
1154
1155    New in version Fedora3.
1156
1157    Changed in version Fedora8.
1158
1159    This argument is no longer required!
1160
1161--only-use ONLYUSE
1162
1163    Specifies the opposite - only disks listed here will be used during installation.
1164
1165    New in version Fedora8.
1166
1167--interactive
1168
1169    Allow the user manually navigate the advanced storage screen.
1170
1171    New in version RedHatEnterpriseLinux6.
1172
1173    Deprecated since version Fedora29.
1174
1175install
1176
1177install [--root-device ROOT_DEVICE]
1178
1179        Install a fresh system. You must specify the type of
1180        installation from one of cdrom, harddrive, nfs, or url
1181        (for ftp or http installations).
1182        The install command and the installation method command
1183        must be on separate lines.
1184
1185        Important: before Fedora 20 this command was known as
1186        install or upgrade but the upgrade part was deprecated!
1187
1188Deprecated since version Fedora29.
1189
1190optional arguments:
1191
1192--root-device ROOT_DEVICE
1193
1194    On a system with multiple installs, this option specifies which filesystem holds the installation to be upgraded. This can be specified by device name, UUID=, or LABEL= just like the harddrive command may be.
1195
1196    New in version Fedora11.
1197
1198interactive
1199
1200interactive
1201
1202New in version Fedora3.
1203
1204Use interactive kickstart installation method.
1205
1206Deprecated since version Fedora14.
1207iscsi
1208
1209iscsi [--target TARGET] --ipaddr IPADDR [--port PORT] [--user USER]
1210  [--password PASSWORD] [--reverse-user USER_IN]
1211  [--reverse-password PASSWORD_IN] [--iface IFACE]
1212
1213New in version Fedora6.
1214
1215Specifies additional iSCSI storage to be attached during installation. If you use the iscsi parameter, you must also assign a name to the iSCSI node, using the iscsiname parameter. The iscsiname parameter must appear before the iscsi parameter in the kickstart file.
1216
1217We recommend that wherever possible you configure iSCSI storage in the system BIOS or firmware (iBFT for Intel systems) rather than use the iscsi parameter. Anaconda automatically detects and uses disks configured in BIOS or firmware and no special configuration is necessary in the kickstart file.
1218
1219If you must use the iscsi parameter, ensure that networking is activated at the beginning of the installation, and that the iscsi parameter appears in the kickstart file before you refer to iSCSI disks with parameters such as clearpart or ignoredisk.
1220
1221optional arguments:
1222
1223--target TARGET
1224
1225    The target iqn.
1226
1227    New in version Fedora6.
1228
1229--ipaddr IPADDR
1230
1231    The IP address of the target to connect to.
1232
1233    New in version Fedora6.
1234
1235--port PORT
1236
1237    The port number to connect to (default, –port=3260).
1238
1239    New in version Fedora6.
1240
1241--user USER
1242
1243    The username required to authenticate with the target.
1244
1245    New in version Fedora6.
1246
1247--password PASSWORD
1248
1249    The password that corresponds with the username specified for the target.
1250
1251    New in version Fedora6.
1252
1253--reverse-user USER_IN
1254
1255    The username required to authenticate with the initiator from a target that uses reverse CHAP authentication.
1256
1257    New in version Fedora10.
1258
1259--reverse-password PASSWORD_IN
1260
1261    The password that corresponds with the username specified for the initiator.
1262
1263    New in version Fedora10.
1264
1265--iface IFACE
1266
1267    Bind connection to specific network interface instead of using the default one determined by network layer. Once used, it must be specified for all iscsi commands.
1268
1269    New in version Fedora17.
1270
1271iscsiname
1272
1273iscsiname <iqn>
1274
1275New in version Fedora6.
1276
1277Assigns an initiator name to the computer. If you use the iscsi parameter in your kickstart file, this parameter is mandatory, and you must specify iscsiname in the kickstart file before you specify iscsi.
1278
1279positional arguments:
1280
1281<iqn>
1282
1283    IQN name
1284
1285    New in version Fedora6.
1286
1287keyboard
1288
1289keyboard [--vckeymap VC_KEYMAP] [--xlayouts X_LAYOUTS]
1290     [--switch SWITCH_OPTIONS]
1291     [kbd [kbd ...]]
1292
1293New in version Fedora3.
1294
1295This required command sets system keyboard type.
1296
1297Changed in version Fedora18.
1298
1299See the documentation of --vckeymap option and the tip at the end of this section for a guide how to get values accepted by this command.
1300
1301Either --vckeymap or --xlayouts must be used.
1302
1303Alternatively, use the older format, arg, which is still supported. arg can be an X layout or VConsole keymap name.
1304
1305Missing values will be automatically converted from the given one(s).
1306
1307positional arguments:
1308
1309kbd
1310
1311    Keyboard type
1312
1313    New in version Fedora3.
1314
1315optional arguments:
1316
1317--vckeymap VC_KEYMAP
1318
1319    Specify VConsole keymap that should be used. is a keymap name which is the same as the filename under /usr/lib/kbd/keymaps/ without the .map.gz extension.
1320
1321    New in version Fedora18.
1322
1323--xlayouts X_LAYOUTS
1324
1325    Specify a list of X layouts that should be used (comma-separated list without spaces). Accepts the same values as setxkbmap(1), but uses either the layout format (such as cz) or the ‘layout (variant)’ format (such as ‘cz (qwerty)’). For example:
1326
1327    ``keyboard --xlayouts=cz,'cz (qwerty)'`
1328
1329    New in version Fedora18.
1330
1331--switch SWITCH_OPTIONS
1332
1333    Specify a list of layout switching options that should be used (comma-separated list without spaces). Accepts the same values as setxkbmap(1) for layout switching. For example:
1334
1335    ``keyboard --xlayouts=cz,'cz (qwerty)' --switch=grp:alt_shift_toggle``
1336
1337    New in version Fedora18.
1338
1339If you know only the description of the layout (e.g. Czech (qwerty)), you can use http://vpodzime.fedorapeople.org/layouts_list.py to list all available layouts and find the one you want to use. The string in square brackets is the valid layout specification as Anaconda accepts it. The same goes for switching options and http://vpodzime.fedorapeople.org/switching_list.py
1340lang
1341
1342lang [--addsupport LOCALE] <lang>
1343
1344New in version Fedora3.
1345
1346This required command sets the language to use during installation and the default language to use on the installed system to <id>. This can be the same as any recognized setting for the $LANG environment variable, though not all languages are supported during installation.
1347
1348Certain languages (mainly Chinese, Japanese, Korean, and Indic languages) are not supported during text mode installation. If one of these languages is specified using the lang command, installation will continue in English though the running system will have the specified langauge by default.
1349
1350The file /usr/share/system-config-language/locale-list provides a list the valid language codes in the first column of each line and is part of the system-config-languages package.
1351
1352positional arguments:
1353
1354<lang>
1355
1356    Language ID.
1357
1358    New in version Fedora3.
1359
1360optional arguments:
1361
1362--addsupport LOCALE
1363
1364    Install the support packages for the given locales, specified as a comma-separated list. Each locale may be specified in the same ways as the primary language may be, as described above.
1365
1366    New in version Fedora19.
1367
1368langsupport
1369
1370langsupport [--default DEFLANG]
1371
1372New in version Fedora3.
1373
1374Install the support packages for the given locales.
1375
1376Deprecated since version Fedora5.
1377
1378optional arguments:
1379
1380--default DEFLANG
1381
1382    Default locale
1383
1384    New in version Fedora3.
1385
1386lilo
1387
1388lilo [--append APPENDLINE] [--linear] [--nolinear]
1389 [--location {mbr,partition,none,boot}] [--lba32] [--password PASSWORD]
1390 [--md5pass MD5PASS] [--upgrade] [--useLilo] [--driveorder DRIVEORDER]
1391
1392New in version Fedora3.
1393
1394This required command specifies how the boot loader should be installed.
1395
1396There must be a biosboot partition for the bootloader to be installed successfully onto a disk that contains a GPT/GUID partition table, which includes disks initialized by anaconda. This partition may be created with the kickstart command part biosboot --fstype=biosboot --size=1. However, in the case that a disk has an existing biosboot partition, adding a part biosboot option is unnecessary.
1397
1398Deprecated since version Fedora4.
1399
1400optional arguments:
1401
1402--append APPENDLINE
1403
1404    Specifies kernel parameters. The default set of bootloader arguments is “rhgb quiet”. You will get this set of arguments regardless of what parameters you pass to –append, or if you leave out –append entirely. For example:
1405
1406    ``bootloader --location=mbr --append="hdd=ide-scsi ide=nodma"``
1407
1408    New in version Fedora3.
1409
1410--linear
1411
1412    New in version Fedora3.
1413
1414--nolinear
1415
1416    New in version Fedora3.
1417
1418--location {mbr,partition,none,boot}
1419
1420    Specifies where the boot record is written. Valid values are the following: mbr (the default), partition (installs the boot loader on the first sector of the partition containing the kernel), or none (do not install the boot loader).
1421
1422    Note bootloader –location=none is different from bootloader –location=none –disabled. –location=none prevents extra installation steps that makes the target machine bootable, e.g. write to MBR on x86 BIOS systems. However, the corresponding RPM packages are still installed, and –disabled can be appended to prevent it. bootloader –disabled only does not prevent the installation of the bootloader and Anaconda will complain if no other options are provided.
1423
1424    New in version Fedora3.
1425
1426--lba32
1427
1428    New in version Fedora3.
1429
1430--password PASSWORD
1431
1432    If using GRUB, sets the GRUB boot loader password. This should be used to restrict access to the GRUB shell, where arbitrary kernel options can be passed.
1433
1434    New in version Fedora3.
1435
1436--md5pass MD5PASS
1437
1438    If using GRUB, similar to --password= except the password should already be encrypted.
1439
1440    New in version Fedora3.
1441
1442--upgrade
1443
1444    New in version Fedora3.
1445
1446--useLilo
1447
1448    New in version Fedora3.
1449
1450--driveorder DRIVEORDER
1451
1452    New in version Fedora3.
1453
1454lilocheck
1455
1456lilocheck
1457
1458New in version Fedora3.
1459
1460Deprecated since version Fedora4.
1461liveimg
1462
1463liveimg --url <url> [--proxy <proxyurl>] [--noverifyssl] [--checksum <sha256>]
1464
1465New in version Fedora19.
1466
1467Install a disk image instead of packages. The image can be the squashfs.img from a Live iso, or any filesystem mountable by the install media (eg. ext4). Anaconda expects the image to contain utilities it needs to complete the system install so the best way to create one is to use livemedia-creator to make the disk image. If the image contains /LiveOS/*.img (this is how squashfs.img is structured) the first *.img file inside LiveOS will be mounted and used to install the target system. The URL may also point to a tarfile of the root filesystem. The file must end in .tar, .tbz, .tgz, .txz, .tar.bz2, tar.gz, tar.xz
1468
1469optional arguments:
1470
1471--url <url>
1472
1473    The URL to install from. http, https, ftp and file are supported.
1474
1475    New in version Fedora19.
1476
1477--proxy <proxyurl>
1478
1479    Specify an HTTP/HTTPS/FTP proxy to use while performing the install. The various parts of the argument act like you would expect. Syntax is:
1480
1481    ``--proxy=[protocol://][username[:password]@]host[:port]``
1482
1483    New in version Fedora19.
1484
1485--noverifyssl
1486
1487    For a tree on a HTTPS server do not check the server’s certificate with what well-known CA validate and do not check the server’s hostname matches the certificate’s domain name.
1488
1489    New in version Fedora19.
1490
1491--checksum <sha256>
1492
1493    Optional sha256 checksum of the image file
1494
1495    New in version Fedora19.
1496
1497logging
1498
1499logging [--host HOST] [--port PORT]
1500    [--level {debug,info,warning,error,critical}]
1501
1502New in version Fedora6.
1503
1504This command controls the error logging of anaconda during installation. It has no effect on the installed system.
1505
1506optional arguments:
1507
1508--host HOST
1509
1510    Send logging information to the given remote host, which must be running a syslogd process configured to accept remote logging.
1511
1512    New in version Fedora6.
1513
1514--port PORT
1515
1516    If the remote syslogd process uses a port other than the default, it may be specified with this option.
1517
1518    New in version Fedora6.
1519
1520--level {debug,info,warning,error,critical}
1521
1522    Specify the minimum level of messages that appear on tty3. All messages will still be sent to the log file regardless of this level, however.
1523
1524    New in version Fedora6.
1525
1526logvol
1527
1528logvol [--fstype FSTYPE] [--grow] [--maxsize MAXSIZEMB] --name NAME
1529   [--noformat] [--percent PERCENT] [--recommended] [--size SIZE]
1530   [--useexisting] --vgname VGNAME [--fsoptions FSOPTS]
1531   [--fsprofile FSPROFILE] [--encrypted] [--passphrase PASSPHRASE]
1532   [--escrowcert <url>] [--backuppassphrase] [--label LABEL] [--resize]
1533   [--hibernation] [--cipher CIPHER] [--thinpool] [--thin]
1534   [--poolname POOL_NAME] [--chunksize CHUNK_SIZE]
1535   [--metadatasize METADATA_SIZE] [--profile PROFILE]
1536   [--cachesize CACHE_SIZE] [--cachemode CACHE_MODE]
1537   [--cachepvs CACHE_PVS] [--mkfsoptions MKFSOPTS]
1538   [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
1539   [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
1540   [--pbkdf-iterations PBKDF_ITERATIONS]
1541   <mntpoint>
1542
1543New in version Fedora3.
1544
1545Create a logical volume for Logical Volume Management (LVM).
1546
1547positional arguments:
1548
1549<mntpoint>
1550
1551    Mountpoint for this logical volume or ‘none’.
1552
1553    New in version Fedora3.
1554
1555optional arguments:
1556
1557--fstype FSTYPE
1558
1559    Sets the file system type for the logical volume. Valid values include ext4, ext3, ext2, btrfs, swap, and vfat. Other filesystems may be valid depending on command line arguments passed to Anaconda to enable other filesystems.
1560
1561    New in version Fedora3.
1562
1563--grow
1564
1565    Tells the logical volume to grow to fill available space (if any), or up to the maximum size setting. Note that --grow is not supported for logical volumes containing a RAID volume on top of them.
1566
1567    New in version Fedora3.
1568
1569--maxsize MAXSIZEMB
1570
1571    The maximum size in MiB the logical volume may grow to. Specify an integer value here, and do not append any units. This option is only relevant if --grow is specified as well.
1572
1573    New in version Fedora3.
1574
1575--name NAME
1576
1577    The name of this logical volume.
1578
1579    New in version Fedora3.
1580
1581--noformat
1582
1583    Use an existing logical volume and do not format it.
1584
1585    New in version Fedora3.
1586
1587--percent PERCENT
1588
1589    Specify the size of the logical volume as a percentage of available space in the volume group. Without the above --grow option, this may not work.
1590
1591    New in version Fedora3.
1592
1593--recommended
1594
1595    Determine the size of the logical volume automatically.
1596
1597    New in version Fedora3.
1598
1599--size SIZE
1600
1601    Size of this logical volume.
1602
1603    New in version Fedora3.
1604
1605--useexisting
1606
1607    Use an existing logical volume and reformat it.
1608
1609    New in version Fedora3.
1610
1611--vgname VGNAME
1612
1613    Name of the Volume Group this logical volume belongs to.
1614
1615    New in version Fedora3.
1616
1617--fsoptions FSOPTS
1618
1619    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
1620
1621    New in version Fedora4.
1622
1623--bytes-per-inode BYTES_PER_INODE
1624
1625    Specify the bytes/inode ratio.
1626
1627    New in version Fedora4.
1628
1629    Deprecated since version Fedora9.
1630
1631    Removed in version Fedora14.
1632
1633--fsprofile FSPROFILE
1634
1635    Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2/3/4, this configuration file is /etc/mke2fs.conf.
1636
1637    New in version Fedora9.
1638
1639--encrypted
1640
1641    Specify that this logical volume should be encrypted.
1642
1643    New in version Fedora9.
1644
1645--passphrase PASSPHRASE
1646
1647    Specify the passphrase to use when encrypting this logical volume. Without the above --encrypted option, this option does nothing. If no passphrase is specified, the default system-wide one is used, or the installer will stop and prompt if there is no default.
1648
1649    New in version Fedora9.
1650
1651--escrowcert <url>
1652
1653    Load an X.509 certificate from <url>. Store the data encryption key of this logical volume, encrypted using the certificate, as a file in /root. Only relevant if --encrypted is specified as well.
1654
1655    New in version Fedora12.
1656
1657--backuppassphrase
1658
1659    Only relevant if --escrowcert is specified as well. In addition to storing the data encryption key, generate a random passphrase and add it to this logical volume. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as a file in /root. If more than one LUKS volume uses --backuppassphrase, the same passphrase will be used for all such volumes.
1660
1661    New in version Fedora12.
1662
1663--label LABEL
1664
1665    Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created.
1666
1667    New in version Fedora15.
1668
1669--resize
1670
1671    Attempt to resize this logical volume to the size given by --size=. This option must be used with --useexisting --size=, or an error will be raised.
1672
1673    New in version Fedora17.
1674
1675--hibernation
1676
1677    This option can be used to automatically determine the size of the swap partition big enough for hibernation.
1678
1679    New in version Fedora18.
1680
1681--cipher CIPHER
1682
1683    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
1684
1685    New in version Fedora18.
1686
1687--thinpool
1688
1689    Create a thin pool logical volume. Use a mountpoint of ‘none’.
1690
1691    New in version Fedora20.
1692
1693--thin
1694
1695    Create a thin logical volume. Requires --poolname.
1696
1697    New in version Fedora20.
1698
1699--poolname POOL_NAME
1700
1701    Specify the name of the thin pool in which to create a thin logical volume. Requires --thin.
1702
1703    New in version Fedora20.
1704
1705--chunksize CHUNK_SIZE
1706
1707    Specify the chunk size (in KiB) for a new thin pool device.
1708
1709    New in version Fedora20.
1710
1711--metadatasize METADATA_SIZE
1712
1713    Specify the metadata area size (in MiB) for a new thin pool device.
1714
1715    New in version Fedora20.
1716
1717--profile PROFILE
1718
1719    Specify an LVM profile for the thin pool (see lvm(8), standard profiles are default and thin-performance defined in the /etc/lvm/profile/ directory).
1720
1721    New in version Fedora21.
1722
1723--cachesize CACHE_SIZE
1724
1725    Requested size (in MiB) of cache attached to the logical volume. Requires --cachepvs.
1726
1727    New in version Fedora23.
1728
1729--cachemode CACHE_MODE
1730
1731    Mode that should be used for the cache. Either writeback or writethrough.
1732
1733    New in version Fedora23.
1734
1735--cachepvs CACHE_PVS
1736
1737    Comma-separated list of (fast) physical volumes that should be used for the cache.
1738
1739    New in version Fedora23.
1740
1741--mkfsoptions MKFSOPTS
1742
1743    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
1744
1745    New in version Fedora23.
1746
1747--luks-version LUKS_VERSION
1748
1749    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
1750
1751    New in version Fedora29.
1752
1753--pbkdf PBKDF
1754
1755    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
1756
1757    New in version Fedora29.
1758
1759--pbkdf-memory PBKDF_MEMORY
1760
1761    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
1762
1763    New in version Fedora29.
1764
1765--pbkdf-time PBKDF_TIME
1766
1767    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
1768
1769    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
1770
1771    New in version Fedora29.
1772
1773--pbkdf-iterations PBKDF_ITERATIONS
1774
1775    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
1776
1777    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
1778
1779    New in version Fedora29.
1780
1781Create the partition first, create the logical volume group, and then create the logical volume. For example:
1782
1783part pv.01 --size 3000
1784volgroup myvg pv.01
1785logvol / --vgname=myvg --size=2000 --name=rootvol
1786
1787mediacheck
1788
1789mediacheck
1790
1791New in version Fedora4.
1792
1793If given, this will force anaconda to run mediacheck on the installation media. This command requires that installs be attended, so it is disabled by default.
1794method
1795
1796method
1797
1798New in version Fedora3.
1799
1800Proxy to the actual installation method. Valid installation methods are:
1801
1802    cdrom
1803    harddrive
1804    nfs
1805    url
1806    liveimg
1807    hmc
1808
1809module
1810
1811module --name <module_name> [--stream <module_stream_name>]
1812
1813New in version Fedora29.
1814
1815The module command makes it possible to manipulate modules.
1816
1817(In this case we mean modules as introduced by the Fedora modularity initiative.)
1818
1819A module is defined by a unique name and a stream id, where single module can (and usually has) multiple available streams.
1820
1821Streams will in most cases corresponds to stable releases of the given software components (such as Node.js, Django, etc.) but there could be also other use cases, such as a raw upstream master branch stream or streams corresponding to an upcoming stable release.
1822
1823For more information see the Fedora modularity initiative documentation: https://docs.pagure.org/modularity/
1824
1825optional arguments:
1826
1827--name <module_name>
1828
1829    Name of the module to enable.
1830
1831    New in version Fedora29.
1832
1833--stream <module_stream_name>
1834
1835    Name of the module stream to enable.
1836
1837    New in version Fedora29.
1838
1839monitor
1840
1841monitor [--hsync HSYNC] [--monitor MONITOR] [--vsync VSYNC] [--noprobe]
1842
1843New in version Fedora3.
1844
1845If the monitor command is not given, anaconda will use X to automatically detect your monitor settings. Please try this before manually configuring your monitor.
1846
1847Deprecated since version Fedora10.
1848
1849optional arguments:
1850
1851--hsync HSYNC
1852
1853    Specifies the horizontal sync frequency of the monitor.
1854
1855    New in version Fedora3.
1856
1857--monitor MONITOR
1858
1859    Use specified monitor; monitor name should be from the list of monitors in /usr/share/hwdata/MonitorsDB from the hwdata package. The list of monitors can also be found on the X Configuration screen of the Kickstart Configurator. This is ignored if --hsync or --vsync is provided. If no monitor information is provided, the installation program tries to probe for it automatically.
1860
1861    New in version Fedora3.
1862
1863--vsync VSYNC
1864
1865    Specifies the vertical sync frequency of the monitor.
1866
1867    New in version Fedora3.
1868
1869--noprobe
1870
1871    Do not probe the monitor.
1872
1873    New in version Fedora6.
1874
1875mount
1876
1877mount [--reformat [REFORMAT]] [--mkfsoptions MKFS_OPTS]
1878  [--mountoptions MOUNT_OPTS]
1879  <device> <mntpoint>
1880
1881New in version Fedora27.
1882
1883Assigns a mount point to a block device and optionally reformats it to a given format. It at least requires a device and a mount point where the mount point can be none in case the format on the device is not mountable or in case the device should just be reformatted.
1884
1885The difference between this command and the other commands for storage configuration (part, logvol,…) is that it doesn’t require the whole storage stack to be described in the kickstart file. The user just needs to make sure that the specified block device exists in the system. The installer doesn’t necessarily have to know all the details about of the given device. If, on the other hand, the installer is supposed to create the storage stack with all the devices mounted at various places, the part, logvol, raid, etc. commands have to be used.
1886
1887positional arguments:
1888
1889<device>
1890
1891    The block device to mount
1892
1893    New in version Fedora27.
1894
1895<mntpoint>
1896
1897    The <mntpoint> is where the <device> will be mounted. Must be a valid mount point, for example /, /usr, /home, or none if the device cannot (e.g. swap) or should not be mounted.
1898
1899    New in version Fedora27.
1900
1901optional arguments:
1902
1903--reformat [REFORMAT]
1904
1905    Specifies the new format (e.g. a file system) for the device.
1906
1907    New in version Fedora27.
1908
1909--mkfsoptions MKFS_OPTS
1910
1911    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
1912
1913    New in version Fedora27.
1914
1915--mountoptions MOUNT_OPTS
1916
1917    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
1918
1919    New in version Fedora27.
1920
1921mouse
1922
1923mouse [--device DEVICE] [--emulthree]
1924
1925New in version RedHatEnterpriseLinux3.
1926
1927Configure the system mouse
1928
1929Deprecated since version Fedora3.
1930
1931optional arguments:
1932
1933--device DEVICE
1934
1935    Which device node to use for mouse
1936
1937    New in version RedHatEnterpriseLinux3.
1938
1939--emulthree
1940
1941    If set emulate 3 mouse buttons
1942
1943    New in version RedHatEnterpriseLinux3.
1944
1945multipath
1946
1947multipath --name NAME --device DEVICE --rule RULE
1948
1949New in version Fedora6.
1950
1951Deprecated since version Fedora24.
1952
1953optional arguments:
1954
1955--name NAME
1956
1957    New in version Fedora6.
1958
1959--device DEVICE
1960
1961    New in version Fedora6.
1962
1963--rule RULE
1964
1965    New in version Fedora6.
1966
1967network
1968
1969network [--bootproto {dhcp,bootp,static,query,ibft}] [--dhcpclass DHCPCLASS]
1970    [--device DEVICE] [--essid ESSID] [--ethtool ETHTOOL]
1971    [--gateway GATEWAY] [--hostname HOSTNAME] [--ip IP] [--mtu MTU]
1972    [--nameserver NAMESERVER] [--netmask NETMASK] [--nodns]
1973    [--onboot ONBOOT] [--wepkey WEPKEY] [--notksdevice] [--noipv4]
1974    [--noipv6] [--ipv6 IPV6] [--activate] [--nodefroute] [--wpakey WPAKEY]
1975    [--bondslaves BONDSLAVES] [--bondopts BONDOPTS] [--vlanid VLANID]
1976    [--ipv6gateway IPV6GATEWAY] [--teamslaves TEAMSLAVES]
1977    [--teamconfig TEAMCONFIG] [--interfacename INTERFACENAME]
1978    [--bridgeslaves BRIDGESLAVES] [--bridgeopts BRIDGEOPTS]
1979    [--no-activate] [--bindto {mac}]
1980
1981New in version Fedora3.
1982
1983Configures network information for target system and activates network devices in installer environment. The device specified in the first network command is activated automatically. Activation of the device can be also explicitly required by --activate option
1984
1985optional arguments:
1986
1987--bootproto {dhcp,bootp,static,query,ibft}
1988
1989    The method of IPv4 configuration. For IPv6 configuration use --ipv6 option.
1990
1991    The default setting is dhcp. To turn IPv4 configuration off use --noipv4 option.
1992
1993        The dhcp method uses a DHCP server system to
1994
1995    obtain its networking configuration.
1996
1997        The static method requires that you specify at
1998
1999    least IP address and netmask with --ip and --netmask options. For example:
2000
2001    ``network --device=link --bootproto=static --ip=10.0.2.15 --netmask=255.255.255.0 --gateway=10.0.2.254 --nameserver=10.0.2.1``
2002
2003        ibft setting is for reading the configuration
2004
2005    from iBFT table.
2006
2007    New in version Fedora3.
2008
2009    Changed in version Fedora9.
2010
2011    The ‘query’ value was added.
2012
2013    Changed in version Fedora16.
2014
2015    The ‘ibft’ value was added.
2016
2017--dhcpclass DHCPCLASS
2018
2019    Specifies the DHCP vendor class identifier. The dhcpd service will see this value as vendor-class-identifier.
2020
2021    New in version Fedora3.
2022
2023--device DEVICE
2024
2025    Specifies the device to be configured (and eventually activated in Anaconda) with the network command.
2026
2027    You can specify a device to be activated in any of the following ways: - the device name of the interface, for example, em1 - the MAC address of the interface, for example, 01:23:45:67:89:ab - the keyword link, which specifies the first interface with its link in the up state - the keyword bootif, which uses the MAC address that pxelinux set in the BOOTIF variable. Set IPAPPEND 2 in your pxelinux.cfg file to have pxelinux set the BOOTIF variable.
2028
2029    For example:
2030
2031    ``network --bootproto=dhcp --device=ens3``
2032
2033    If the --device= option is missing on the first use of the network command, the value of the ksdevice= Anaconda boot option is used, if available. If ksdevice= is not set, link value is used. Note that this is considered deprecated behavior; in most cases, you should always specify a --device= for every network command. The behavior of any subsequent network command in the same Kickstart file is unspecified if its --device= option is missing. Make sure you specify this option for any network command beyond the first.
2034
2035    New in version Fedora3.
2036
2037--essid ESSID
2038
2039    The network ID for wireless networks.
2040
2041    New in version Fedora3.
2042
2043--ethtool ETHTOOL
2044
2045    Specifies additional low-level settings for the network device which will be passed to the ethtool program.
2046
2047    New in version Fedora3.
2048
2049--gateway GATEWAY
2050
2051    Default gateway, as a single IPv4 address.
2052
2053    New in version Fedora3.
2054
2055--hostname HOSTNAME
2056
2057    The host name for the installed system.
2058
2059    The host name can either be a fully-qualified domain name (FQDN) in the format hostname.domainname, or a short host name with no domain. Many networks have a DHCP service which automatically supplies connected systems with a domain name; to allow DHCP to assign the domain name, only specify a short host name.
2060
2061    New in version Fedora3.
2062
2063--ip IP
2064
2065    IPv4 address for the interface.
2066
2067    New in version Fedora3.
2068
2069--mtu MTU
2070
2071    The MTU of the device.
2072
2073    New in version Fedora3.
2074
2075--nameserver NAMESERVER
2076
2077    Primary nameserver, as an IP address. Multiple nameservers must be comma separated.
2078
2079    New in version Fedora3.
2080
2081--netmask NETMASK
2082
2083    IPv4 network mask of the device.
2084
2085    New in version Fedora3.
2086
2087--nodns
2088
2089    Do not configure any DNS server.
2090
2091    New in version Fedora3.
2092
2093--onboot ONBOOT
2094
2095    Whether or not to enable the device a boot time.
2096
2097    New in version Fedora3.
2098
2099--wepkey WEPKEY
2100
2101    The WEP encryption key for wireless networks.
2102
2103    New in version Fedora3.
2104
2105--notksdevice
2106
2107    This network device is not used for kickstart.
2108
2109    New in version Fedora4.
2110
2111--noipv4
2112
2113    Disable IPv4 configuration of this device.
2114
2115    New in version Fedora6.
2116
2117--noipv6
2118
2119    Disable IPv6 configuration of this device.
2120
2121    New in version Fedora6.
2122
2123--ipv6 IPV6
2124
2125    IPv6 address for the interface. This can be: - the static address in form <IPv6 address>[/<prefix length>], e.g. 3ffe:ffff:0:1::1/128 (if prefix is omitted 64 is assumed), - auto for stateless automatic address autoconfiguration, or - dhcp for DHCPv6-only configuration (no router advertisements).
2126
2127    New in version Fedora8.
2128
2129--activate
2130
2131    As noted above, using this option ensures any matching devices beyond the first will also be activated.
2132
2133    New in version Fedora16.
2134
2135--nodefroute
2136
2137    Prevents grabbing of the default route by the device. It can be useful when activating additional devices in installer using --activate option.
2138
2139    New in version Fedora16.
2140
2141--wpakey WPAKEY
2142
2143    The WPA encryption key for wireless networks.
2144
2145    New in version Fedora16.
2146
2147--bondslaves BONDSLAVES
2148
2149    Bonded device with name specified by --device option will be created using slaves specified in this option. Example:
2150
2151    ``network --device bond0 --bootproto static --ip=10.34.102.222 --netmask=255.255.255.0 --gateway=10.34.102.254 --nameserver=10.34.39.2 --bondslaves=ens7,ens8 --bondopts=mode=active-backup,primary=ens7 --activate``
2152
2153    New in version Fedora19.
2154
2155--bondopts BONDOPTS
2156
2157    A comma-separated list of optional parameters for bonded interface specified by --bondslaves and --device options. Example:
2158
2159    ``--bondopts=mode=active-backup,primary=eth1``
2160
2161    If an option itself contains comma as separator use semicolon to separate the options. Example:
2162
2163    ``--bondopts=mode=active-backup,balance-rr;primary=eth1``
2164
2165    New in version Fedora19.
2166
2167--vlanid VLANID
2168
2169    Id (802.1q tag) of vlan device to be created using parent device specified by --device option. For example:
2170
2171    ``network --device=eth0 --vlanid=171``
2172
2173    will create vlan device eth0.171.
2174
2175    New in version Fedora19.
2176
2177--ipv6gateway IPV6GATEWAY
2178
2179    Default gateway, as a single IPv6 address.
2180
2181    New in version Fedora19.
2182
2183--teamslaves TEAMSLAVES
2184
2185    Team device with name specified by --device option will be created using slaves specified in this option. Slaves are separated by comma. A slave can be followed by its configuration which is a single-quoted json format string with double qoutes escaped by '' character. Example:
2186
2187    ``--teamslaves="p3p1'{"prio": -10, "sticky": true}',p3p2'{"prio": 100}'"``.
2188
2189    See also --teamconfig option.
2190
2191    New in version Fedora20.
2192
2193--teamconfig TEAMCONFIG
2194
2195    Double-quoted team device configuration which is a json format string with double quotes escaped with '' character. The device name is specified by --device option and its slaves and their configuration by --teamslaves option. Example:
2196
2197    ``network --device team0 --activate --bootproto static --ip=10.34.102.222 --netmask=255.255.255.0 --gateway=10.34.102.254 --nameserver=10.34.39.2 --teamslaves="p3p1'{"prio": -10, "sticky": true}',p3p2'{"prio": 100}'" --teamconfig="{"runner": {"name": "activebackup"}}"``
2198
2199    New in version Fedora20.
2200
2201--interfacename INTERFACENAME
2202
2203    Specify a custom interface name for a virtual LAN device. This option should be used when the default name generated by the --vlanid= option is not desirable. This option must be used along with --vlanid=. For example:
2204
2205    ``network --device=em1 --vlanid=171 --interfacename=vlan171``
2206
2207    The above command creates a virtual LAN interface named vlan171 on the em1 device with an ID of 171. The interface name can be arbitrary (for example, my-vlan), but in specific cases, the following conventions must be followed:
2208
2209    If the name contains a dot (.), it must take the form of NAME.ID. The NAME is arbitrary, but the ID must be the VLAN ID. For example: em1.171 or my-vlan.171. Names starting with vlan must take the form of vlanID - for example: vlan171.
2210
2211    New in version Fedora21.
2212
2213--bridgeslaves BRIDGESLAVES
2214
2215    When this option is used, the network bridge with device name specified using the --device= option will be created and devices defined in the --bridgeslaves= option will be added to the bridge. For example:
2216
2217    ``network --device=bridge0 --bridgeslaves=em1``
2218
2219    New in version Fedora22.
2220
2221--bridgeopts BRIDGEOPTS
2222
2223    An optional comma-separated list of parameters for the bridged interface. Available values are stp, priority, forward-delay, hello-time, max-age, and ageing-time. For information about these parameters, see the bridge setting table in the nm-settings(5) man page or at https://developer.gnome.org/NetworkManager/0.9/ref-settings.html.
2224
2225    New in version Fedora22.
2226
2227--no-activate
2228
2229    Use this option with first network command to prevent activation of the device in istaller environment
2230
2231    New in version Fedora25.
2232
2233--bindto {mac}
2234
2235    Optionally allows to specify how the connection configuration created for the device should be bound. If the option is not used, the connection binds to interface name (DEVICE value in ifcfg file). For virtual devices (bond, team, bridge) it configures binding of slaves. Not applicable to vlan devices.
2236
2237    Note that this option is independent of how the --device is specified.
2238
2239    Currently only the value mac is suported. --bindto=mac will bind the connection to MAC address of the device (HWADDR value in ifcfg file).
2240
2241    For example:
2242
2243    ``network --device=01:23:45:67:89:ab --bootproto=dhcp --bindto=mac``
2244
2245    will bind the configuration of the device specified by MAC address 01:23:45:67:89:ab to its MAC address.
2246
2247    network --device=01:23:45:67:89:ab --bootproto=dhcp
2248
2249    will bind the configuration of the device specified by MAC address 01:23:45:67:89:ab to its interface name (eg ens3).
2250
2251    network --device=ens3 --bootproto=dhcp --bindto=mac
2252
2253    will bind the configuration of the device specified by interface name ens3 to its MAC address.
2254
2255    New in version Fedora27.
2256
2257nfs
2258
2259nfs --server <hostname> --dir <directory> [--opts <options>]
2260
2261New in version Fedora3.
2262
2263Install from the NFS server specified. This can either be an exploded installation tree or a directory of ISO images. In the latter case, the install.img must also be provided subject to the same rules as with the harddrive installation method described above.
2264
2265optional arguments:
2266
2267--server <hostname>
2268
2269    Server from which to install (hostname or IP).
2270
2271    New in version Fedora3.
2272
2273--dir <directory>
2274
2275    Directory containing the Packages/ directory of the installation tree. If doing an ISO install, this directory must also contain images/install.img.
2276
2277    New in version Fedora3.
2278
2279--opts <options>
2280
2281    Mount options to use for mounting the NFS export. Any options that can be specified in /etc/fstab for an NFS mount are allowed. The options are listed in the nfs(5) man page. Multiple options are separated with a comma.
2282
2283    New in version Fedora6.
2284
2285nvdimm
2286
2287nvdimm [--namespace <namespace>]
2288   [--blockdevs <devspec1>,<devspec2>,...,<devspecN>] [--mode {sector}]
2289   [--sectorsize SECTORSIZE]
2290   {reconfigure,use}
2291
2292New in version Fedora28.
2293
2294Perform an action on an nvdimm device.
2295
2296positional arguments:
2297
2298{reconfigure,use}
2299
2300    The action to be performed on the device specified by further options. The device can be specified by --namespace or --blockdevs options, depending on the action.
2301
2302    Valid actions: - reconfigure: Reconfigures the device specified by --namespace into the mode specified by --mode and (depending on the mode) --sectorsize options. The device reconfigured into sector mode will be allowed to be used for storage configuration. - use: Allow the device to be used for storage configuration. By default nvdimm devices are ignored. Only devices in sector mode can be used.
2303
2304    New in version Fedora28.
2305
2306optional arguments:
2307
2308--namespace <namespace>
2309
2310    The device specification by namespace.
2311
2312    New in version Fedora28.
2313
2314--blockdevs <devspec1>,<devspec2>,...,<devspecN>
2315
2316    Specification of devices by comma separated list of block device names.
2317
2318    New in version Fedora28.
2319
2320--mode {sector}
2321
2322    The mode specification.
2323
2324    New in version Fedora28.
2325
2326--sectorsize SECTORSIZE
2327
2328    Size of a sector for sector mode.
2329
2330    New in version Fedora28.
2331
2332ostreesetup
2333
2334ostreesetup --osname OSNAME [--remote REMOTE] --url URL --ref REF [--nogpg]
2335
2336New in version Fedora21.
2337
2338Used for OSTree installations. See https://wiki.gnome.org/action/show/Projects/OSTree for more information about OSTree.
2339
2340optional arguments:
2341
2342--osname OSNAME
2343
2344    Management root for OS installation.
2345
2346    New in version Fedora21.
2347
2348--remote REMOTE
2349
2350    Management root for OS installation.
2351
2352    New in version Fedora21.
2353
2354--url URL
2355
2356    Repository URL.
2357
2358    New in version Fedora21.
2359
2360--ref REF
2361
2362    Name of branch inside the repository.
2363
2364    New in version Fedora21.
2365
2366--nogpg
2367
2368    Disable GPG key verification.
2369
2370    New in version Fedora21.
2371
2372part or partition
2373
2374part|partition [--asprimary] [--fstype FSTYPE] [--grow] [--maxsize MAXSIZEMB]
2375           [--noformat] [--onbiosdisk ONBIOSDISK] [--ondisk DISK]
2376           [--onpart ONPART] [--recommended] [--size SIZE]
2377           [--fsoptions FSOPTS] [--label LABEL] [--fsprofile FSPROFILE]
2378           [--encrypted] [--passphrase PASSPHRASE] [--escrowcert <url>]
2379           [--backuppassphrase] [--resize] [--hibernation]
2380           [--cipher CIPHER] [--mkfsoptions MKFSOPTS] [--active]
2381           [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
2382           [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
2383           [--pbkdf-iterations PBKDF_ITERATIONS]
2384           <mntpoint>
2385
2386New in version Fedora3.
2387
2388Creates a partition on the system. This command is required. All partitions created will be formatted as part of the installation process unless --noformat and --onpart are used.
2389
2390positional arguments:
2391
2392<mntpoint>
2393
2394    The <mntpoint> is where the partition will be mounted and must be of one of the following forms:
2395
2396    /<path>
2397
2398    For example, /, /usr, /home
2399
2400    swap
2401
2402    The partition will be used as swap space.
2403
2404    raid.<id>
2405
2406    The partition will be used for software RAID. Refer to the raid command.
2407
2408    pv.<id>
2409
2410    The partition will be used for LVM. Refer to the logvol command.
2411
2412    btrfs.<id>
2413
2414    The partition will be used for BTRFS volume. Rerefer to the btrfs command.
2415
2416    biosboot
2417
2418    The partition will be used for a BIOS Boot Partition. As of Fedora 16 there must be a biosboot partition for the bootloader to be successfully installed onto a disk that contains a GPT/GUID partition table. Rerefer to the bootloader command.
2419
2420    New in version Fedora3.
2421
2422optional arguments:
2423
2424--asprimary
2425
2426    Forces automatic allocation of the partition as a primary partition or the partitioning will fail.
2427
2428    TIP: The --asprimary option only makes sense with the MBR partitioning scheme and is ignored when the GPT partitioning scheme is used.
2429
2430    New in version Fedora3.
2431
2432--fstype FSTYPE, --type FSTYPE
2433
2434    Sets the file system type for the partition. Valid values include ext4, ext3, ext2, xfs, btrfs, swap, and vfat. Other filesystems may be valid depending on command line arguments passed to anaconda to enable other filesystems.
2435
2436    New in version Fedora3.
2437
2438--grow
2439
2440    Tells the partition to grow to fill available space (if any), or up to the maximum size setting. Note that --grow is not supported for partitions containing a RAID volume on top of them.
2441
2442    New in version Fedora3.
2443
2444--maxsize MAXSIZEMB
2445
2446    The maximum size in MiB the partition may grow to. Specify an integer value here, and do not append any units. This option is only relevant if --grow is specified as well.
2447
2448    New in version Fedora3.
2449
2450--noformat
2451
2452    Tells the installation program not to format the partition, for use with the --onpart command.
2453
2454    New in version Fedora3.
2455
2456--onbiosdisk ONBIOSDISK
2457
2458    Forces the partition to be created on a particular disk as discovered by the BIOS.
2459
2460    New in version Fedora3.
2461
2462--ondisk DISK, --ondrive DISK
2463
2464    Forces the partition to be created on a particular disk.
2465
2466    New in version Fedora3.
2467
2468--onpart ONPART, --usepart ONPART
2469
2470    Put the partition on an already existing device. Use --onpart=LABEL=name or --onpart=UUID=name to specify a partition by label or uuid respectively.
2471
2472    Anaconda may create partitions in any particular order, so it is safer to use labels than absolute partition names.
2473
2474    New in version Fedora3.
2475
2476--recommended
2477
2478    Determine the size of the partition automatically.
2479
2480    New in version Fedora3.
2481
2482--size SIZE
2483
2484    The minimum partition size in MiB. Specify an integer value here and do not append any units.
2485
2486    New in version Fedora3.
2487
2488--fsoptions FSOPTS
2489
2490    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
2491
2492    New in version Fedora4.
2493
2494--label LABEL
2495
2496    Specify the label to give to the filesystem to be made on the partition. If the given label is already in use by another filesystem, a new label will be created for this partition.
2497
2498    New in version Fedora4.
2499
2500--bytes-per-inode BYTES_PER_INODE
2501
2502    Specify the bytes/inode ratio.
2503
2504    New in version Fedora4.
2505
2506    Deprecated since version Fedora9.
2507
2508    Removed in version Fedora14.
2509
2510--fsprofile FSPROFILE
2511
2512    Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2/3/4, this configuration file is /etc/mke2fs.conf.
2513
2514    New in version Fedora9.
2515
2516--encrypted
2517
2518    Specify that this partition should be encrypted.
2519
2520    New in version Fedora9.
2521
2522--passphrase PASSPHRASE
2523
2524    Specify the passphrase to use when encrypting this partition. Without the above –encrypted option, this option does nothing. If no passphrase is specified, the default system-wide one is used, or the installer will stop and prompt if there is no default.
2525
2526    New in version Fedora9.
2527
2528--start START
2529
2530    New in version Fedora3.
2531
2532    Deprecated since version Fedora11.
2533
2534    Removed in version Fedora14.
2535
2536--end END
2537
2538    New in version Fedora3.
2539
2540    Deprecated since version Fedora11.
2541
2542    Removed in version Fedora14.
2543
2544--escrowcert <url>
2545
2546    Load an X.509 certificate from <url>. Store the data encryption key of this partition, encrypted using the certificate, as a file in /root. Only relevant if --encrypted is specified as well.
2547
2548    New in version Fedora12.
2549
2550--backuppassphrase
2551
2552    Only relevant if --escrowcert is specified as well. In addition to storing the data encryption key, generate a random passphrase and add it to this partition. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as a file in /root. If more than one LUKS volume uses --backuppassphrase, the same passphrase will be used for all such volumes.
2553
2554    New in version Fedora12.
2555
2556--resize
2557
2558    Attempt to resize this partition to the size given by --size=. This option must be used with --onpart --size=, or an error will be raised.
2559
2560    New in version Fedora17.
2561
2562--hibernation
2563
2564    This option can be used to automatically determine the size of the swap partition big enough for hibernation.
2565
2566    New in version Fedora18.
2567
2568--cipher CIPHER
2569
2570    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
2571
2572    New in version Fedora18.
2573
2574--mkfsoptions MKFSOPTS
2575
2576    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. This is similar to --fsprofile but works for all filesystems, not just the ones that support the profile concept. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
2577
2578    New in version Fedora23.
2579
2580--active
2581
2582    New in version Fedora3.
2583
2584    Deprecated since version Fedora29.
2585
2586--luks-version LUKS_VERSION
2587
2588    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
2589
2590    New in version Fedora29.
2591
2592--pbkdf PBKDF
2593
2594    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
2595
2596    New in version Fedora29.
2597
2598--pbkdf-memory PBKDF_MEMORY
2599
2600    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
2601
2602    New in version Fedora29.
2603
2604--pbkdf-time PBKDF_TIME
2605
2606    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
2607
2608    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
2609
2610    New in version Fedora29.
2611
2612--pbkdf-iterations PBKDF_ITERATIONS
2613
2614    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
2615
2616    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
2617
2618    New in version Fedora29.
2619
2620If partitioning fails for any reason, diagnostic messages will appear on virtual console 3.
2621raid
2622
2623raid --device DEVICE [--fstype FSTYPE] [--level LEVEL] [--noformat]
2624 [--spares SPARES] [--useexisting] [--fsoptions FSOPTS]
2625 [--fsprofile FSPROFILE] [--encrypted] [--passphrase PASSPHRASE]
2626 [--escrowcert <url>] [--backuppassphrase] [--label LABEL]
2627 [--cipher CIPHER] [--mkfsoptions MKFSOPTS] [--chunksize CHUNK_SIZE]
2628 [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
2629 [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
2630 [--pbkdf-iterations PBKDF_ITERATIONS]
2631 <mntpoint> [<partitions*> [<partitions*> ...]]
2632
2633New in version Fedora3.
2634
2635Assembles a software RAID device.
2636
2637positional arguments:
2638
2639<mntpoint>
2640
2641    Location where the RAID file system is mounted. If it is /, the RAID level must be 1 unless a boot partition (/boot) is present. If a boot partition is present, the /boot partition must be level 1 and the root (/) partition can be any of the available types.
2642
2643    New in version Fedora3.
2644
2645<partitions*>
2646
2647    The software raid partitions lists the RAID identifiers to add to the RAID array.
2648
2649    New in version Fedora3.
2650
2651optional arguments:
2652
2653--device DEVICE
2654
2655    Name of the RAID device to use (such as ‘fedora-root’ or ‘home’). As of Fedora 19, RAID devices are no longer referred to by names like ‘md0’. If you have an old (v0.90 metadata) array that you cannot assign a name to, you can specify the array by a filesystem label or UUID (eg: –device=LABEL=fedora-root).
2656
2657    New in version Fedora3.
2658
2659--fstype FSTYPE
2660
2661    Sets the file system type for the RAID array. Valid values include ext4, ext3, ext2, btrfs, swap, and vfat. Other filesystems may be valid depending on command line arguments passed to anaconda to enable other filesystems.
2662
2663    New in version Fedora3.
2664
2665--level LEVEL
2666
2667    RAID level to use {‘RAID0’, ‘RAID1’, ‘RAID10’, ‘RAID4’, ‘RAID5’, ‘RAID6’}.
2668
2669    New in version Fedora3.
2670
2671    Changed in version Fedora7.
2672
2673    The “RAID10” level was added.
2674
2675    Changed in version Fedora13.
2676
2677    The “RAID4” level was added.
2678
2679--noformat
2680
2681    Use an existing RAID device and do not format the RAID array.
2682
2683    New in version Fedora3.
2684
2685--spares SPARES
2686
2687    Specifies the number of spare drives allocated for the RAID array. Spare drives are used to rebuild the array in case of drive failure.
2688
2689    New in version Fedora3.
2690
2691--useexisting
2692
2693    Use an existing RAID device and reformat it.
2694
2695    New in version Fedora3.
2696
2697--fsoptions FSOPTS
2698
2699    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
2700
2701    New in version Fedora4.
2702
2703--bytes-per-inode BYTES_PER_INODE
2704
2705    Specify the bytes/inode ratio.
2706
2707    New in version Fedora5.
2708
2709    Deprecated since version Fedora9.
2710
2711    Removed in version Fedora14.
2712
2713--fsprofile FSPROFILE
2714
2715    Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2/3/4, this configuration file is /etc/mke2fs.conf.
2716
2717    New in version Fedora9.
2718
2719--encrypted
2720
2721    Specify that this RAID device should be encrypted.
2722
2723    New in version Fedora9.
2724
2725--passphrase PASSPHRASE
2726
2727    Specify the passphrase to use when encrypting this RAID device. Without the above –encrypted option, this option does nothing. If no passphrase is specified, the default system-wide one is used, or the installer will stop and prompt if there is no default.
2728
2729    New in version Fedora9.
2730
2731--escrowcert <url>
2732
2733    Load an X.509 certificate from <url>. Store the data encryption key of this partition, encrypted using the certificate, as a file in /root. Only relevant if --encrypted is specified as well.
2734
2735    New in version Fedora12.
2736
2737--backuppassphrase
2738
2739    Only relevant if --escrowcert is specified as well. In addition to storing the data encryption key, generate a random passphrase and add it to this partition. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as a file in /root. If more than one LUKS volume uses --backuppassphrase, the same passphrase will be used for all such volumes.
2740
2741    New in version Fedora12.
2742
2743--label LABEL
2744
2745    Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created.
2746
2747    New in version Fedora15.
2748
2749--cipher CIPHER
2750
2751    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
2752
2753    New in version Fedora18.
2754
2755--mkfsoptions MKFSOPTS
2756
2757    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
2758
2759    New in version Fedora23.
2760
2761--chunksize CHUNK_SIZE
2762
2763    Specify the chunk size (in KiB) for this RAID array.
2764
2765    New in version Fedora25.
2766
2767--luks-version LUKS_VERSION
2768
2769    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
2770
2771    New in version Fedora29.
2772
2773--pbkdf PBKDF
2774
2775    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
2776
2777    New in version Fedora29.
2778
2779--pbkdf-memory PBKDF_MEMORY
2780
2781    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
2782
2783    New in version Fedora29.
2784
2785--pbkdf-time PBKDF_TIME
2786
2787    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
2788
2789    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
2790
2791    New in version Fedora29.
2792
2793--pbkdf-iterations PBKDF_ITERATIONS
2794
2795    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
2796
2797    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
2798
2799    New in version Fedora29.
2800
2801The following example shows how to create a RAID level 1 partition for /, and a RAID level 5 for /usr, assuming there are three disks on the system. It also creates three swap partitions, one on each drive:
2802
2803part raid.01 --size=6000 --ondisk=sda
2804part raid.02 --size=6000 --ondisk=sdb
2805part raid.03 --size=6000 --ondisk=sdc
2806
2807part swap1 --size=512 --ondisk=sda
2808part swap2 --size=512 --ondisk=sdb
2809part swap3 --size=512 --ondisk=sdc
2810
2811part raid.11 --size=6000 --ondisk=sda
2812part raid.12 --size=6000 --ondisk=sdb
2813part raid.13 --size=6000 --ondisk=sdc
2814
2815raid / --level=1 --device=md0 raid.01 raid.02 raid.03
2816raid /usr --level=5 --device=md1 raid.11 raid.12 raid.13
2817
2818realm
2819
2820realm
2821
2822New in version Fedora19.
2823repo
2824
2825repo --name NAME [--baseurl BASEURL] [--mirrorlist MIRRORLIST] [--cost COST]
2826 [--excludepkgs EXCLUDEPKGS] [--includepkgs INCLUDEPKGS]
2827 [--ignoregroups IGNOREGROUPS] [--proxy PROXY] [--noverifyssl] [--install]
2828 [--metalink METALINK]
2829
2830New in version Fedora6.
2831
2832Configures additional yum repositories that may be used as sources for package installation. Multiple repo lines may be specified. By default, anaconda has a configured set of repos taken from /etc/anaconda.repos.d plus a special Installation Repo in the case of a media install. The exact set of repos in this directory changes from release to release and cannot be listed here. There will likely always be a repo named “updates”.
2833
2834Note: If you want to enable one of the repos in /etc/anaconda.repos.d that is disabled by default (like “updates”), you should use –name= but none of the other options. anaconda will look for a repo by this name automatically. Providing a baseurl or mirrorlist URL will result in anaconda attempting to add another repo by the same name, which will cause a conflicting repo error.
2835
2836optional arguments:
2837
2838--name NAME
2839
2840    The repo id. This option is required. The RepoId must not contain spaces (do not confuse with the optional name used by yum). If a repo has a name that conflicts with a previously added one, the new repo will be ignored. Because anaconda has a populated list of repos when it starts, this means that users cannot create new repos that override these names. Please check /etc/anaconda.repos.d from the operating system you wish to install to see what names are not available.
2841
2842    New in version Fedora6.
2843
2844--baseurl BASEURL
2845
2846    The URL for the repository. The variables that may be used in yum repo config files are not supported here. You may use one of either this option or --mirrorlist, not both. If an NFS repository is specified, it should be of the form nfs://host:/path/to/repo. Note that there is a colon after the host. Anaconda passes everything after “nfs:// ” directly to the mount command instead of parsing URLs according to RFC 2224. Variable substitution is done for $releasever and $basearch in the url.
2847
2848    New in version Fedora6.
2849
2850    Changed in version Fedora15.
2851
2852    --mirrorlist and --baseurl are not required anymore!
2853
2854    Changed in version Fedora27.
2855
2856    Another mutually exclusive option --metalink was added.
2857
2858--mirrorlist MIRRORLIST
2859
2860    The URL pointing at a list of mirrors for the repository. The variables that may be used in yum repo config files are not supported here. You may use one of either this option or --baseurl, not both. Variable substitution is done for $releasever and $basearch in the url.
2861
2862    New in version Fedora6.
2863
2864    Changed in version Fedora15.
2865
2866    --mirrorlist and --baseurl are not required anymore!
2867
2868    Changed in version Fedora27.
2869
2870    Another mutually exclusive option --metalink was added.
2871
2872--cost COST
2873
2874    An integer value to assign a cost to this repository. If multiple repositories provide the same packages, this number will be used to prioritize which repository will be used before another. Repositories with a lower cost take priority over repositories with higher cost.
2875
2876    New in version Fedora8.
2877
2878--excludepkgs EXCLUDEPKGS
2879
2880    A comma-separated list of package names and globs that must not be pulled from this repository. This is useful if multiple repositories provide the same package and you want to make sure it comes from a particular repository.
2881
2882    New in version Fedora8.
2883
2884--includepkgs INCLUDEPKGS
2885
2886    A comma-separated list of package names and globs that must be pulled from this repository. This is useful if multiple repositories provide the same package and you want to make sure it comes from this repository.
2887
2888    New in version Fedora8.
2889
2890--ignoregroups IGNOREGROUPS
2891
2892    This option is used when composing installation trees and has no effect on the installation process itself. It tells the compose tools to not look at the package group information when mirroring trees so as to avoid mirroring large amounts of unnecessary data.
2893
2894    New in version Fedora11.
2895
2896--proxy PROXY
2897
2898    Specify an HTTP/HTTPS/FTP proxy to use just for this repository. This setting does not affect any other repositories, nor how the install.img is fetched on HTTP installs. The various parts of the argument act like you would expect. The syntax is:
2899
2900    ``--proxy=[protocol://][username[:password]@]host[:port]``
2901
2902    New in version Fedora13.
2903
2904--noverifyssl
2905
2906    For a https repo do not check the server’s certificate with what well-known CA validate and do not check the server’s hostname matches the certificate’s domain name.
2907
2908    New in version Fedora14.
2909
2910--install
2911
2912    Install this repository to the target system so that it can be used after reboot.
2913
2914    New in version Fedora21.
2915
2916--metalink METALINK
2917
2918    The URL pointing at a metalink for the repository. The variables that may be used in yum repo config files are not supported here. You may use only one of the --baseurl, --mirrorlist, or --metalink options. Variable substitution is done for $releasever and $basearch in the url.
2919
2920    New in version Fedora27.
2921
2922reqpart
2923
2924reqpart [--add-boot]
2925
2926New in version Fedora23.
2927
2928Automatically create partitions required by your hardware platform. These include a /boot/efi for x86_64 and Aarch64 systems with UEFI firmware, biosboot for x86_64 systems with BIOS firmware and GPT, and PRePBoot for IBM Power Systems.
2929
2930Note: This command can not be used together with autopart, because autopart does the same and creates other partitions or logical volumes such as / and swap on top. In contrast with autopart, this command only creates platform-specific partitions and leaves the rest of the drive empty, allowing you to create a custom layout.
2931
2932optional arguments:
2933
2934--add-boot
2935
2936    Create a separate /boot partition in addition to the platform-specific partition created by the base command.
2937
2938    New in version Fedora23.
2939
2940rescue
2941
2942rescue [--nomount] [--romount]
2943
2944New in version Fedora10.
2945
2946Automatically enter the installer’s rescue mode. This gives you a chance to repair the system should something catastrophic happen.
2947
2948optional arguments:
2949
2950--nomount
2951
2952    Don’t mount the installed system.
2953
2954    New in version Fedora10.
2955
2956--romount
2957
2958    Mount the installed system in read-only mode.
2959
2960    New in version Fedora10.
2961
2962By default, the installer will find your system and mount it in read-write mode, telling you where it has performed this mount. You may optionally choose to not mount anything or mount in read-only mode. Only one of these two options may be given at any one time.
2963rootpw
2964
2965rootpw [--iscrypted] [--lock] [--plaintext] [<password>]
2966
2967New in version Fedora3.
2968
2969This required command sets the system’s root password.
2970
2971positional arguments:
2972
2973<password>
2974
2975    The desired root password.
2976
2977    New in version Fedora3.
2978
2979optional arguments:
2980
2981--iscrypted
2982
2983    If this is present, the password argument is assumed to already be encrypted. To create an encrypted password you can use python:
2984
2985    ``python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Salt"))'``
2986
2987    This will generate sha512 crypt of your password using your provided salt.
2988
2989    New in version Fedora3.
2990
2991--lock
2992
2993    If this is present, the root account is locked by default. That is, the root user will not be able to login from the console. When this option is present the <password> argument is not required.
2994
2995    New in version Fedora8.
2996
2997--plaintext
2998
2999    The password argument is assumed to not be encrypted. This is the default!
3000
3001    New in version Fedora8.
3002
3003selinux
3004
3005selinux [--disabled] [--enforcing] [--permissive]
3006
3007New in version Fedora3.
3008
3009Sets the state of SELinux on the installed system. SELinux defaults to enforcing in anaconda.
3010
3011optional arguments:
3012
3013--disabled
3014
3015    If this is present, SELinux is disabled.
3016
3017    New in version Fedora3.
3018
3019--enforcing
3020
3021    If this is present, SELinux is set to enforcing mode.
3022
3023    New in version Fedora3.
3024
3025--permissive
3026
3027    If this is present, SELinux is enabled, but only logs things that would be denied in enforcing mode.
3028
3029    New in version Fedora3.
3030
3031Only one of --disabled, --enabled or --permissive must be specified!
3032services
3033
3034services [--disabled <list>] [--enabled <list>]
3035
3036New in version Fedora6.
3037
3038Modifies the default set of services that will run under the default runlevel. The services listed in the disabled list will be disabled before the services listed in the enabled list are enabled.
3039
3040optional arguments:
3041
3042--disabled <list>
3043
3044    Disable the services given in the comma separated list.
3045
3046    New in version Fedora6.
3047
3048--enabled <list>
3049
3050    Enable the services given in the comma separated list.
3051
3052    New in version Fedora6.
3053
3054One of --disabled or --enabled must be provided.
3055skipx
3056
3057skipx
3058
3059New in version Fedora3.
3060
3061If present, X is not configured on the installed system.
3062snapshot
3063
3064snapshot --name <snapshot_name> --when <pre-install|post-install>
3065
3066New in version Fedora26.
3067
3068Create an LVM snapshot for devices on an LVM thin pool.
3069
3070optional arguments:
3071
3072--name <snapshot_name>
3073
3074    Name of the newly created snapshot.
3075
3076    New in version Fedora26.
3077
3078--when <pre-install|post-install>
3079
3080    You can specify two possible values: pre-install and post-install. When the pre-install value is used the snapshot is created before the installation but after the %pre section is run. When the post-install value is used the snapshot is created after the installation is done and after the %post section is run.
3081
3082    New in version Fedora26.
3083
3084sshkey
3085
3086sshkey --username <user> "ssh key"
3087
3088New in version Fedora22.
3089
3090This installs a ssh key to the authorized_keys file of the specified user on the installed system.
3091
3092positional arguments:
3093
3094"ssh key"
3095
3096    The content of the ssh key to install.
3097
3098    New in version Fedora22.
3099
3100optional arguments:
3101
3102--username <user>
3103
3104    User for which to install the specified key.
3105
3106    New in version Fedora22.
3107
3108Note that the key should be quoted, if it contains spaces and the user should exist (or be root) either via creation by a package install or the kickstart user command.
3109sshpw
3110
3111sshpw --username <name> [--iscrypted] [--plaintext] [--lock] [--sshkey]
3112  [<password> [<password> ...]]
3113
3114New in version Fedora13.
3115
3116The installer can start up ssh to provide for interactivity and inspection, just like it can with telnet. The “inst.sshd” option must be specified on the kernel command-line for Anaconda to start an ssh daemon. The sshpw command is used to control the accounts created in the installation environment that may be remotely logged into. For each instance of this command given, a user will be created. These users will not be created on the final system - they only exist for use while the installer is running.
3117
3118Note that by default, root has a blank password. If you don’t want any user to be able to ssh in and have full access to your hardware, you must specify sshpw for username root. Also note that if Anaconda fails to parse the kickstart file, it will allow anyone to login as root and have full access to your hardware.
3119
3120positional arguments:
3121
3122<password>
3123
3124    The password string to use.
3125
3126    New in version Fedora13.
3127
3128optional arguments:
3129
3130--username <name>
3131
3132    Provides the name of the user. This option is required.
3133
3134    New in version Fedora13.
3135
3136--iscrypted
3137
3138    If this is present, the password argument is assumed to already be encrypted.
3139
3140    New in version Fedora13.
3141
3142--plaintext
3143
3144    If this is present, the password argument is assumed to not be encrypted. This is the default.
3145
3146    New in version Fedora13.
3147
3148--lock
3149
3150    If this is present, the new user account is locked by default. That is, the user will not be able to login from the console.
3151
3152    New in version Fedora13.
3153
3154--sshkey
3155
3156    If this is used then the <password> string is interpreted as an ssh key value.
3157
3158    New in version Fedora24.
3159
3160timezone
3161
3162timezone [--utc] [--nontp] [--ntpservers <server1>,<server2>,...,<serverN>]
3163     [<timezone> [<timezone> ...]]
3164
3165New in version Fedora3.
3166
3167This required command sets the system time zone to which may be any of the time zones listed by timeconfig.
3168
3169positional arguments:
3170
3171<timezone>
3172
3173    Timezone name, e.g. Europe/Sofia. This is optional but at least one of the options needs to be used if no timezone is specified.
3174
3175    New in version Fedora3.
3176
3177optional arguments:
3178
3179--utc, --isUtc
3180
3181    If present, the system assumes the hardware clock is set to UTC (Greenwich Mean) time.
3182
3183    To get the list of supported timezones, you can either run this script: http://vpodzime.fedorapeople.org/timezones_list.py or look at this list: http://vpodzime.fedorapeople.org/timezones_list.txt
3184
3185    New in version Fedora6.
3186
3187--nontp
3188
3189    Disable automatic starting of NTP service.
3190
3191    --nontp and --ntpservers are mutually exclusive.
3192
3193    New in version Fedora18.
3194
3195--ntpservers <server1>,<server2>,...,<serverN>
3196
3197    Specify a list of NTP servers to be used (comma-separated list with no spaces). The chrony package is automatically installed when this option is used. If you don’t want the package to be automatically installed then use -chrony in package selection. For example:
3198
3199    ``timezone --ntpservers=ntp.cesnet.cz,tik.nic.cz Europe/Prague``
3200
3201    New in version Fedora18.
3202
3203updates
3204
3205updates [[URL] [[URL] ...]]
3206
3207New in version Fedora7.
3208
3209Specify the location of an updates.img for use in installation. See anaconda-release-notes.txt for a description of how to make an updates.img.
3210
3211positional arguments:
3212
3213[URL]
3214
3215    If present, the URL for an updates image.
3216
3217    If not present, anaconda will attempt to load from a floppy disk.
3218
3219    New in version Fedora7.
3220
3221install or upgrade
3222
3223install|upgrade [--root-device ROOT_DEVICE]
3224
3225New in version Fedora3.
3226
3227Install a fresh system or upgrade an existing system. Install is the default mode. For installation, you must specify the type of installation from one of cdrom, harddrive, nfs, or url (for ftp or http installations). The install command and the installation method command must be on separate lines.
3228
3229Deprecated since version Fedora20.
3230
3231Starting with F18, upgrades are no longer supported in anaconda and should be done with FedUp, the Fedora update tool. Starting with F21, the DNF system-upgrade plugin is recommended instead. Therefore, the upgrade command essentially does nothing.
3232
3233optional arguments:
3234
3235--root-device ROOT_DEVICE
3236
3237    On a system with multiple installs, this option specifies which filesystem holds the installation to be upgraded. This can be specified by device name, UUID=, or LABEL= just like the harddrive command may be.
3238
3239    New in version Fedora11.
3240
3241url
3242
3243url [--proxy URL] [--noverifyssl] [--url URL] [--mirrorlist URL]
3244[--metalink URL]
3245
3246New in version Fedora3.
3247
3248Install from an installation tree on a remote server via FTP or HTTP.
3249
3250optional arguments:
3251
3252--proxy URL
3253
3254    Specify an HTTP/HTTPS/FTP proxy to use while performing the install. The various parts of the argument act like you would expect. The syntax is:
3255
3256    [protocol://][username[:password]@]host[:port]
3257
3258    New in version Fedora13.
3259
3260--noverifyssl
3261
3262    For a tree on a HTTPS server do not check the server’s certificate with what well-known CA validate and do not check the server’s hostname matches the certificate’s domain name.
3263
3264    New in version Fedora14.
3265
3266--url URL
3267
3268    The URL to install from. Variable substitution is done for $releasever and $basearch in the url.
3269
3270    New in version Fedora3.
3271
3272    Changed in version Fedora18.
3273
3274    This parameter is no longer required because you could use --mirrorlist instead.
3275
3276--mirrorlist URL
3277
3278    The mirror URL to install from. Variable substitution is done for $releasever and $basearch in the url.
3279
3280    New in version Fedora18.
3281
3282--metalink URL
3283
3284    The metalink URL to install from. Variable substitution is done for $releasever and $basearch in the url.
3285
3286    New in version Fedora27.
3287
3288user
3289
3290user [--homedir HOMEDIR] [--iscrypted] --name NAME [--password PASSWORD]
3291 [--shell SHELL] [--uid INT] [--lock] [--plaintext] [--gecos GECOS]
3292 [--gid INT] [--groups GROUPS]
3293
3294New in version Fedora6.
3295
3296Creates a new user on the system.
3297
3298optional arguments:
3299
3300--homedir HOMEDIR
3301
3302    The home directory for the user. If not provided, this defaults to /home/.
3303
3304    New in version Fedora6.
3305
3306--iscrypted
3307
3308    If specified, consider the password provided by --password already encrypted. This is the default.
3309
3310    New in version Fedora6.
3311
3312--name NAME
3313
3314    Provides the name of the user. This option is required.
3315
3316    New in version Fedora6.
3317
3318--password PASSWORD
3319
3320    The new user’s password. If not provided, the account will be locked by default. If this is present, the password argument is assumed to already be encrypted. --plaintext has the opposite effect - the password argument is assumed to not be encrypted. To create an encrypted password you can use python:
3321
3322    ``python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Sault"))'``
3323
3324    This will generate sha512 crypt of your password using your provided salt.
3325
3326    New in version Fedora6.
3327
3328--shell SHELL
3329
3330    The user’s login shell. If not provided, this defaults to the system default.
3331
3332    New in version Fedora6.
3333
3334--uid INT
3335
3336    The user’s UID. If not provided, this defaults to the next available non-system UID.
3337
3338    New in version Fedora6.
3339
3340--lock
3341
3342    If this is present, the new user account is locked by default. That is, the user will not be able to login from the console.
3343
3344    New in version Fedora8.
3345
3346--plaintext
3347
3348    If specified, consider the password provided by --password to be plain text.
3349
3350    New in version Fedora8.
3351
3352--gecos GECOS
3353
3354    Provides the GECOS information for the user. This is a string of various system-specific fields separated by a comma. It is frequently used to specify the user’s full name, office number, and the like. See man 5 passwd for more details.
3355
3356    New in version Fedora12.
3357
3358--gid INT
3359
3360    The GID of the user’s primary group. If not provided, this defaults to the next available non-system GID.
3361
3362    New in version Fedora19.
3363
3364--groups GROUPS
3365
3366    In addition to the default group, a comma separated list of group names the user should belong to. Any groups that do not already exist will be created. If the group already exists with a different GID, an error will be raised.
3367
3368    New in version Fedora6.
3369
3370    Changed in version Fedora24.
3371
3372    The group name can optionally be followed by a GID in parenthesis, for example, newgroup(5002).
3373
3374vnc
3375
3376vnc [--password PASSWORD] [--host HOST] [--port PORT]
3377
3378New in version Fedora3.
3379
3380Allows the graphical installation to be viewed remotely via VNC. This method is usually preferred over text mode, as there are some size and language limitations in text installs. With no options, this command will start a VNC server on the machine with no password and will print out the command that needs to be run to connect a remote machine.
3381
3382optional arguments:
3383
3384--password PASSWORD
3385
3386    Set a password which must be provided to connect to the VNC session. This is optional, but recommended.
3387
3388    New in version Fedora3.
3389
3390--connect host[:port]
3391
3392    Connect to a remote host instead of starting VNC server locally.
3393
3394    New in version Fedora3.
3395
3396    Changed in version Fedora6.
3397
3398    Added support for host[:port] syntax.
3399
3400    Removed in version Fedora9.
3401
3402--host HOST
3403
3404    Instead of starting a VNC server on the install machine, connect to the VNC viewer process listening on the given hostname.
3405
3406    New in version Fedora6.
3407
3408--port PORT
3409
3410    Provide a port that the remote VNC viewer process is listening on. If not provided, anaconda will use the VNC default.
3411
3412    New in version Fedora6.
3413
3414volgroup
3415
3416volgroup [--noformat] [--useexisting] [--reserved-space RESERVED_SPACE]
3417     [--reserved-percent RESERVED_PERCENT] [--pesize PESIZE]
3418     [<name> [<name> ...]] [<partitions*> [<partitions*> ...]]
3419
3420New in version Fedora3.
3421
3422Creates a Logical Volume Management (LVM) group.
3423
3424positional arguments:
3425
3426<name>
3427
3428    Name given to the volume group. The (which denotes that multiple partitions can be listed) lists the identifiers to add to the volume group.
3429
3430    New in version Fedora3.
3431
3432<partitions*>
3433
3434    Physical Volume partitions to be included in this Volume Group
3435
3436    New in version Fedora3.
3437
3438optional arguments:
3439
3440--noformat
3441
3442    Use an existing volume group. Do not specify partitions when using this option.
3443
3444    New in version Fedora3.
3445
3446--useexisting
3447
3448    Use an existing volume group. Do not specify partitions when using this option.
3449
3450    New in version Fedora3.
3451
3452--reserved-space RESERVED_SPACE
3453
3454    Specify an amount of space to leave unused in a volume group, in MiB. Do not append any units. This option is only used for new volume groups.
3455
3456    New in version Fedora16.
3457
3458--reserved-percent RESERVED_PERCENT
3459
3460    Specify a percentage of total volume group space to leave unused (new volume groups only).
3461
3462    New in version Fedora16.
3463
3464--pesize PESIZE
3465
3466    Set the size of the physical extents in KiB.
3467
3468    New in version Fedora3.
3469
3470    Changed in version Fedora21.
3471
3472    Set the size of the physical extents in KiB.
3473
3474Create the partition first, create the logical volume group, and then create the logical volume. For example:
3475
3476part pv.01 --size 3000
3477volgroup myvg pv.01
3478logvol / --vgname=myvg --size=2000 --name=rootvol
3479
3480xconfig
3481
3482xconfig [--defaultdesktop GNOME|KDE] [--startxonboot]
3483
3484New in version Fedora3.
3485
3486Configures the X Window System. If this option is not given, Anaconda will use X and attempt to automatically configure. Please try this before manually configuring your system.
3487
3488optional arguments:
3489
3490--defaultdesktop GNOME|KDE
3491
3492    Specify either GNOME or KDE to set the default desktop (assumes that GNOME Desktop Environment and/or KDE Desktop Environment has been installed through %packages).
3493
3494    New in version Fedora3.
3495
3496--server SERVER
3497
3498    New in version Fedora3.
3499
3500    Removed in version Fedora6.
3501
3502--startxonboot
3503
3504    Use a graphical login on the installed system.
3505
3506    New in version Fedora3.
3507
3508--card CARD
3509
3510    New in version Fedora3.
3511
3512    Deprecated since version Fedora6.
3513
3514    Removed in version Fedora9.
3515
3516--hsync HSYNC
3517
3518    New in version Fedora3.
3519
3520    Deprecated since version Fedora6.
3521
3522    Removed in version Fedora9.
3523
3524--monitor MONITOR
3525
3526    New in version Fedora3.
3527
3528    Deprecated since version Fedora6.
3529
3530    Removed in version Fedora9.
3531
3532--noprobe NOPROBE
3533
3534    New in version Fedora3.
3535
3536    Deprecated since version Fedora6.
3537
3538    Removed in version Fedora9.
3539
3540--vsync VSYNC
3541
3542    New in version Fedora3.
3543
3544    Deprecated since version Fedora6.
3545
3546    Removed in version Fedora9.
3547
3548--driver DRIVER
3549
3550    New in version Fedora6.
3551
3552    Deprecated since version Fedora10.
3553
3554    Removed in version Fedora14.
3555
3556--depth DEPTH
3557
3558    New in version Fedora3.
3559
3560    Deprecated since version Fedora10.
3561
3562    Removed in version Fedora14.
3563
3564--resolution RESOLUTION
3565
3566    New in version Fedora3.
3567
3568    Deprecated since version Fedora10.
3569
3570    Removed in version Fedora14.
3571
3572--videoram VIDEORAM
3573
3574    New in version Fedora3.
3575
3576    Deprecated since version Fedora10.
3577
3578    Removed in version Fedora14.
3579
3580zerombr
3581
3582zerombr
3583
3584New in version Fedora3.
3585
3586If zerombr is specified, any disks whose formatting is unrecognized are initialized. This will destroy all of the contents of disks with invalid partition tables or other formatting unrecognizable to the installer. It is useful so that the installation program does not ask if it should initialize the disk label if installing to a brand new hard drive.
3587zfcp
3588
3589zfcp --devnum DEVNUM --fcplun FCPLUN --wwpn WWPN
3590
3591New in version Fedora3.
3592
3593optional arguments:
3594
3595--devnum DEVNUM
3596
3597    New in version Fedora3.
3598
3599--fcplun FCPLUN
3600
3601    New in version Fedora3.
3602
3603--wwpn WWPN
3604
3605    New in version Fedora3.
3606
3607--scsiid SCSIID
3608
3609    New in version Fedora3.
3610
3611    Deprecated since version Fedora12.
3612
3613    Removed in version Fedora14.
3614
3615--scsilun SCSILUN
3616
3617    New in version Fedora3.
3618
3619    Deprecated since version Fedora12.
3620
3621    Removed in version Fedora14.
3622
3623%include
3624
3625Use the %include /path/to/file or %include <url> command to include the contents of another file in the kickstart file as though the contents were at the location of the %include command in the kickstart file.
3626
3627Note the semantics of most kickstart commands default to “last keyword wins”, which means that for example if you have a services --enable=foo,bar in one file, and %include that file and use services --enable=baz, only the baz service will be enabled.
3628
3629The Kickstart documentation usually notes which commands support multiple instances - this is mostly multi-line commands such as %packages and %post. Other exceptions include the user and group commands. Consult individual command documentation for semantics.
3630%ksappend
3631
3632The %ksappend url directive is very similar to %include in that it is used to include the contents of additional files as though they were at the location of the %ksappend directive. The difference is in when the two directives are processed. %ksappend is processed in an initial pass, before any other part of the kickstart file. Then, this expanded kickstart file is passed to the rest of anaconda where all %pre scripts are handled, and then finally the rest of the kickstart file is processed in order, which includes %include directives.
3633
3634Thus, %ksappend provides a way to include a file containing %pre scripts, while %include does not.
3635Chapter 3. Kickstart Commands in Red Hat Enterprise Linux
3636
3637The following commands can be placed in a kickstart file. If you prefer to use a graphical interface for creating your kickstart file, you can use the Kickstart Configurator application.
3638
3639Most commands take arguments. If an argument is followed equals mark (=), a value must be specified after it.
3640
3641In the example commands, options in ‘’‘[square brackets]’‘’ are optional arguments for the command.
3642
3643pykickstart processes arguments to commands just like the shell does:
3644
3645If a list of arguments can be passed in, the arguments must be separated by
3646commas and not include any extra spaces.  If extra spaces are required in the
3647list of arguments, the entire argument must be surrounded by double quotes.
3648If quotes, spaces, or other special characters need to be added to the
3649arguments list, they must be escaped.
3650
3651auth or authconfig
3652
3653auth|authconfig [options]
3654
3655New in version Fedora3.
3656
3657This required command sets up the authentication options for the system. This is just a wrapper around the authconfig program, so all options recognized by that program are valid for this command. See the manual page for authconfig for a complete list.
3658
3659By default, passwords are normally encrypted and are not shadowed.
3660
3661Changed in version Fedora28.
3662
3663The authconfig program is deprecated. This command will use the authconfig compatibility tool, but you should use the authselect command instead.
3664
3665positional arguments:
3666
3667[options]
3668
3669    See man authconfig.
3670
3671    New in version Fedora3.
3672
3673authselect
3674
3675authselect [options]
3676
3677New in version Fedora28.
3678
3679This command sets up the authentication options for the system. This is just a wrapper around the authselect program, so all options recognized by that program are valid for this command. See the manual page for authselect for a complete list.
3680
3681positional arguments:
3682
3683[options]
3684
3685    See man authselect.
3686
3687    New in version Fedora28.
3688
3689autopart
3690
3691autopart [--encrypted] [--passphrase PASSPHRASE] [--escrowcert <url>]
3692     [--backuppassphrase] [--nolvm] [--type TYPE] [--cipher CIPHER]
3693     [--fstype FSTYPE] [--nohome] [--noboot] [--noswap]
3694     [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
3695     [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
3696     [--pbkdf-iterations PBKDF_ITERATIONS]
3697
3698New in version Fedora3.
3699
3700Automatically create partitions – a root (/) partition, a swap partition, and an appropriate boot partition for the architecture. On large enough drives, this will also create a /home partition.
3701
3702The autopart command can’t be used with the logvol, part/partition, raid, reqpart, or volgroup in the same kickstart file.
3703
3704optional arguments:
3705
3706--encrypted
3707
3708    Should all devices with support be encrypted by default? This is equivalent to checking the “Encrypt” checkbox on the initial partitioning screen.
3709
3710    New in version Fedora9.
3711
3712--passphrase PASSPHRASE
3713
3714    Only relevant if --encrypted is specified. Provide a default system-wide passphrase for all encrypted devices.
3715
3716    New in version Fedora9.
3717
3718--escrowcert <url>
3719
3720    Only relevant if --encrypted is specified. Load an X.509 certificate from <url>. Store the data encryption keys of all encrypted volumes created during installation, encrypted using the certificate, as files in /root.
3721
3722    New in version Fedora12.
3723
3724--backuppassphrase
3725
3726    Only relevant if --escrowcert is specified. In addition to storing the data encryption keys, generate a random passphrase and add it to all encrypted volumes created during installation. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as files in /root (one file for each encrypted volume).
3727
3728    New in version Fedora12.
3729
3730--nolvm
3731
3732    Don’t use LVM when partitioning.
3733
3734    New in version Fedora16.
3735
3736    Changed in version Fedora17.
3737
3738    The same as --type=plain
3739
3740--type TYPE
3741
3742    Select automatic partitioning scheme. Must be one of the following: [‘thinp’, ‘btrfs’, ‘plain’, ‘partition’, ‘lvm’]. Plain means regular partitions with no btrfs or lvm.
3743
3744    New in version Fedora17.
3745
3746    Changed in version Fedora20.
3747
3748    Partitioning scheme ‘thinp’ was added.
3749
3750    Changed in version RedHatEnterpriseLinux8.
3751
3752    Partitioning scheme ‘btrfs’ was removed.
3753
3754--cipher CIPHER
3755
3756    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
3757
3758    New in version Fedora18.
3759
3760--fstype FSTYPE
3761
3762    Use the specified filesystem type on the partitions. Note that it cannot be used with --type=btrfs since btrfs is both a partition scheme and a filesystem. eg. --fstype=ext4.
3763
3764    New in version Fedora21.
3765
3766    Changed in version RedHatEnterpriseLinux8.
3767
3768    Partitioning scheme ‘btrfs’ was removed.
3769
3770--nohome
3771
3772    Do not create a /home partition.
3773
3774    New in version Fedora26.
3775
3776--noboot
3777
3778    Do not create a /boot partition.
3779
3780    New in version Fedora26.
3781
3782--noswap
3783
3784    Do not create a swap partition.
3785
3786    New in version Fedora26.
3787
3788--luks-version LUKS_VERSION
3789
3790    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
3791
3792    New in version Fedora29.
3793
3794--pbkdf PBKDF
3795
3796    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
3797
3798    New in version Fedora29.
3799
3800--pbkdf-memory PBKDF_MEMORY
3801
3802    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
3803
3804    New in version Fedora29.
3805
3806--pbkdf-time PBKDF_TIME
3807
3808    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
3809
3810    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
3811
3812    New in version Fedora29.
3813
3814--pbkdf-iterations PBKDF_ITERATIONS
3815
3816    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
3817
3818    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
3819
3820    New in version Fedora29.
3821
3822autostep
3823
3824autostep [--autoscreenshot]
3825
3826New in version Fedora3.
3827
3828Kickstart installs normally skip unnecessary screens. This makes the installer step through every screen, displaying each briefly.
3829
3830This is mostly used for debugging.
3831
3832optional arguments:
3833
3834--autoscreenshot
3835
3836    Take a screenshot at every step during installation and copy the images over to /root/anaconda-screenshots after installation is complete. This is most useful for documentation.
3837
3838    New in version Fedora3.
3839
3840bootloader
3841
3842bootloader [--append APPENDLINE] [--location {mbr,partition,none,boot}]
3843       [--password PASSWORD] [--driveorder DRIVEORDER] [--timeout TIMEOUT]
3844       [--default DEFAULT] [--iscrypted] [--md5pass _MD5PASS]
3845       [--boot-drive BOOTDRIVE] [--leavebootorder] [--extlinux]
3846       [--disabled] [--nombr] [--upgrade]
3847
3848New in version Fedora3.
3849
3850This required command specifies how the boot loader should be installed.
3851
3852There must be a biosboot partition for the bootloader to be installed successfully onto a disk that contains a GPT/GUID partition table, which includes disks initialized by anaconda. This partition may be created with the kickstart command part biosboot --fstype=biosboot --size=1. However, in the case that a disk has an existing biosboot partition, adding a part biosboot option is unnecessary.
3853
3854optional arguments:
3855
3856--append APPENDLINE
3857
3858    Specifies kernel parameters. The default set of bootloader arguments is “rhgb quiet”. You will get this set of arguments regardless of what parameters you pass to –append, or if you leave out –append entirely. For example:
3859
3860    ``bootloader --location=mbr --append="hdd=ide-scsi ide=nodma"``
3861
3862    New in version Fedora3.
3863
3864--linear
3865
3866    New in version Fedora3.
3867
3868    Removed in version Fedora4.
3869
3870--nolinear
3871
3872    New in version Fedora3.
3873
3874    Removed in version Fedora4.
3875
3876--location {mbr,partition,none,boot}
3877
3878    Specifies where the boot record is written. Valid values are the following: mbr (the default), partition (installs the boot loader on the first sector of the partition containing the kernel), or none (do not install the boot loader).
3879
3880    Note bootloader –location=none is different from bootloader –location=none –disabled. –location=none prevents extra installation steps that makes the target machine bootable, e.g. write to MBR on x86 BIOS systems. However, the corresponding RPM packages are still installed, and –disabled can be appended to prevent it. bootloader –disabled only does not prevent the installation of the bootloader and Anaconda will complain if no other options are provided.
3881
3882    New in version Fedora3.
3883
3884--password PASSWORD
3885
3886    If using GRUB, sets the GRUB boot loader password. This should be used to restrict access to the GRUB shell, where arbitrary kernel options can be passed.
3887
3888    New in version Fedora3.
3889
3890--useLilo
3891
3892    New in version Fedora3.
3893
3894    Removed in version Fedora4.
3895
3896--driveorder DRIVEORDER
3897
3898    New in version Fedora3.
3899
3900--timeout TIMEOUT
3901
3902    Specify the number of seconds before the bootloader times out and boots the default option.
3903
3904    New in version Fedora8.
3905
3906--default DEFAULT
3907
3908    Sets the default boot image in the bootloader configuration.
3909
3910    New in version Fedora8.
3911
3912--lba32
3913
3914    New in version Fedora3.
3915
3916    Deprecated since version Fedora12.
3917
3918    Removed in version Fedora14.
3919
3920--iscrypted
3921
3922    If given, the password specified by --password= is already encrypted and should be passed to the bootloader configuration without additional modification.
3923
3924    New in version Fedora15.
3925
3926--md5pass _MD5PASS
3927
3928    If using GRUB, similar to --password= except the password should already be encrypted.
3929
3930    New in version Fedora3.
3931
3932    Changed in version Fedora15.
3933
3934    If using GRUB, similar to --password= except the password should already be encrypted.
3935
3936--boot-drive BOOTDRIVE
3937
3938    Specifies which drive the bootloader should be written to and thus, which drive the computer will boot from.
3939
3940    New in version Fedora17.
3941
3942--leavebootorder
3943
3944    On EFI or ISeries/PSeries machines, this option prevents the installer from making changes to the existing list of bootable images.
3945
3946    New in version Fedora18.
3947
3948--extlinux
3949
3950    Use the extlinux bootloader instead of GRUB. This option only works on machines that are supported by extlinux.
3951
3952    New in version Fedora19.
3953
3954--disabled
3955
3956    Do not install the boot loader.
3957
3958    Note bootloader –location=none is different from bootloader –location=none –disabled. –location=none prevents extra installation steps that makes the target machine bootable, e.g. write to MBR on x86 BIOS systems. However, the corresponding RPM packages are still installed, and –disabled can be appended to prevent it. bootloader –disabled only does not prevent the installation of the bootloader and Anaconda will complain if no other options are provided.
3959
3960    New in version Fedora21.
3961
3962--nombr
3963
3964    New in version Fedora21.
3965
3966--upgrade
3967
3968    New in version Fedora3.
3969
3970    Deprecated since version Fedora29.
3971
3972btrfs
3973
3974btrfs [--noformat] [--useexisting] [--label LABEL] [--data DATALEVEL]
3975  [--metadata METADATALEVEL] [--subvol] [--parent PARENT] [--name NAME]
3976  [--mkfsoptions MKFSOPTS]
3977
3978New in version Fedora17.
3979
3980Defines a BTRFS volume or subvolume. This command is of the form:
3981
3982btrfs <mntpoint> --data=<level> --metadata=<level> --label=<label> <partitions*>
3983
3984for volumes and of the form:
3985
3986btrfs <mntpoint> --subvol --name=<path> <parent>
3987
3988for subvolumes.
3989
3990The <partitions*> (which denotes that multiple partitions can be listed) lists the BTRFS identifiers to add to the BTRFS volume. For subvolumes, should be the identifier of the subvolume’s parent volume.
3991
3992<mntpoint>
3993
3994Location where the file system is mounted.
3995
3996Deprecated since version RedHatEnterpriseLinux8.
3997
3998optional arguments:
3999
4000--noformat
4001
4002    Use an existing BTRFS volume (or subvolume) and do not reformat the filesystem.
4003
4004    New in version Fedora17.
4005
4006--useexisting
4007
4008    Same as --noformat.
4009
4010    New in version Fedora17.
4011
4012--label LABEL
4013
4014    Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created. This option has no meaning for subvolumes.
4015
4016    New in version Fedora17.
4017
4018--data DATALEVEL
4019
4020    RAID level to use (0, 1, 10) for filesystem data. Optional. This option has no meaning for subvolumes.
4021
4022    New in version Fedora17.
4023
4024--metadata METADATALEVEL
4025
4026    RAID level to use (0, 1, 10) for filesystem/volume metadata. Optional. This option has no meaning for subvolumes.
4027
4028    New in version Fedora17.
4029
4030--subvol
4031
4032    Create BTRFS subvolume.
4033
4034    New in version Fedora17.
4035
4036--parent PARENT
4037
4038    New in version Fedora17.
4039
4040--name NAME
4041
4042    Subvolume name.
4043
4044    New in version Fedora17.
4045
4046--mkfsoptions MKFSOPTS
4047
4048    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
4049
4050    New in version Fedora23.
4051
4052The following example shows how to create a BTRFS volume from member partitions on three disks with subvolumes for root and home. The main volume is not mounted or used directly in this example – only the root and home subvolumes:
4053
4054part btrfs.01 --size=6000 --ondisk=sda
4055part btrfs.02 --size=6000 --ondisk=sdb
4056part btrfs.03 --size=6000 --ondisk=sdc
4057
4058btrfs none --data=0 --metadata=1 --label=f17 btrfs.01 btrfs.02 btrfs.03
4059btrfs / --subvol --name=root LABEL=f17
4060btrfs /home --subvol --name=home f17
4061
4062cdrom
4063
4064cdrom
4065
4066New in version Fedora3.
4067
4068Install from the first CD-ROM/DVD drive on the system.
4069clearpart
4070
4071clearpart [--all] [--drives DRIVES] [--initlabel] [--linux] [--none]
4072      [--list DEVICES] [--disklabel DISKLABEL] [--cdl]
4073
4074New in version Fedora3.
4075
4076Removes partitions from the system, prior to creation of new partitions. By default, no partitions are removed.
4077
4078If the clearpart command is used, then the --onpart command cannot be used on a logical partition.
4079
4080optional arguments:
4081
4082--all
4083
4084    Erases all partitions from the system.
4085
4086    New in version Fedora3.
4087
4088--drives DRIVES
4089
4090    Specifies which drives to clear partitions from. For example, the following clears the partitions on the first two drives on the primary IDE controller:
4091
4092    ``clearpart --all --drives=sda,sdb``
4093
4094    New in version Fedora3.
4095
4096--initlabel
4097
4098    Initializes the disk label to the default for your architecture (for example msdos for x86 and gpt for Itanium). This is only meaningful in combination with the ‘–all’ option.
4099
4100    New in version Fedora3.
4101
4102--linux
4103
4104    Erases all Linux partitions.
4105
4106    New in version Fedora3.
4107
4108--none
4109
4110    Do not remove any partitions. This is the default
4111
4112    New in version Fedora3.
4113
4114--list DEVICES
4115
4116    Specifies which partitions to clear. If given, this supersedes any of the --all and --linux options. This can be across different drives:
4117
4118    ``clearpart --list=sda2,sda3,sdb1``
4119
4120    New in version Fedora17.
4121
4122--disklabel DISKLABEL
4123
4124    Set the default disklabel to use. Only disklabels supported for the platform will be accepted. eg. msdos and gpt for x86_64 but not dasd.
4125
4126    New in version Fedora21.
4127
4128--cdl
4129
4130    Reformat any LDL DASDs to CDL format.
4131
4132    New in version Fedora28.
4133
4134graphical or text or cmdline
4135
4136graphical|text|cmdline [--non-interactive]
4137
4138New in version Fedora3.
4139
4140Controls which display mode will be used during installation. If cmdline is chosen all required installation options must be configured via kickstart otherwise the installation will fail.
4141
4142optional arguments:
4143
4144--non-interactive
4145
4146    Perform the installation in a completely non-interactive mode. This mode will kill the installation when user interaction will be required. Can’t be used with cmdline mode. This option is especially useful for automated testing purpose.
4147
4148    New in version Fedora26.
4149
4150device
4151
4152device [--opts MODULEOPTS]
4153
4154New in version Fedora3.
4155
4156On most PCI systems, the installation program will autoprobe for Ethernet and SCSI cards properly. On older systems and some PCI systems, however, kickstart needs a hint to find the proper devices. The device command, which tells the installation program to install extra modules, is in this format:
4157
4158device <moduleName> --opts=<options>
4159
4160<moduleName>
4161
4162Replace with the name of the kernel module which should be installed.
4163
4164Deprecated since version Fedora24.
4165
4166optional arguments:
4167
4168--opts MODULEOPTS
4169
4170    Options to pass to the kernel module. For example:
4171
4172    --opts="aic152x=0x340 io=11"
4173
4174    New in version Fedora3.
4175
4176deviceprobe
4177
4178deviceprobe
4179
4180New in version Fedora3.
4181dmraid
4182
4183dmraid --name NAME --dev DEVICES
4184
4185New in version Fedora6.
4186
4187Deprecated since version Fedora24.
4188
4189optional arguments:
4190
4191--name NAME
4192
4193    New in version Fedora6.
4194
4195--dev DEVICES
4196
4197    New in version Fedora6.
4198
4199driverdisk
4200
4201driverdisk [--source SOURCE] [--biospart BIOSPART] [partition [partition ...]]
4202
4203New in version Fedora3.
4204
4205Driver diskettes can be used during kickstart installations. You need to copy the driver disk’s contents to the root directory of a partition on the system’s hard drive. Then you need to use the driverdisk command to tell the installation program where to look for the driver disk.
4206
4207positional arguments:
4208
4209partition
4210
4211    Partition containing the driver disk.
4212
4213    New in version Fedora3.
4214
4215optional arguments:
4216
4217--source SOURCE
4218
4219    Specify a URL for the driver disk. NFS locations can be given with nfs:host:/path/to/img.
4220
4221    New in version Fedora3.
4222
4223--biospart BIOSPART
4224
4225    BIOS partition containing the driver disk (such as 82p2).
4226
4227    New in version Fedora4.
4228
4229--type TYPE
4230
4231    New in version Fedora3.
4232
4233    Deprecated since version Fedora12.
4234
4235    Removed in version Fedora14.
4236
4237eula
4238
4239eula [--agreed]
4240
4241New in version Fedora20.
4242
4243Automatically accept Red Hat’s EULA
4244
4245optional arguments:
4246
4247--agreed, --agree, --accepted, --accept
4248
4249    Accept the EULA. This is mandatory option!
4250
4251    New in version Fedora20.
4252
4253fcoe
4254
4255fcoe --nic NIC [--dcb] [--autovlan]
4256
4257New in version Fedora12.
4258
4259Discover and attach FCoE storage devices accessible via specified network interface
4260
4261optional arguments:
4262
4263--nic NIC
4264
4265    Name of the network device connected to the FCoE switch
4266
4267    New in version Fedora12.
4268
4269--dcb
4270
4271    Enable Data Center Bridging awareness in installer. This option should only be enabled for network interfaces that require a host-based DCBX client. Configurations on interfaces that implement a hardware DCBX client should not use it.
4272
4273    New in version Fedora13.
4274
4275--autovlan
4276
4277    Perform automatic VLAN discovery and setup. This option is enabled by default.
4278
4279    New in version Fedora28.
4280
4281firewall
4282
4283firewall [--disable] [--enable] [--port PORTS] [--trust TRUSTS]
4284     [--service SERVICES] [--ftp] [--http] [--smtp] [--ssh]
4285     [--remove-service REMOVE_SERVICES] [--use-system-defaults]
4286
4287New in version Fedora3.
4288
4289This option corresponds to the Firewall Configuration screen in the installation program
4290
4291optional arguments:
4292
4293--disable, --disabled
4294
4295    Do not configure any iptables rules.
4296
4297    New in version Fedora3.
4298
4299--enable, --enabled
4300
4301    Reject incoming connections that are not in response to outbound requests, such as DNS replies or DHCP requests. If access to services running on this machine is needed, you can choose to allow specific services through the firewall.
4302
4303    New in version Fedora3.
4304
4305--high HIGH
4306
4307    New in version Fedora3.
4308
4309    Deprecated since version Fedora3.
4310
4311    Removed in version Fedora9.
4312
4313--medium MEDIUM
4314
4315    New in version Fedora3.
4316
4317    Deprecated since version Fedora3.
4318
4319    Removed in version Fedora9.
4320
4321--port PORTS
4322
4323    You can specify that ports be allowed through the firewall using the port:protocol format. You can also specify ports numerically. Multiple ports can be combined into one option as long as they are separated by commas. For example:
4324
4325    ``firewall --port=imap:tcp,1234:ucp,47``
4326
4327    New in version Fedora3.
4328
4329--trust TRUSTS
4330
4331    Listing a device here, such as eth0, allows all traffic coming from that device to go through the firewall. To list more than one device, use –trust eth0 –trust eth1. Do NOT use a comma-separated format such as –trust eth0, eth1.
4332
4333    New in version Fedora3.
4334
4335--service SERVICES
4336
4337    This option provides a higher-level way to allow services through the firewall. Some services (like cups, avahi, etc.) require multiple ports to be open or other special configuration in order for the service to work. You could specify each individual service with the --port option, or specify --service= and open them all at once.
4338
4339    Valid options are anything recognized by the firewall-cmd program in the firewalld package. If firewalld is running:
4340
4341    ``firewall-cmd --get-services``
4342
4343    will provide a list of known service names.
4344
4345    New in version Fedora10.
4346
4347--ftp
4348
4349    New in version Fedora3.
4350
4351    Changed in version Fedora10.
4352
4353--http
4354
4355    New in version Fedora3.
4356
4357    Changed in version Fedora10.
4358
4359--smtp
4360
4361    New in version Fedora3.
4362
4363    Changed in version Fedora10.
4364
4365--ssh
4366
4367    New in version Fedora3.
4368
4369    Changed in version Fedora10.
4370
4371--telnet TELNET
4372
4373    New in version Fedora3.
4374
4375    Deprecated since version Fedora10.
4376
4377    Removed in version Fedora14.
4378
4379--remove-service REMOVE_SERVICES
4380
4381    New in version Fedora20.
4382
4383--use-system-defaults
4384
4385    Don’t configure the firewall at all. This instructs anaconda to do nothing and allows the system to rely on the defaults that were provided with the package or ostree. If this option is used with other options then all other options will be ignored.
4386
4387    New in version Fedora28.
4388
4389firstboot
4390
4391firstboot [--disable] [--enable] [--reconfig]
4392
4393New in version Fedora3.
4394
4395Determine whether the Setup Agent starts the first time the system is booted. If enabled, the initial-setup package must be installed. If not specified, the setup agent (initial-setup) is disabled by default.
4396
4397optional arguments:
4398
4399--disable, --disabled
4400
4401    The Setup Agent is not started the first time the system boots.
4402
4403    New in version Fedora3.
4404
4405--enable, --enabled
4406
4407    The Setup Agent is started the first time the system boots.
4408
4409    New in version Fedora3.
4410
4411--reconfig
4412
4413    Enable the Setup Agent to start at boot time in reconfiguration mode. This mode enables the language, mouse, keyboard, root password, security level, time zone, and networking configuration options in addition to the default ones.
4414
4415    New in version Fedora3.
4416
4417group
4418
4419group --name NAME [--gid GID]
4420
4421New in version Fedora12.
4422
4423Creates a new user group on the system. If a group with the given name or GID already exists, this command will fail. In addition, the user command can be used to create a new group for the newly created user.
4424
4425optional arguments:
4426
4427--name NAME
4428
4429    Provides the name of the new group.
4430
4431    New in version Fedora12.
4432
4433--gid GID
4434
4435    The group’s GID. If not provided, this defaults to the next available non-system GID.
4436
4437    New in version Fedora12.
4438
4439reboot or poweroff or shutdown or halt
4440
4441reboot|poweroff|shutdown|halt [--eject] [--kexec]
4442
4443New in version Fedora3.
4444
4445reboot
4446
4447Reboot after the installation is complete. Normally, kickstart displays a message and waits for the user to press a key before rebooting.
4448
4449poweroff
4450
4451Turn off the machine after the installation is complete. Normally, kickstart displays a message and waits for the user to press a key before rebooting.
4452
4453shutdown
4454
4455At the end of installation, shut down the machine. This is the same as the poweroff command. Normally, kickstart displays a message and waits for the user to press a key before rebooting.
4456
4457halt
4458
4459At the end of installation, display a message and wait for the user to press a key before rebooting. This is the default action.
4460
4461Changed in version Fedora18.
4462
4463The ‘halt’ command was added!
4464
4465optional arguments:
4466
4467--eject
4468
4469    Attempt to eject CD or DVD media before rebooting.
4470
4471    New in version Fedora6.
4472
4473--kexec
4474
4475    Use kexec to reboot into the new system, bypassing BIOS/Firmware and bootloader.
4476
4477    New in version Fedora23.
4478
4479harddrive
4480
4481harddrive [--biospart BIOSPART] [--partition PARTITION] --dir DIR
4482
4483New in version Fedora3.
4484
4485Install from a directory of ISO images on a local drive, which must be either vfat or ext2. In addition to this directory, you must also provide the install.img in some way. You can either do this by booting off the boot.iso or by creating an images/ directory in the same directory as the ISO images and placing install.img in there.
4486
4487optional arguments:
4488
4489--biospart BIOSPART
4490
4491    BIOS partition to install from (such as 82p2).
4492
4493    New in version Fedora3.
4494
4495--partition PARTITION
4496
4497    Partition to install from (such as, sdb2).
4498
4499    New in version Fedora3.
4500
4501--dir DIR
4502
4503    Directory containing both the ISO images and the images/install.img. For example:
4504
4505    ``harddrive --partition=hdb2 --dir=/tmp/install-tree``
4506
4507    New in version Fedora3.
4508
4509hmc
4510
4511hmc
4512
4513New in version RedHatEnterpriseLinux7.
4514
4515Install from an installation medium via SE/HMC on z Systems.
4516ignoredisk
4517
4518ignoredisk [--drives IGNOREDISK] [--only-use ONLYUSE] [--interactive]
4519
4520New in version Fedora3.
4521
4522Controls anaconda’s access to disks attached to the system. By default, all disks will be available for partitioning. Only one of the following three options may be used.
4523
4524optional arguments:
4525
4526--drives IGNOREDISK
4527
4528    Specifies those disks that anaconda should not touch when partitioning, formatting, and clearing.
4529
4530    New in version Fedora3.
4531
4532    Changed in version Fedora8.
4533
4534    This argument is no longer required!
4535
4536--only-use ONLYUSE
4537
4538    Specifies the opposite - only disks listed here will be used during installation.
4539
4540    New in version Fedora8.
4541
4542--interactive
4543
4544    Allow the user manually navigate the advanced storage screen.
4545
4546    New in version RedHatEnterpriseLinux6.
4547
4548install
4549
4550install [--root-device ROOT_DEVICE]
4551
4552        Install a fresh system. You must specify the type of
4553        installation from one of cdrom, harddrive, nfs, or url
4554        (for ftp or http installations).
4555        The install command and the installation method command
4556        must be on separate lines.
4557
4558        Important: before Fedora 20 this command was known as
4559        install or upgrade but the upgrade part was deprecated!
4560
4561optional arguments:
4562
4563--root-device ROOT_DEVICE
4564
4565    On a system with multiple installs, this option specifies which filesystem holds the installation to be upgraded. This can be specified by device name, UUID=, or LABEL= just like the harddrive command may be.
4566
4567    New in version Fedora11.
4568
4569interactive
4570
4571interactive
4572
4573New in version Fedora3.
4574
4575Use interactive kickstart installation method.
4576
4577Deprecated since version Fedora14.
4578iscsi
4579
4580iscsi [--target TARGET] --ipaddr IPADDR [--port PORT] [--user USER]
4581  [--password PASSWORD] [--reverse-user USER_IN]
4582  [--reverse-password PASSWORD_IN] [--iface IFACE]
4583
4584New in version Fedora6.
4585
4586Specifies additional iSCSI storage to be attached during installation. If you use the iscsi parameter, you must also assign a name to the iSCSI node, using the iscsiname parameter. The iscsiname parameter must appear before the iscsi parameter in the kickstart file.
4587
4588We recommend that wherever possible you configure iSCSI storage in the system BIOS or firmware (iBFT for Intel systems) rather than use the iscsi parameter. Anaconda automatically detects and uses disks configured in BIOS or firmware and no special configuration is necessary in the kickstart file.
4589
4590If you must use the iscsi parameter, ensure that networking is activated at the beginning of the installation, and that the iscsi parameter appears in the kickstart file before you refer to iSCSI disks with parameters such as clearpart or ignoredisk.
4591
4592optional arguments:
4593
4594--target TARGET
4595
4596    The target iqn.
4597
4598    New in version Fedora6.
4599
4600--ipaddr IPADDR
4601
4602    The IP address of the target to connect to.
4603
4604    New in version Fedora6.
4605
4606--port PORT
4607
4608    The port number to connect to (default, –port=3260).
4609
4610    New in version Fedora6.
4611
4612--user USER
4613
4614    The username required to authenticate with the target.
4615
4616    New in version Fedora6.
4617
4618--password PASSWORD
4619
4620    The password that corresponds with the username specified for the target.
4621
4622    New in version Fedora6.
4623
4624--reverse-user USER_IN
4625
4626    The username required to authenticate with the initiator from a target that uses reverse CHAP authentication.
4627
4628    New in version Fedora10.
4629
4630--reverse-password PASSWORD_IN
4631
4632    The password that corresponds with the username specified for the initiator.
4633
4634    New in version Fedora10.
4635
4636--iface IFACE
4637
4638    Bind connection to specific network interface instead of using the default one determined by network layer. Once used, it must be specified for all iscsi commands.
4639
4640    New in version Fedora17.
4641
4642iscsiname
4643
4644iscsiname <iqn>
4645
4646New in version Fedora6.
4647
4648Assigns an initiator name to the computer. If you use the iscsi parameter in your kickstart file, this parameter is mandatory, and you must specify iscsiname in the kickstart file before you specify iscsi.
4649
4650positional arguments:
4651
4652<iqn>
4653
4654    IQN name
4655
4656    New in version Fedora6.
4657
4658key
4659
4660key [--skip]
4661
4662New in version RedHatEnterpriseLinux5.
4663
4664optional arguments:
4665
4666--skip
4667
4668    New in version RedHatEnterpriseLinux5.
4669
4670keyboard
4671
4672keyboard [--vckeymap VC_KEYMAP] [--xlayouts X_LAYOUTS]
4673     [--switch SWITCH_OPTIONS]
4674     [kbd [kbd ...]]
4675
4676New in version Fedora3.
4677
4678This required command sets system keyboard type.
4679
4680Changed in version Fedora18.
4681
4682See the documentation of --vckeymap option and the tip at the end of this section for a guide how to get values accepted by this command.
4683
4684Either --vckeymap or --xlayouts must be used.
4685
4686Alternatively, use the older format, arg, which is still supported. arg can be an X layout or VConsole keymap name.
4687
4688Missing values will be automatically converted from the given one(s).
4689
4690positional arguments:
4691
4692kbd
4693
4694    Keyboard type
4695
4696    New in version Fedora3.
4697
4698optional arguments:
4699
4700--vckeymap VC_KEYMAP
4701
4702    Specify VConsole keymap that should be used. is a keymap name which is the same as the filename under /usr/lib/kbd/keymaps/ without the .map.gz extension.
4703
4704    New in version Fedora18.
4705
4706--xlayouts X_LAYOUTS
4707
4708    Specify a list of X layouts that should be used (comma-separated list without spaces). Accepts the same values as setxkbmap(1), but uses either the layout format (such as cz) or the ‘layout (variant)’ format (such as ‘cz (qwerty)’). For example:
4709
4710    ``keyboard --xlayouts=cz,'cz (qwerty)'`
4711
4712    New in version Fedora18.
4713
4714--switch SWITCH_OPTIONS
4715
4716    Specify a list of layout switching options that should be used (comma-separated list without spaces). Accepts the same values as setxkbmap(1) for layout switching. For example:
4717
4718    ``keyboard --xlayouts=cz,'cz (qwerty)' --switch=grp:alt_shift_toggle``
4719
4720    New in version Fedora18.
4721
4722If you know only the description of the layout (e.g. Czech (qwerty)), you can use http://vpodzime.fedorapeople.org/layouts_list.py to list all available layouts and find the one you want to use. The string in square brackets is the valid layout specification as Anaconda accepts it. The same goes for switching options and http://vpodzime.fedorapeople.org/switching_list.py
4723lang
4724
4725lang [--addsupport LOCALE] <lang>
4726
4727New in version Fedora3.
4728
4729This required command sets the language to use during installation and the default language to use on the installed system to <id>. This can be the same as any recognized setting for the $LANG environment variable, though not all languages are supported during installation.
4730
4731Certain languages (mainly Chinese, Japanese, Korean, and Indic languages) are not supported during text mode installation. If one of these languages is specified using the lang command, installation will continue in English though the running system will have the specified langauge by default.
4732
4733The file /usr/share/system-config-language/locale-list provides a list the valid language codes in the first column of each line and is part of the system-config-languages package.
4734
4735positional arguments:
4736
4737<lang>
4738
4739    Language ID.
4740
4741    New in version Fedora3.
4742
4743optional arguments:
4744
4745--addsupport LOCALE
4746
4747    Install the support packages for the given locales, specified as a comma-separated list. Each locale may be specified in the same ways as the primary language may be, as described above.
4748
4749    New in version Fedora19.
4750
4751langsupport
4752
4753langsupport [--default DEFLANG]
4754
4755New in version Fedora3.
4756
4757Install the support packages for the given locales.
4758
4759Deprecated since version Fedora5.
4760
4761optional arguments:
4762
4763--default DEFLANG
4764
4765    Default locale
4766
4767    New in version Fedora3.
4768
4769lilo
4770
4771lilo [--append APPENDLINE] [--linear] [--nolinear]
4772 [--location {mbr,partition,none,boot}] [--lba32] [--password PASSWORD]
4773 [--md5pass MD5PASS] [--upgrade] [--useLilo] [--driveorder DRIVEORDER]
4774
4775New in version Fedora3.
4776
4777This required command specifies how the boot loader should be installed.
4778
4779There must be a biosboot partition for the bootloader to be installed successfully onto a disk that contains a GPT/GUID partition table, which includes disks initialized by anaconda. This partition may be created with the kickstart command part biosboot --fstype=biosboot --size=1. However, in the case that a disk has an existing biosboot partition, adding a part biosboot option is unnecessary.
4780
4781Deprecated since version Fedora4.
4782
4783optional arguments:
4784
4785--append APPENDLINE
4786
4787    Specifies kernel parameters. The default set of bootloader arguments is “rhgb quiet”. You will get this set of arguments regardless of what parameters you pass to –append, or if you leave out –append entirely. For example:
4788
4789    ``bootloader --location=mbr --append="hdd=ide-scsi ide=nodma"``
4790
4791    New in version Fedora3.
4792
4793--linear
4794
4795    New in version Fedora3.
4796
4797--nolinear
4798
4799    New in version Fedora3.
4800
4801--location {mbr,partition,none,boot}
4802
4803    Specifies where the boot record is written. Valid values are the following: mbr (the default), partition (installs the boot loader on the first sector of the partition containing the kernel), or none (do not install the boot loader).
4804
4805    Note bootloader –location=none is different from bootloader –location=none –disabled. –location=none prevents extra installation steps that makes the target machine bootable, e.g. write to MBR on x86 BIOS systems. However, the corresponding RPM packages are still installed, and –disabled can be appended to prevent it. bootloader –disabled only does not prevent the installation of the bootloader and Anaconda will complain if no other options are provided.
4806
4807    New in version Fedora3.
4808
4809--lba32
4810
4811    New in version Fedora3.
4812
4813--password PASSWORD
4814
4815    If using GRUB, sets the GRUB boot loader password. This should be used to restrict access to the GRUB shell, where arbitrary kernel options can be passed.
4816
4817    New in version Fedora3.
4818
4819--md5pass MD5PASS
4820
4821    If using GRUB, similar to --password= except the password should already be encrypted.
4822
4823    New in version Fedora3.
4824
4825--upgrade
4826
4827    New in version Fedora3.
4828
4829--useLilo
4830
4831    New in version Fedora3.
4832
4833--driveorder DRIVEORDER
4834
4835    New in version Fedora3.
4836
4837lilocheck
4838
4839lilocheck
4840
4841New in version Fedora3.
4842
4843Deprecated since version Fedora4.
4844liveimg
4845
4846liveimg --url <url> [--proxy <proxyurl>] [--noverifyssl] [--checksum <sha256>]
4847
4848New in version Fedora19.
4849
4850Install a disk image instead of packages. The image can be the squashfs.img from a Live iso, or any filesystem mountable by the install media (eg. ext4). Anaconda expects the image to contain utilities it needs to complete the system install so the best way to create one is to use livemedia-creator to make the disk image. If the image contains /LiveOS/*.img (this is how squashfs.img is structured) the first *.img file inside LiveOS will be mounted and used to install the target system. The URL may also point to a tarfile of the root filesystem. The file must end in .tar, .tbz, .tgz, .txz, .tar.bz2, tar.gz, tar.xz
4851
4852optional arguments:
4853
4854--url <url>
4855
4856    The URL to install from. http, https, ftp and file are supported.
4857
4858    New in version Fedora19.
4859
4860--proxy <proxyurl>
4861
4862    Specify an HTTP/HTTPS/FTP proxy to use while performing the install. The various parts of the argument act like you would expect. Syntax is:
4863
4864    ``--proxy=[protocol://][username[:password]@]host[:port]``
4865
4866    New in version Fedora19.
4867
4868--noverifyssl
4869
4870    For a tree on a HTTPS server do not check the server’s certificate with what well-known CA validate and do not check the server’s hostname matches the certificate’s domain name.
4871
4872    New in version Fedora19.
4873
4874--checksum <sha256>
4875
4876    Optional sha256 checksum of the image file
4877
4878    New in version Fedora19.
4879
4880logging
4881
4882logging [--host HOST] [--port PORT]
4883    [--level {debug,info,warning,error,critical}]
4884
4885New in version Fedora6.
4886
4887This command controls the error logging of anaconda during installation. It has no effect on the installed system.
4888
4889optional arguments:
4890
4891--host HOST
4892
4893    Send logging information to the given remote host, which must be running a syslogd process configured to accept remote logging.
4894
4895    New in version Fedora6.
4896
4897--port PORT
4898
4899    If the remote syslogd process uses a port other than the default, it may be specified with this option.
4900
4901    New in version Fedora6.
4902
4903--level {debug,info,warning,error,critical}
4904
4905    Specify the minimum level of messages that appear on tty3. All messages will still be sent to the log file regardless of this level, however.
4906
4907    New in version Fedora6.
4908
4909logvol
4910
4911logvol [--fstype FSTYPE] [--grow] [--maxsize MAXSIZEMB] --name NAME
4912   [--noformat] [--percent PERCENT] [--recommended] [--size SIZE]
4913   [--useexisting] --vgname VGNAME [--fsoptions FSOPTS]
4914   [--fsprofile FSPROFILE] [--encrypted] [--passphrase PASSPHRASE]
4915   [--escrowcert <url>] [--backuppassphrase] [--label LABEL] [--resize]
4916   [--hibernation] [--cipher CIPHER] [--thinpool] [--thin]
4917   [--poolname POOL_NAME] [--chunksize CHUNK_SIZE]
4918   [--metadatasize METADATA_SIZE] [--profile PROFILE]
4919   [--cachesize CACHE_SIZE] [--cachemode CACHE_MODE]
4920   [--cachepvs CACHE_PVS] [--mkfsoptions MKFSOPTS]
4921   [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
4922   [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
4923   [--pbkdf-iterations PBKDF_ITERATIONS]
4924   <mntpoint>
4925
4926New in version Fedora3.
4927
4928Create a logical volume for Logical Volume Management (LVM).
4929
4930positional arguments:
4931
4932<mntpoint>
4933
4934    Mountpoint for this logical volume or ‘none’.
4935
4936    New in version Fedora3.
4937
4938optional arguments:
4939
4940--fstype FSTYPE
4941
4942    Sets the file system type for the logical volume. Valid values include ext4, ext3, ext2, btrfs, swap, and vfat. Other filesystems may be valid depending on command line arguments passed to Anaconda to enable other filesystems.
4943
4944    New in version Fedora3.
4945
4946    Changed in version RedHatEnterpriseLinux8.
4947
4948    Btrfs support was removed.
4949
4950--grow
4951
4952    Tells the logical volume to grow to fill available space (if any), or up to the maximum size setting. Note that --grow is not supported for logical volumes containing a RAID volume on top of them.
4953
4954    New in version Fedora3.
4955
4956--maxsize MAXSIZEMB
4957
4958    The maximum size in MiB the logical volume may grow to. Specify an integer value here, and do not append any units. This option is only relevant if --grow is specified as well.
4959
4960    New in version Fedora3.
4961
4962--name NAME
4963
4964    The name of this logical volume.
4965
4966    New in version Fedora3.
4967
4968--noformat
4969
4970    Use an existing logical volume and do not format it.
4971
4972    New in version Fedora3.
4973
4974--percent PERCENT
4975
4976    Specify the size of the logical volume as a percentage of available space in the volume group. Without the above --grow option, this may not work.
4977
4978    New in version Fedora3.
4979
4980--recommended
4981
4982    Determine the size of the logical volume automatically.
4983
4984    New in version Fedora3.
4985
4986--size SIZE
4987
4988    Size of this logical volume.
4989
4990    New in version Fedora3.
4991
4992--useexisting
4993
4994    Use an existing logical volume and reformat it.
4995
4996    New in version Fedora3.
4997
4998--vgname VGNAME
4999
5000    Name of the Volume Group this logical volume belongs to.
5001
5002    New in version Fedora3.
5003
5004--fsoptions FSOPTS
5005
5006    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
5007
5008    New in version Fedora4.
5009
5010--bytes-per-inode BYTES_PER_INODE
5011
5012    Specify the bytes/inode ratio.
5013
5014    New in version Fedora4.
5015
5016    Deprecated since version Fedora9.
5017
5018    Removed in version Fedora14.
5019
5020--fsprofile FSPROFILE
5021
5022    Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2/3/4, this configuration file is /etc/mke2fs.conf.
5023
5024    New in version Fedora9.
5025
5026--encrypted
5027
5028    Specify that this logical volume should be encrypted.
5029
5030    New in version Fedora9.
5031
5032--passphrase PASSPHRASE
5033
5034    Specify the passphrase to use when encrypting this logical volume. Without the above --encrypted option, this option does nothing. If no passphrase is specified, the default system-wide one is used, or the installer will stop and prompt if there is no default.
5035
5036    New in version Fedora9.
5037
5038--escrowcert <url>
5039
5040    Load an X.509 certificate from <url>. Store the data encryption key of this logical volume, encrypted using the certificate, as a file in /root. Only relevant if --encrypted is specified as well.
5041
5042    New in version Fedora12.
5043
5044--backuppassphrase
5045
5046    Only relevant if --escrowcert is specified as well. In addition to storing the data encryption key, generate a random passphrase and add it to this logical volume. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as a file in /root. If more than one LUKS volume uses --backuppassphrase, the same passphrase will be used for all such volumes.
5047
5048    New in version Fedora12.
5049
5050--label LABEL
5051
5052    Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created.
5053
5054    New in version Fedora15.
5055
5056--resize
5057
5058    Attempt to resize this logical volume to the size given by --size=. This option must be used with --useexisting --size=, or an error will be raised.
5059
5060    New in version Fedora17.
5061
5062--hibernation
5063
5064    This option can be used to automatically determine the size of the swap partition big enough for hibernation.
5065
5066    New in version Fedora18.
5067
5068--cipher CIPHER
5069
5070    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
5071
5072    New in version Fedora18.
5073
5074--thinpool
5075
5076    Create a thin pool logical volume. Use a mountpoint of ‘none’.
5077
5078    New in version Fedora20.
5079
5080--thin
5081
5082    Create a thin logical volume. Requires --poolname.
5083
5084    New in version Fedora20.
5085
5086--poolname POOL_NAME
5087
5088    Specify the name of the thin pool in which to create a thin logical volume. Requires --thin.
5089
5090    New in version Fedora20.
5091
5092--chunksize CHUNK_SIZE
5093
5094    Specify the chunk size (in KiB) for a new thin pool device.
5095
5096    New in version Fedora20.
5097
5098--metadatasize METADATA_SIZE
5099
5100    Specify the metadata area size (in MiB) for a new thin pool device.
5101
5102    New in version Fedora20.
5103
5104--profile PROFILE
5105
5106    Specify an LVM profile for the thin pool (see lvm(8), standard profiles are default and thin-performance defined in the /etc/lvm/profile/ directory).
5107
5108    New in version Fedora21.
5109
5110--cachesize CACHE_SIZE
5111
5112    Requested size (in MiB) of cache attached to the logical volume. Requires --cachepvs.
5113
5114    New in version Fedora23.
5115
5116--cachemode CACHE_MODE
5117
5118    Mode that should be used for the cache. Either writeback or writethrough.
5119
5120    New in version Fedora23.
5121
5122--cachepvs CACHE_PVS
5123
5124    Comma-separated list of (fast) physical volumes that should be used for the cache.
5125
5126    New in version Fedora23.
5127
5128--mkfsoptions MKFSOPTS
5129
5130    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
5131
5132    New in version Fedora23.
5133
5134--luks-version LUKS_VERSION
5135
5136    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
5137
5138    New in version Fedora29.
5139
5140--pbkdf PBKDF
5141
5142    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
5143
5144    New in version Fedora29.
5145
5146--pbkdf-memory PBKDF_MEMORY
5147
5148    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
5149
5150    New in version Fedora29.
5151
5152--pbkdf-time PBKDF_TIME
5153
5154    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
5155
5156    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
5157
5158    New in version Fedora29.
5159
5160--pbkdf-iterations PBKDF_ITERATIONS
5161
5162    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
5163
5164    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
5165
5166    New in version Fedora29.
5167
5168Create the partition first, create the logical volume group, and then create the logical volume. For example:
5169
5170part pv.01 --size 3000
5171volgroup myvg pv.01
5172logvol / --vgname=myvg --size=2000 --name=rootvol
5173
5174mediacheck
5175
5176mediacheck
5177
5178New in version Fedora4.
5179
5180If given, this will force anaconda to run mediacheck on the installation media. This command requires that installs be attended, so it is disabled by default.
5181method
5182
5183method
5184
5185New in version Fedora3.
5186
5187Proxy to the actual installation method. Valid installation methods are:
5188
5189    cdrom
5190    harddrive
5191    nfs
5192    url
5193    liveimg
5194    hmc
5195
5196monitor
5197
5198monitor [--hsync HSYNC] [--monitor MONITOR] [--vsync VSYNC] [--noprobe]
5199
5200New in version Fedora3.
5201
5202If the monitor command is not given, anaconda will use X to automatically detect your monitor settings. Please try this before manually configuring your monitor.
5203
5204Deprecated since version Fedora10.
5205
5206optional arguments:
5207
5208--hsync HSYNC
5209
5210    Specifies the horizontal sync frequency of the monitor.
5211
5212    New in version Fedora3.
5213
5214--monitor MONITOR
5215
5216    Use specified monitor; monitor name should be from the list of monitors in /usr/share/hwdata/MonitorsDB from the hwdata package. The list of monitors can also be found on the X Configuration screen of the Kickstart Configurator. This is ignored if --hsync or --vsync is provided. If no monitor information is provided, the installation program tries to probe for it automatically.
5217
5218    New in version Fedora3.
5219
5220--vsync VSYNC
5221
5222    Specifies the vertical sync frequency of the monitor.
5223
5224    New in version Fedora3.
5225
5226--noprobe
5227
5228    Do not probe the monitor.
5229
5230    New in version Fedora6.
5231
5232mount
5233
5234mount [--reformat [REFORMAT]] [--mkfsoptions MKFS_OPTS]
5235  [--mountoptions MOUNT_OPTS]
5236  <device> <mntpoint>
5237
5238New in version Fedora27.
5239
5240Assigns a mount point to a block device and optionally reformats it to a given format. It at least requires a device and a mount point where the mount point can be none in case the format on the device is not mountable or in case the device should just be reformatted.
5241
5242The difference between this command and the other commands for storage configuration (part, logvol,…) is that it doesn’t require the whole storage stack to be described in the kickstart file. The user just needs to make sure that the specified block device exists in the system. The installer doesn’t necessarily have to know all the details about of the given device. If, on the other hand, the installer is supposed to create the storage stack with all the devices mounted at various places, the part, logvol, raid, etc. commands have to be used.
5243
5244positional arguments:
5245
5246<device>
5247
5248    The block device to mount
5249
5250    New in version Fedora27.
5251
5252<mntpoint>
5253
5254    The <mntpoint> is where the <device> will be mounted. Must be a valid mount point, for example /, /usr, /home, or none if the device cannot (e.g. swap) or should not be mounted.
5255
5256    New in version Fedora27.
5257
5258optional arguments:
5259
5260--reformat [REFORMAT]
5261
5262    Specifies the new format (e.g. a file system) for the device.
5263
5264    New in version Fedora27.
5265
5266--mkfsoptions MKFS_OPTS
5267
5268    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
5269
5270    New in version Fedora27.
5271
5272--mountoptions MOUNT_OPTS
5273
5274    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
5275
5276    New in version Fedora27.
5277
5278mouse
5279
5280mouse [--device DEVICE] [--emulthree]
5281
5282New in version RedHatEnterpriseLinux3.
5283
5284Configure the system mouse
5285
5286Deprecated since version Fedora3.
5287
5288optional arguments:
5289
5290--device DEVICE
5291
5292    Which device node to use for mouse
5293
5294    New in version RedHatEnterpriseLinux3.
5295
5296--emulthree
5297
5298    If set emulate 3 mouse buttons
5299
5300    New in version RedHatEnterpriseLinux3.
5301
5302multipath
5303
5304multipath --name NAME --device DEVICE --rule RULE
5305
5306New in version Fedora6.
5307
5308Deprecated since version Fedora24.
5309
5310optional arguments:
5311
5312--name NAME
5313
5314    New in version Fedora6.
5315
5316--device DEVICE
5317
5318    New in version Fedora6.
5319
5320--rule RULE
5321
5322    New in version Fedora6.
5323
5324network
5325
5326network [--bootproto {dhcp,bootp,static,query,ibft}] [--dhcpclass DHCPCLASS]
5327    [--device DEVICE] [--essid ESSID] [--ethtool ETHTOOL]
5328    [--gateway GATEWAY] [--hostname HOSTNAME] [--ip IP] [--mtu MTU]
5329    [--nameserver NAMESERVER] [--netmask NETMASK] [--nodns]
5330    [--onboot ONBOOT] [--wepkey WEPKEY] [--notksdevice] [--noipv4]
5331    [--noipv6] [--ipv6 IPV6] [--activate] [--nodefroute] [--wpakey WPAKEY]
5332    [--bondslaves BONDSLAVES] [--bondopts BONDOPTS] [--vlanid VLANID]
5333    [--ipv6gateway IPV6GATEWAY] [--teamslaves TEAMSLAVES]
5334    [--teamconfig TEAMCONFIG] [--interfacename INTERFACENAME]
5335    [--bridgeslaves BRIDGESLAVES] [--bridgeopts BRIDGEOPTS]
5336    [--no-activate] [--bindto {mac}]
5337
5338New in version Fedora3.
5339
5340Configures network information for target system and activates network devices in installer environment. The device specified in the first network command is activated automatically. Activation of the device can be also explicitly required by --activate option
5341
5342optional arguments:
5343
5344--bootproto {dhcp,bootp,static,query,ibft}
5345
5346    The method of IPv4 configuration. For IPv6 configuration use --ipv6 option.
5347
5348    The default setting is dhcp. To turn IPv4 configuration off use --noipv4 option.
5349
5350        The dhcp method uses a DHCP server system to
5351
5352    obtain its networking configuration.
5353
5354        The static method requires that you specify at
5355
5356    least IP address and netmask with --ip and --netmask options. For example:
5357
5358    ``network --device=link --bootproto=static --ip=10.0.2.15 --netmask=255.255.255.0 --gateway=10.0.2.254 --nameserver=10.0.2.1``
5359
5360        ibft setting is for reading the configuration
5361
5362    from iBFT table.
5363
5364    New in version Fedora3.
5365
5366    Changed in version Fedora9.
5367
5368    The ‘query’ value was added.
5369
5370    Changed in version Fedora16.
5371
5372    The ‘ibft’ value was added.
5373
5374--dhcpclass DHCPCLASS
5375
5376    Specifies the DHCP vendor class identifier. The dhcpd service will see this value as vendor-class-identifier.
5377
5378    New in version Fedora3.
5379
5380--device DEVICE
5381
5382    Specifies the device to be configured (and eventually activated in Anaconda) with the network command.
5383
5384    You can specify a device to be activated in any of the following ways: - the device name of the interface, for example, em1 - the MAC address of the interface, for example, 01:23:45:67:89:ab - the keyword link, which specifies the first interface with its link in the up state - the keyword bootif, which uses the MAC address that pxelinux set in the BOOTIF variable. Set IPAPPEND 2 in your pxelinux.cfg file to have pxelinux set the BOOTIF variable.
5385
5386    For example:
5387
5388    ``network --bootproto=dhcp --device=ens3``
5389
5390    If the --device= option is missing on the first use of the network command, the value of the ksdevice= Anaconda boot option is used, if available. If ksdevice= is not set, link value is used. Note that this is considered deprecated behavior; in most cases, you should always specify a --device= for every network command. The behavior of any subsequent network command in the same Kickstart file is unspecified if its --device= option is missing. Make sure you specify this option for any network command beyond the first.
5391
5392    New in version Fedora3.
5393
5394--essid ESSID
5395
5396    The network ID for wireless networks.
5397
5398    New in version Fedora3.
5399
5400--ethtool ETHTOOL
5401
5402    Specifies additional low-level settings for the network device which will be passed to the ethtool program.
5403
5404    New in version Fedora3.
5405
5406--gateway GATEWAY
5407
5408    Default gateway, as a single IPv4 address.
5409
5410    New in version Fedora3.
5411
5412--hostname HOSTNAME
5413
5414    The host name for the installed system.
5415
5416    The host name can either be a fully-qualified domain name (FQDN) in the format hostname.domainname, or a short host name with no domain. Many networks have a DHCP service which automatically supplies connected systems with a domain name; to allow DHCP to assign the domain name, only specify a short host name.
5417
5418    New in version Fedora3.
5419
5420--ip IP
5421
5422    IPv4 address for the interface.
5423
5424    New in version Fedora3.
5425
5426--mtu MTU
5427
5428    The MTU of the device.
5429
5430    New in version Fedora3.
5431
5432--nameserver NAMESERVER
5433
5434    Primary nameserver, as an IP address. Multiple nameservers must be comma separated.
5435
5436    New in version Fedora3.
5437
5438--netmask NETMASK
5439
5440    IPv4 network mask of the device.
5441
5442    New in version Fedora3.
5443
5444--nodns
5445
5446    Do not configure any DNS server.
5447
5448    New in version Fedora3.
5449
5450--onboot ONBOOT
5451
5452    Whether or not to enable the device a boot time.
5453
5454    New in version Fedora3.
5455
5456--wepkey WEPKEY
5457
5458    The WEP encryption key for wireless networks.
5459
5460    New in version Fedora3.
5461
5462--notksdevice
5463
5464    This network device is not used for kickstart.
5465
5466    New in version Fedora4.
5467
5468--noipv4
5469
5470    Disable IPv4 configuration of this device.
5471
5472    New in version Fedora6.
5473
5474--noipv6
5475
5476    Disable IPv6 configuration of this device.
5477
5478    New in version Fedora6.
5479
5480--ipv6 IPV6
5481
5482    IPv6 address for the interface. This can be: - the static address in form <IPv6 address>[/<prefix length>], e.g. 3ffe:ffff:0:1::1/128 (if prefix is omitted 64 is assumed), - auto for stateless automatic address autoconfiguration, or - dhcp for DHCPv6-only configuration (no router advertisements).
5483
5484    New in version Fedora8.
5485
5486--activate
5487
5488    As noted above, using this option ensures any matching devices beyond the first will also be activated.
5489
5490    New in version Fedora16.
5491
5492--nodefroute
5493
5494    Prevents grabbing of the default route by the device. It can be useful when activating additional devices in installer using --activate option.
5495
5496    New in version Fedora16.
5497
5498--wpakey WPAKEY
5499
5500    The WPA encryption key for wireless networks.
5501
5502    New in version Fedora16.
5503
5504--bondslaves BONDSLAVES
5505
5506    Bonded device with name specified by --device option will be created using slaves specified in this option. Example:
5507
5508    ``network --device bond0 --bootproto static --ip=10.34.102.222 --netmask=255.255.255.0 --gateway=10.34.102.254 --nameserver=10.34.39.2 --bondslaves=ens7,ens8 --bondopts=mode=active-backup,primary=ens7 --activate``
5509
5510    New in version Fedora19.
5511
5512--bondopts BONDOPTS
5513
5514    A comma-separated list of optional parameters for bonded interface specified by --bondslaves and --device options. Example:
5515
5516    ``--bondopts=mode=active-backup,primary=eth1``
5517
5518    If an option itself contains comma as separator use semicolon to separate the options. Example:
5519
5520    ``--bondopts=mode=active-backup,balance-rr;primary=eth1``
5521
5522    New in version Fedora19.
5523
5524--vlanid VLANID
5525
5526    Id (802.1q tag) of vlan device to be created using parent device specified by --device option. For example:
5527
5528    ``network --device=eth0 --vlanid=171``
5529
5530    will create vlan device eth0.171.
5531
5532    New in version Fedora19.
5533
5534--ipv6gateway IPV6GATEWAY
5535
5536    Default gateway, as a single IPv6 address.
5537
5538    New in version Fedora19.
5539
5540--teamslaves TEAMSLAVES
5541
5542    Team device with name specified by --device option will be created using slaves specified in this option. Slaves are separated by comma. A slave can be followed by its configuration which is a single-quoted json format string with double qoutes escaped by '' character. Example:
5543
5544    ``--teamslaves="p3p1'{"prio": -10, "sticky": true}',p3p2'{"prio": 100}'"``.
5545
5546    See also --teamconfig option.
5547
5548    New in version Fedora20.
5549
5550--teamconfig TEAMCONFIG
5551
5552    Double-quoted team device configuration which is a json format string with double quotes escaped with '' character. The device name is specified by --device option and its slaves and their configuration by --teamslaves option. Example:
5553
5554    ``network --device team0 --activate --bootproto static --ip=10.34.102.222 --netmask=255.255.255.0 --gateway=10.34.102.254 --nameserver=10.34.39.2 --teamslaves="p3p1'{"prio": -10, "sticky": true}',p3p2'{"prio": 100}'" --teamconfig="{"runner": {"name": "activebackup"}}"``
5555
5556    New in version Fedora20.
5557
5558--interfacename INTERFACENAME
5559
5560    Specify a custom interface name for a virtual LAN device. This option should be used when the default name generated by the --vlanid= option is not desirable. This option must be used along with --vlanid=. For example:
5561
5562    ``network --device=em1 --vlanid=171 --interfacename=vlan171``
5563
5564    The above command creates a virtual LAN interface named vlan171 on the em1 device with an ID of 171. The interface name can be arbitrary (for example, my-vlan), but in specific cases, the following conventions must be followed:
5565
5566    If the name contains a dot (.), it must take the form of NAME.ID. The NAME is arbitrary, but the ID must be the VLAN ID. For example: em1.171 or my-vlan.171. Names starting with vlan must take the form of vlanID - for example: vlan171.
5567
5568    New in version Fedora21.
5569
5570--bridgeslaves BRIDGESLAVES
5571
5572    When this option is used, the network bridge with device name specified using the --device= option will be created and devices defined in the --bridgeslaves= option will be added to the bridge. For example:
5573
5574    ``network --device=bridge0 --bridgeslaves=em1``
5575
5576    New in version Fedora22.
5577
5578--bridgeopts BRIDGEOPTS
5579
5580    An optional comma-separated list of parameters for the bridged interface. Available values are stp, priority, forward-delay, hello-time, max-age, and ageing-time. For information about these parameters, see the bridge setting table in the nm-settings(5) man page or at https://developer.gnome.org/NetworkManager/0.9/ref-settings.html.
5581
5582    New in version Fedora22.
5583
5584--no-activate
5585
5586    Use this option with first network command to prevent activation of the device in istaller environment
5587
5588    New in version Fedora25.
5589
5590--bindto {mac}
5591
5592    Optionally allows to specify how the connection configuration created for the device should be bound. If the option is not used, the connection binds to interface name (DEVICE value in ifcfg file). For virtual devices (bond, team, bridge) it configures binding of slaves. Not applicable to vlan devices.
5593
5594    Note that this option is independent of how the --device is specified.
5595
5596    Currently only the value mac is suported. --bindto=mac will bind the connection to MAC address of the device (HWADDR value in ifcfg file).
5597
5598    For example:
5599
5600    ``network --device=01:23:45:67:89:ab --bootproto=dhcp --bindto=mac``
5601
5602    will bind the configuration of the device specified by MAC address 01:23:45:67:89:ab to its MAC address.
5603
5604    network --device=01:23:45:67:89:ab --bootproto=dhcp
5605
5606    will bind the configuration of the device specified by MAC address 01:23:45:67:89:ab to its interface name (eg ens3).
5607
5608    network --device=ens3 --bootproto=dhcp --bindto=mac
5609
5610    will bind the configuration of the device specified by interface name ens3 to its MAC address.
5611
5612    New in version Fedora27.
5613
5614nfs
5615
5616nfs --server <hostname> --dir <directory> [--opts <options>]
5617
5618New in version Fedora3.
5619
5620Install from the NFS server specified. This can either be an exploded installation tree or a directory of ISO images. In the latter case, the install.img must also be provided subject to the same rules as with the harddrive installation method described above.
5621
5622optional arguments:
5623
5624--server <hostname>
5625
5626    Server from which to install (hostname or IP).
5627
5628    New in version Fedora3.
5629
5630--dir <directory>
5631
5632    Directory containing the Packages/ directory of the installation tree. If doing an ISO install, this directory must also contain images/install.img.
5633
5634    New in version Fedora3.
5635
5636--opts <options>
5637
5638    Mount options to use for mounting the NFS export. Any options that can be specified in /etc/fstab for an NFS mount are allowed. The options are listed in the nfs(5) man page. Multiple options are separated with a comma.
5639
5640    New in version Fedora6.
5641
5642nvdimm
5643
5644nvdimm [--namespace <namespace>]
5645   [--blockdevs <devspec1>,<devspec2>,...,<devspecN>] [--mode {sector}]
5646   [--sectorsize SECTORSIZE]
5647   {reconfigure,use}
5648
5649New in version Fedora28.
5650
5651Perform an action on an nvdimm device.
5652
5653positional arguments:
5654
5655{reconfigure,use}
5656
5657    The action to be performed on the device specified by further options. The device can be specified by --namespace or --blockdevs options, depending on the action.
5658
5659    Valid actions: - reconfigure: Reconfigures the device specified by --namespace into the mode specified by --mode and (depending on the mode) --sectorsize options. The device reconfigured into sector mode will be allowed to be used for storage configuration. - use: Allow the device to be used for storage configuration. By default nvdimm devices are ignored. Only devices in sector mode can be used.
5660
5661    New in version Fedora28.
5662
5663optional arguments:
5664
5665--namespace <namespace>
5666
5667    The device specification by namespace.
5668
5669    New in version Fedora28.
5670
5671--blockdevs <devspec1>,<devspec2>,...,<devspecN>
5672
5673    Specification of devices by comma separated list of block device names.
5674
5675    New in version Fedora28.
5676
5677--mode {sector}
5678
5679    The mode specification.
5680
5681    New in version Fedora28.
5682
5683--sectorsize SECTORSIZE
5684
5685    Size of a sector for sector mode.
5686
5687    New in version Fedora28.
5688
5689ostreesetup
5690
5691ostreesetup --osname OSNAME [--remote REMOTE] --url URL --ref REF [--nogpg]
5692
5693New in version Fedora21.
5694
5695Used for OSTree installations. See https://wiki.gnome.org/action/show/Projects/OSTree for more information about OSTree.
5696
5697optional arguments:
5698
5699--osname OSNAME
5700
5701    Management root for OS installation.
5702
5703    New in version Fedora21.
5704
5705--remote REMOTE
5706
5707    Management root for OS installation.
5708
5709    New in version Fedora21.
5710
5711--url URL
5712
5713    Repository URL.
5714
5715    New in version Fedora21.
5716
5717--ref REF
5718
5719    Name of branch inside the repository.
5720
5721    New in version Fedora21.
5722
5723--nogpg
5724
5725    Disable GPG key verification.
5726
5727    New in version Fedora21.
5728
5729part or partition
5730
5731part|partition [--asprimary] [--fstype FSTYPE] [--grow] [--maxsize MAXSIZEMB]
5732           [--noformat] [--onbiosdisk ONBIOSDISK] [--ondisk DISK]
5733           [--onpart ONPART] [--recommended] [--size SIZE]
5734           [--fsoptions FSOPTS] [--label LABEL] [--fsprofile FSPROFILE]
5735           [--encrypted] [--passphrase PASSPHRASE] [--escrowcert <url>]
5736           [--backuppassphrase] [--resize] [--hibernation]
5737           [--cipher CIPHER] [--mkfsoptions MKFSOPTS] [--active]
5738           [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
5739           [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
5740           [--pbkdf-iterations PBKDF_ITERATIONS]
5741           <mntpoint>
5742
5743New in version Fedora3.
5744
5745Creates a partition on the system. This command is required. All partitions created will be formatted as part of the installation process unless --noformat and --onpart are used.
5746
5747positional arguments:
5748
5749<mntpoint>
5750
5751    The <mntpoint> is where the partition will be mounted and must be of one of the following forms:
5752
5753    /<path>
5754
5755    For example, /, /usr, /home
5756
5757    swap
5758
5759    The partition will be used as swap space.
5760
5761    raid.<id>
5762
5763    The partition will be used for software RAID. Refer to the raid command.
5764
5765    pv.<id>
5766
5767    The partition will be used for LVM. Refer to the logvol command.
5768
5769    btrfs.<id>
5770
5771    The partition will be used for BTRFS volume. Rerefer to the btrfs command.
5772
5773    biosboot
5774
5775    The partition will be used for a BIOS Boot Partition. As of Fedora 16 there must be a biosboot partition for the bootloader to be successfully installed onto a disk that contains a GPT/GUID partition table. Rerefer to the bootloader command.
5776
5777    New in version Fedora3.
5778
5779optional arguments:
5780
5781--asprimary
5782
5783    Forces automatic allocation of the partition as a primary partition or the partitioning will fail.
5784
5785    TIP: The --asprimary option only makes sense with the MBR partitioning scheme and is ignored when the GPT partitioning scheme is used.
5786
5787    New in version Fedora3.
5788
5789--fstype FSTYPE, --type FSTYPE
5790
5791    Sets the file system type for the partition. Valid values include ext4, ext3, ext2, xfs, btrfs, swap, and vfat. Other filesystems may be valid depending on command line arguments passed to anaconda to enable other filesystems.
5792
5793    New in version Fedora3.
5794
5795    Changed in version RedHatEnterpriseLinux8.
5796
5797    Btrfs support was removed.
5798
5799--grow
5800
5801    Tells the partition to grow to fill available space (if any), or up to the maximum size setting. Note that --grow is not supported for partitions containing a RAID volume on top of them.
5802
5803    New in version Fedora3.
5804
5805--maxsize MAXSIZEMB
5806
5807    The maximum size in MiB the partition may grow to. Specify an integer value here, and do not append any units. This option is only relevant if --grow is specified as well.
5808
5809    New in version Fedora3.
5810
5811--noformat
5812
5813    Tells the installation program not to format the partition, for use with the --onpart command.
5814
5815    New in version Fedora3.
5816
5817--onbiosdisk ONBIOSDISK
5818
5819    Forces the partition to be created on a particular disk as discovered by the BIOS.
5820
5821    New in version Fedora3.
5822
5823--ondisk DISK, --ondrive DISK
5824
5825    Forces the partition to be created on a particular disk.
5826
5827    New in version Fedora3.
5828
5829--onpart ONPART, --usepart ONPART
5830
5831    Put the partition on an already existing device. Use --onpart=LABEL=name or --onpart=UUID=name to specify a partition by label or uuid respectively.
5832
5833    Anaconda may create partitions in any particular order, so it is safer to use labels than absolute partition names.
5834
5835    New in version Fedora3.
5836
5837--recommended
5838
5839    Determine the size of the partition automatically.
5840
5841    New in version Fedora3.
5842
5843--size SIZE
5844
5845    The minimum partition size in MiB. Specify an integer value here and do not append any units.
5846
5847    New in version Fedora3.
5848
5849--fsoptions FSOPTS
5850
5851    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
5852
5853    New in version Fedora4.
5854
5855--label LABEL
5856
5857    Specify the label to give to the filesystem to be made on the partition. If the given label is already in use by another filesystem, a new label will be created for this partition.
5858
5859    New in version Fedora4.
5860
5861--bytes-per-inode BYTES_PER_INODE
5862
5863    Specify the bytes/inode ratio.
5864
5865    New in version Fedora4.
5866
5867    Deprecated since version Fedora9.
5868
5869    Removed in version Fedora14.
5870
5871--fsprofile FSPROFILE
5872
5873    Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2/3/4, this configuration file is /etc/mke2fs.conf.
5874
5875    New in version Fedora9.
5876
5877--encrypted
5878
5879    Specify that this partition should be encrypted.
5880
5881    New in version Fedora9.
5882
5883--passphrase PASSPHRASE
5884
5885    Specify the passphrase to use when encrypting this partition. Without the above –encrypted option, this option does nothing. If no passphrase is specified, the default system-wide one is used, or the installer will stop and prompt if there is no default.
5886
5887    New in version Fedora9.
5888
5889--start START
5890
5891    New in version Fedora3.
5892
5893    Deprecated since version Fedora11.
5894
5895    Removed in version Fedora14.
5896
5897--end END
5898
5899    New in version Fedora3.
5900
5901    Deprecated since version Fedora11.
5902
5903    Removed in version Fedora14.
5904
5905--escrowcert <url>
5906
5907    Load an X.509 certificate from <url>. Store the data encryption key of this partition, encrypted using the certificate, as a file in /root. Only relevant if --encrypted is specified as well.
5908
5909    New in version Fedora12.
5910
5911--backuppassphrase
5912
5913    Only relevant if --escrowcert is specified as well. In addition to storing the data encryption key, generate a random passphrase and add it to this partition. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as a file in /root. If more than one LUKS volume uses --backuppassphrase, the same passphrase will be used for all such volumes.
5914
5915    New in version Fedora12.
5916
5917--resize
5918
5919    Attempt to resize this partition to the size given by --size=. This option must be used with --onpart --size=, or an error will be raised.
5920
5921    New in version Fedora17.
5922
5923--hibernation
5924
5925    This option can be used to automatically determine the size of the swap partition big enough for hibernation.
5926
5927    New in version Fedora18.
5928
5929--cipher CIPHER
5930
5931    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
5932
5933    New in version Fedora18.
5934
5935--mkfsoptions MKFSOPTS
5936
5937    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. This is similar to --fsprofile but works for all filesystems, not just the ones that support the profile concept. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
5938
5939    New in version Fedora23.
5940
5941--active
5942
5943    New in version Fedora3.
5944
5945    Deprecated since version Fedora29.
5946
5947--luks-version LUKS_VERSION
5948
5949    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
5950
5951    New in version Fedora29.
5952
5953--pbkdf PBKDF
5954
5955    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
5956
5957    New in version Fedora29.
5958
5959--pbkdf-memory PBKDF_MEMORY
5960
5961    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
5962
5963    New in version Fedora29.
5964
5965--pbkdf-time PBKDF_TIME
5966
5967    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
5968
5969    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
5970
5971    New in version Fedora29.
5972
5973--pbkdf-iterations PBKDF_ITERATIONS
5974
5975    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
5976
5977    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
5978
5979    New in version Fedora29.
5980
5981If partitioning fails for any reason, diagnostic messages will appear on virtual console 3.
5982raid
5983
5984raid --device DEVICE [--fstype FSTYPE] [--level LEVEL] [--noformat]
5985 [--spares SPARES] [--useexisting] [--fsoptions FSOPTS]
5986 [--fsprofile FSPROFILE] [--encrypted] [--passphrase PASSPHRASE]
5987 [--escrowcert <url>] [--backuppassphrase] [--label LABEL]
5988 [--cipher CIPHER] [--mkfsoptions MKFSOPTS] [--chunksize CHUNK_SIZE]
5989 [--luks-version LUKS_VERSION] [--pbkdf PBKDF]
5990 [--pbkdf-memory PBKDF_MEMORY] [--pbkdf-time PBKDF_TIME]
5991 [--pbkdf-iterations PBKDF_ITERATIONS]
5992 <mntpoint> [<partitions*> [<partitions*> ...]]
5993
5994New in version Fedora3.
5995
5996Assembles a software RAID device.
5997
5998positional arguments:
5999
6000<mntpoint>
6001
6002    Location where the RAID file system is mounted. If it is /, the RAID level must be 1 unless a boot partition (/boot) is present. If a boot partition is present, the /boot partition must be level 1 and the root (/) partition can be any of the available types.
6003
6004    New in version Fedora3.
6005
6006<partitions*>
6007
6008    The software raid partitions lists the RAID identifiers to add to the RAID array.
6009
6010    New in version Fedora3.
6011
6012optional arguments:
6013
6014--device DEVICE
6015
6016    Name of the RAID device to use (such as ‘fedora-root’ or ‘home’). As of Fedora 19, RAID devices are no longer referred to by names like ‘md0’. If you have an old (v0.90 metadata) array that you cannot assign a name to, you can specify the array by a filesystem label or UUID (eg: –device=LABEL=fedora-root).
6017
6018    New in version Fedora3.
6019
6020--fstype FSTYPE
6021
6022    Sets the file system type for the RAID array. Valid values include ext4, ext3, ext2, btrfs, swap, and vfat. Other filesystems may be valid depending on command line arguments passed to anaconda to enable other filesystems.
6023
6024    New in version Fedora3.
6025
6026    Changed in version RedHatEnterpriseLinux8.
6027
6028    Btrfs support was removed.
6029
6030--level LEVEL
6031
6032    RAID level to use {‘RAID6’, ‘RAID4’, ‘RAID1’, ‘RAID10’, ‘RAID0’, ‘RAID5’}.
6033
6034    New in version Fedora3.
6035
6036    Changed in version Fedora7.
6037
6038    The “RAID10” level was added.
6039
6040    Changed in version Fedora13.
6041
6042    The “RAID4” level was added.
6043
6044--noformat
6045
6046    Use an existing RAID device and do not format the RAID array.
6047
6048    New in version Fedora3.
6049
6050--spares SPARES
6051
6052    Specifies the number of spare drives allocated for the RAID array. Spare drives are used to rebuild the array in case of drive failure.
6053
6054    New in version Fedora3.
6055
6056--useexisting
6057
6058    Use an existing RAID device and reformat it.
6059
6060    New in version Fedora3.
6061
6062--fsoptions FSOPTS
6063
6064    Specifies a free form string of options to be used when mounting the filesystem. This string will be copied into the /etc/fstab file of the installed system and should be enclosed in quotes.
6065
6066    New in version Fedora4.
6067
6068--bytes-per-inode BYTES_PER_INODE
6069
6070    Specify the bytes/inode ratio.
6071
6072    New in version Fedora5.
6073
6074    Deprecated since version Fedora9.
6075
6076    Removed in version Fedora14.
6077
6078--fsprofile FSPROFILE
6079
6080    Specifies a usage type to be passed to the program that makes a filesystem on this partition. A usage type defines a variety of tuning parameters to be used when making a filesystem. For this option to work, the filesystem must support the concept of usage types and there must be a configuration file that lists valid types. For ext2/3/4, this configuration file is /etc/mke2fs.conf.
6081
6082    New in version Fedora9.
6083
6084--encrypted
6085
6086    Specify that this RAID device should be encrypted.
6087
6088    New in version Fedora9.
6089
6090--passphrase PASSPHRASE
6091
6092    Specify the passphrase to use when encrypting this RAID device. Without the above –encrypted option, this option does nothing. If no passphrase is specified, the default system-wide one is used, or the installer will stop and prompt if there is no default.
6093
6094    New in version Fedora9.
6095
6096--escrowcert <url>
6097
6098    Load an X.509 certificate from <url>. Store the data encryption key of this partition, encrypted using the certificate, as a file in /root. Only relevant if --encrypted is specified as well.
6099
6100    New in version Fedora12.
6101
6102--backuppassphrase
6103
6104    Only relevant if --escrowcert is specified as well. In addition to storing the data encryption key, generate a random passphrase and add it to this partition. Then store the passphrase, encrypted using the certificate specified by --escrowcert, as a file in /root. If more than one LUKS volume uses --backuppassphrase, the same passphrase will be used for all such volumes.
6105
6106    New in version Fedora12.
6107
6108--label LABEL
6109
6110    Specify the label to give to the filesystem to be made. If the given label is already in use by another filesystem, a new label will be created.
6111
6112    New in version Fedora15.
6113
6114--cipher CIPHER
6115
6116    Only relevant if --encrypted is specified. Specifies which encryption algorithm should be used to encrypt the filesystem.
6117
6118    New in version Fedora18.
6119
6120--mkfsoptions MKFSOPTS
6121
6122    Specifies additional parameters to be passed to the program that makes a filesystem on this partition. No processing is done on the list of arguments, so they must be supplied in a format that can be passed directly to the mkfs program. This means multiple options should be comma-separated or surrounded by double quotes, depending on the filesystem.
6123
6124    New in version Fedora23.
6125
6126--chunksize CHUNK_SIZE
6127
6128    Specify the chunk size (in KiB) for this RAID array.
6129
6130    New in version Fedora25.
6131
6132--luks-version LUKS_VERSION
6133
6134    Only relevant if --encrypted is specified. Specifies which version of LUKS format should be used to encrypt the filesystem.
6135
6136    New in version Fedora29.
6137
6138--pbkdf PBKDF
6139
6140    Only relevant if --encrypted is specified. Sets Password-Based Key Derivation Function (PBKDF) algorithm for LUKS keyslot. See man cryptsetup.
6141
6142    New in version Fedora29.
6143
6144--pbkdf-memory PBKDF_MEMORY
6145
6146    Only relevant if --encrypted is specified. Sets the memory cost for PBKDF. See man cryptsetup.
6147
6148    New in version Fedora29.
6149
6150--pbkdf-time PBKDF_TIME
6151
6152    Only relevant if --encrypted is specified. Sets the number of milliseconds to spend with PBKDF passphrase processing. See --iter-time in man cryptsetup.
6153
6154    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
6155
6156    New in version Fedora29.
6157
6158--pbkdf-iterations PBKDF_ITERATIONS
6159
6160    Only relevant if --encrypted is specified. Sets the number of iterations directly and avoids PBKDF benchmark. See --pbkdf-force-iterations in man cryptsetup.
6161
6162    Only one of --pbkdf-time and --pbkdf-iterations can be specified.
6163
6164    New in version Fedora29.
6165
6166The following example shows how to create a RAID level 1 partition for /, and a RAID level 5 for /usr, assuming there are three disks on the system. It also creates three swap partitions, one on each drive:
6167
6168part raid.01 --size=6000 --ondisk=sda
6169part raid.02 --size=6000 --ondisk=sdb
6170part raid.03 --size=6000 --ondisk=sdc
6171
6172part swap1 --size=512 --ondisk=sda
6173part swap2 --size=512 --ondisk=sdb
6174part swap3 --size=512 --ondisk=sdc
6175
6176part raid.11 --size=6000 --ondisk=sda
6177part raid.12 --size=6000 --ondisk=sdb
6178part raid.13 --size=6000 --ondisk=sdc
6179
6180raid / --level=1 --device=md0 raid.01 raid.02 raid.03
6181raid /usr --level=5 --device=md1 raid.11 raid.12 raid.13
6182
6183realm
6184
6185realm
6186
6187New in version Fedora19.
6188repo
6189
6190repo --name NAME [--baseurl BASEURL] [--mirrorlist MIRRORLIST] [--cost COST]
6191 [--excludepkgs EXCLUDEPKGS] [--includepkgs INCLUDEPKGS]
6192 [--ignoregroups IGNOREGROUPS] [--proxy PROXY] [--noverifyssl] [--install]
6193 [--metalink METALINK]
6194
6195New in version Fedora6.
6196
6197Configures additional yum repositories that may be used as sources for package installation. Multiple repo lines may be specified. By default, anaconda has a configured set of repos taken from /etc/anaconda.repos.d plus a special Installation Repo in the case of a media install. The exact set of repos in this directory changes from release to release and cannot be listed here. There will likely always be a repo named “updates”.
6198
6199Note: If you want to enable one of the repos in /etc/anaconda.repos.d that is disabled by default (like “updates”), you should use –name= but none of the other options. anaconda will look for a repo by this name automatically. Providing a baseurl or mirrorlist URL will result in anaconda attempting to add another repo by the same name, which will cause a conflicting repo error.
6200
6201optional arguments:
6202
6203--name NAME
6204
6205    The repo id. This option is required. The RepoId must not contain spaces (do not confuse with the optional name used by yum). If a repo has a name that conflicts with a previously added one, the new repo will be ignored. Because anaconda has a populated list of repos when it starts, this means that users cannot create new repos that override these names. Please check /etc/anaconda.repos.d from the operating system you wish to install to see what names are not available.
6206
6207    New in version Fedora6.
6208
6209--baseurl BASEURL
6210
6211    The URL for the repository. The variables that may be used in yum repo config files are not supported here. You may use one of either this option or --mirrorlist, not both. If an NFS repository is specified, it should be of the form nfs://host:/path/to/repo. Note that there is a colon after the host. Anaconda passes everything after “nfs:// ” directly to the mount command instead of parsing URLs according to RFC 2224. Variable substitution is done for $releasever and $basearch in the url.
6212
6213    New in version Fedora6.
6214
6215    Changed in version Fedora15.
6216
6217    --mirrorlist and --baseurl are not required anymore!
6218
6219    Changed in version Fedora27.
6220
6221    Another mutually exclusive option --metalink was added.
6222
6223--mirrorlist MIRRORLIST
6224
6225    The URL pointing at a list of mirrors for the repository. The variables that may be used in yum repo config files are not supported here. You may use one of either this option or --baseurl, not both. Variable substitution is done for $releasever and $basearch in the url.
6226
6227    New in version Fedora6.
6228
6229    Changed in version Fedora15.
6230
6231    --mirrorlist and --baseurl are not required anymore!
6232
6233    Changed in version Fedora27.
6234
6235    Another mutually exclusive option --metalink was added.
6236
6237--cost COST
6238
6239    An integer value to assign a cost to this repository. If multiple repositories provide the same packages, this number will be used to prioritize which repository will be used before another. Repositories with a lower cost take priority over repositories with higher cost.
6240
6241    New in version Fedora8.
6242
6243--excludepkgs EXCLUDEPKGS
6244
6245    A comma-separated list of package names and globs that must not be pulled from this repository. This is useful if multiple repositories provide the same package and you want to make sure it comes from a particular repository.
6246
6247    New in version Fedora8.
6248
6249--includepkgs INCLUDEPKGS
6250
6251    A comma-separated list of package names and globs that must be pulled from this repository. This is useful if multiple repositories provide the same package and you want to make sure it comes from this repository.
6252
6253    New in version Fedora8.
6254
6255--ignoregroups IGNOREGROUPS
6256
6257    This option is used when composing installation trees and has no effect on the installation process itself. It tells the compose tools to not look at the package group information when mirroring trees so as to avoid mirroring large amounts of unnecessary data.
6258
6259    New in version Fedora11.
6260
6261--proxy PROXY
6262
6263    Specify an HTTP/HTTPS/FTP proxy to use just for this repository. This setting does not affect any other repositories, nor how the install.img is fetched on HTTP installs. The various parts of the argument act like you would expect. The syntax is:
6264
6265    ``--proxy=[protocol://][username[:password]@]host[:port]``
6266
6267    New in version Fedora13.
6268
6269--noverifyssl
6270
6271    For a https repo do not check the server’s certificate with what well-known CA validate and do not check the server’s hostname matches the certificate’s domain name.
6272
6273    New in version Fedora14.
6274
6275--install
6276
6277    Install this repository to the target system so that it can be used after reboot.
6278
6279    New in version Fedora21.
6280
6281--metalink METALINK
6282
6283    The URL pointing at a metalink for the repository. The variables that may be used in yum repo config files are not supported here. You may use only one of the --baseurl, --mirrorlist, or --metalink options. Variable substitution is done for $releasever and $basearch in the url.
6284
6285    New in version Fedora27.
6286
6287reqpart
6288
6289reqpart [--add-boot]
6290
6291New in version Fedora23.
6292
6293Automatically create partitions required by your hardware platform. These include a /boot/efi for x86_64 and Aarch64 systems with UEFI firmware, biosboot for x86_64 systems with BIOS firmware and GPT, and PRePBoot for IBM Power Systems.
6294
6295Note: This command can not be used together with autopart, because autopart does the same and creates other partitions or logical volumes such as / and swap on top. In contrast with autopart, this command only creates platform-specific partitions and leaves the rest of the drive empty, allowing you to create a custom layout.
6296
6297optional arguments:
6298
6299--add-boot
6300
6301    Create a separate /boot partition in addition to the platform-specific partition created by the base command.
6302
6303    New in version Fedora23.
6304
6305rescue
6306
6307rescue [--nomount] [--romount]
6308
6309New in version Fedora10.
6310
6311Automatically enter the installer’s rescue mode. This gives you a chance to repair the system should something catastrophic happen.
6312
6313optional arguments:
6314
6315--nomount
6316
6317    Don’t mount the installed system.
6318
6319    New in version Fedora10.
6320
6321--romount
6322
6323    Mount the installed system in read-only mode.
6324
6325    New in version Fedora10.
6326
6327By default, the installer will find your system and mount it in read-write mode, telling you where it has performed this mount. You may optionally choose to not mount anything or mount in read-only mode. Only one of these two options may be given at any one time.
6328rootpw
6329
6330rootpw [--iscrypted] [--lock] [--plaintext] [<password>]
6331
6332New in version Fedora3.
6333
6334This required command sets the system’s root password.
6335
6336positional arguments:
6337
6338<password>
6339
6340    The desired root password.
6341
6342    New in version Fedora3.
6343
6344optional arguments:
6345
6346--iscrypted
6347
6348    If this is present, the password argument is assumed to already be encrypted. To create an encrypted password you can use python:
6349
6350    ``python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Salt"))'``
6351
6352    This will generate sha512 crypt of your password using your provided salt.
6353
6354    New in version Fedora3.
6355
6356--lock
6357
6358    If this is present, the root account is locked by default. That is, the root user will not be able to login from the console. When this option is present the <password> argument is not required.
6359
6360    New in version Fedora8.
6361
6362--plaintext
6363
6364    The password argument is assumed to not be encrypted. This is the default!
6365
6366    New in version Fedora8.
6367
6368selinux
6369
6370selinux [--disabled] [--enforcing] [--permissive]
6371
6372New in version Fedora3.
6373
6374Sets the state of SELinux on the installed system. SELinux defaults to enforcing in anaconda.
6375
6376optional arguments:
6377
6378--disabled
6379
6380    If this is present, SELinux is disabled.
6381
6382    New in version Fedora3.
6383
6384--enforcing
6385
6386    If this is present, SELinux is set to enforcing mode.
6387
6388    New in version Fedora3.
6389
6390--permissive
6391
6392    If this is present, SELinux is enabled, but only logs things that would be denied in enforcing mode.
6393
6394    New in version Fedora3.
6395
6396Only one of --disabled, --enabled or --permissive must be specified!
6397services
6398
6399services [--disabled <list>] [--enabled <list>]
6400
6401New in version Fedora6.
6402
6403Modifies the default set of services that will run under the default runlevel. The services listed in the disabled list will be disabled before the services listed in the enabled list are enabled.
6404
6405optional arguments:
6406
6407--disabled <list>
6408
6409    Disable the services given in the comma separated list.
6410
6411    New in version Fedora6.
6412
6413--enabled <list>
6414
6415    Enable the services given in the comma separated list.
6416
6417    New in version Fedora6.
6418
6419One of --disabled or --enabled must be provided.
6420skipx
6421
6422skipx
6423
6424New in version Fedora3.
6425
6426If present, X is not configured on the installed system.
6427snapshot
6428
6429snapshot --name <snapshot_name> --when <pre-install|post-install>
6430
6431New in version Fedora26.
6432
6433Create an LVM snapshot for devices on an LVM thin pool.
6434
6435optional arguments:
6436
6437--name <snapshot_name>
6438
6439    Name of the newly created snapshot.
6440
6441    New in version Fedora26.
6442
6443--when <pre-install|post-install>
6444
6445    You can specify two possible values: pre-install and post-install. When the pre-install value is used the snapshot is created before the installation but after the %pre section is run. When the post-install value is used the snapshot is created after the installation is done and after the %post section is run.
6446
6447    New in version Fedora26.
6448
6449sshkey
6450
6451sshkey --username <user> "ssh key"
6452
6453New in version Fedora22.
6454
6455This installs a ssh key to the authorized_keys file of the specified user on the installed system.
6456
6457positional arguments:
6458
6459"ssh key"
6460
6461    The content of the ssh key to install.
6462
6463    New in version Fedora22.
6464
6465optional arguments:
6466
6467--username <user>
6468
6469    User for which to install the specified key.
6470
6471    New in version Fedora22.
6472
6473Note that the key should be quoted, if it contains spaces and the user should exist (or be root) either via creation by a package install or the kickstart user command.
6474sshpw
6475
6476sshpw --username <name> [--iscrypted] [--plaintext] [--lock] [--sshkey]
6477  [<password> [<password> ...]]
6478
6479New in version Fedora13.
6480
6481The installer can start up ssh to provide for interactivity and inspection, just like it can with telnet. The “inst.sshd” option must be specified on the kernel command-line for Anaconda to start an ssh daemon. The sshpw command is used to control the accounts created in the installation environment that may be remotely logged into. For each instance of this command given, a user will be created. These users will not be created on the final system - they only exist for use while the installer is running.
6482
6483Note that by default, root has a blank password. If you don’t want any user to be able to ssh in and have full access to your hardware, you must specify sshpw for username root. Also note that if Anaconda fails to parse the kickstart file, it will allow anyone to login as root and have full access to your hardware.
6484
6485positional arguments:
6486
6487<password>
6488
6489    The password string to use.
6490
6491    New in version Fedora13.
6492
6493optional arguments:
6494
6495--username <name>
6496
6497    Provides the name of the user. This option is required.
6498
6499    New in version Fedora13.
6500
6501--iscrypted
6502
6503    If this is present, the password argument is assumed to already be encrypted.
6504
6505    New in version Fedora13.
6506
6507--plaintext
6508
6509    If this is present, the password argument is assumed to not be encrypted. This is the default.
6510
6511    New in version Fedora13.
6512
6513--lock
6514
6515    If this is present, the new user account is locked by default. That is, the user will not be able to login from the console.
6516
6517    New in version Fedora13.
6518
6519--sshkey
6520
6521    If this is used then the <password> string is interpreted as an ssh key value.
6522
6523    New in version Fedora24.
6524
6525syspurpose
6526
6527syspurpose [--role <role_name>] [--sla <sla_name>] [--usage <usage>]
6528       [--addon <layered product or feature>]
6529
6530New in version RedHatEnterpriseLinux8.
6531
6532The syspurpose command is used to describe how the system is intended to be used after the installation.
6533
6534This information then can be used to apply the correct subscription entitlement to the system.
6535
6536optional arguments:
6537
6538--role <role_name>
6539
6540    The intended role of the system.
6541
6542    New in version RedHatEnterpriseLinux8.
6543
6544--sla <sla_name>
6545
6546    Name of the sla intended for the system.
6547
6548    New in version RedHatEnterpriseLinux8.
6549
6550--usage <usage>
6551
6552    The intended usage of the system.
6553
6554    New in version RedHatEnterpriseLinux8.
6555
6556--addon <layered product or feature>
6557
6558    Any additional layered products or features. To add multiple items specify –addon multiple times, once per layered product/feature.
6559
6560    New in version RedHatEnterpriseLinux8.
6561
6562timezone
6563
6564timezone [--utc] [--nontp] [--ntpservers <server1>,<server2>,...,<serverN>]
6565     [<timezone> [<timezone> ...]]
6566
6567New in version Fedora3.
6568
6569This required command sets the system time zone to which may be any of the time zones listed by timeconfig.
6570
6571positional arguments:
6572
6573<timezone>
6574
6575    Timezone name, e.g. Europe/Sofia. This is optional but at least one of the options needs to be used if no timezone is specified.
6576
6577    New in version Fedora3.
6578
6579optional arguments:
6580
6581--utc, --isUtc
6582
6583    If present, the system assumes the hardware clock is set to UTC (Greenwich Mean) time.
6584
6585    To get the list of supported timezones, you can either run this script: http://vpodzime.fedorapeople.org/timezones_list.py or look at this list: http://vpodzime.fedorapeople.org/timezones_list.txt
6586
6587    New in version Fedora6.
6588
6589--nontp
6590
6591    Disable automatic starting of NTP service.
6592
6593    --nontp and --ntpservers are mutually exclusive.
6594
6595    New in version Fedora18.
6596
6597--ntpservers <server1>,<server2>,...,<serverN>
6598
6599    Specify a list of NTP servers to be used (comma-separated list with no spaces). The chrony package is automatically installed when this option is used. If you don’t want the package to be automatically installed then use -chrony in package selection. For example:
6600
6601    ``timezone --ntpservers=ntp.cesnet.cz,tik.nic.cz Europe/Prague``
6602
6603    New in version Fedora18.
6604
6605unsupported_hardware
6606
6607unsupported_hardware
6608
6609New in version RedHatEnterpriseLinux6.
6610updates
6611
6612updates [[URL] [[URL] ...]]
6613
6614New in version Fedora7.
6615
6616Specify the location of an updates.img for use in installation. See anaconda-release-notes.txt for a description of how to make an updates.img.
6617
6618positional arguments:
6619
6620[URL]
6621
6622    If present, the URL for an updates image.
6623
6624    If not present, anaconda will attempt to load from a floppy disk.
6625
6626    New in version Fedora7.
6627
6628install or upgrade
6629
6630install|upgrade [--root-device ROOT_DEVICE]
6631
6632New in version Fedora3.
6633
6634Install a fresh system or upgrade an existing system. Install is the default mode. For installation, you must specify the type of installation from one of cdrom, harddrive, nfs, or url (for ftp or http installations). The install command and the installation method command must be on separate lines.
6635
6636Deprecated since version Fedora20.
6637
6638Starting with F18, upgrades are no longer supported in anaconda and should be done with FedUp, the Fedora update tool. Starting with F21, the DNF system-upgrade plugin is recommended instead. Therefore, the upgrade command essentially does nothing.
6639
6640optional arguments:
6641
6642--root-device ROOT_DEVICE
6643
6644    On a system with multiple installs, this option specifies which filesystem holds the installation to be upgraded. This can be specified by device name, UUID=, or LABEL= just like the harddrive command may be.
6645
6646    New in version Fedora11.
6647
6648url
6649
6650url [--proxy URL] [--noverifyssl] [--url URL] [--mirrorlist URL]
6651[--metalink URL]
6652
6653New in version Fedora3.
6654
6655Install from an installation tree on a remote server via FTP or HTTP.
6656
6657optional arguments:
6658
6659--proxy URL
6660
6661    Specify an HTTP/HTTPS/FTP proxy to use while performing the install. The various parts of the argument act like you would expect. The syntax is:
6662
6663    [protocol://][username[:password]@]host[:port]
6664
6665    New in version Fedora13.
6666
6667--noverifyssl
6668
6669    For a tree on a HTTPS server do not check the server’s certificate with what well-known CA validate and do not check the server’s hostname matches the certificate’s domain name.
6670
6671    New in version Fedora14.
6672
6673--url URL
6674
6675    The URL to install from. Variable substitution is done for $releasever and $basearch in the url.
6676
6677    New in version Fedora3.
6678
6679    Changed in version Fedora18.
6680
6681    This parameter is no longer required because you could use --mirrorlist instead.
6682
6683--mirrorlist URL
6684
6685    The mirror URL to install from. Variable substitution is done for $releasever and $basearch in the url.
6686
6687    New in version Fedora18.
6688
6689--metalink URL
6690
6691    The metalink URL to install from. Variable substitution is done for $releasever and $basearch in the url.
6692
6693    New in version Fedora27.
6694
6695user
6696
6697user [--homedir HOMEDIR] [--iscrypted] --name NAME [--password PASSWORD]
6698 [--shell SHELL] [--uid INT] [--lock] [--plaintext] [--gecos GECOS]
6699 [--gid INT] [--groups GROUPS]
6700
6701New in version Fedora6.
6702
6703Creates a new user on the system.
6704
6705optional arguments:
6706
6707--homedir HOMEDIR
6708
6709    The home directory for the user. If not provided, this defaults to /home/.
6710
6711    New in version Fedora6.
6712
6713--iscrypted
6714
6715    If specified, consider the password provided by --password already encrypted. This is the default.
6716
6717    New in version Fedora6.
6718
6719--name NAME
6720
6721    Provides the name of the user. This option is required.
6722
6723    New in version Fedora6.
6724
6725--password PASSWORD
6726
6727    The new user’s password. If not provided, the account will be locked by default. If this is present, the password argument is assumed to already be encrypted. --plaintext has the opposite effect - the password argument is assumed to not be encrypted. To create an encrypted password you can use python:
6728
6729    ``python -c 'import crypt; print(crypt.crypt("My Password", "$6$My Sault"))'``
6730
6731    This will generate sha512 crypt of your password using your provided salt.
6732
6733    New in version Fedora6.
6734
6735--shell SHELL
6736
6737    The user’s login shell. If not provided, this defaults to the system default.
6738
6739    New in version Fedora6.
6740
6741--uid INT
6742
6743    The user’s UID. If not provided, this defaults to the next available non-system UID.
6744
6745    New in version Fedora6.
6746
6747--lock
6748
6749    If this is present, the new user account is locked by default. That is, the user will not be able to login from the console.
6750
6751    New in version Fedora8.
6752
6753--plaintext
6754
6755    If specified, consider the password provided by --password to be plain text.
6756
6757    New in version Fedora8.
6758
6759--gecos GECOS
6760
6761    Provides the GECOS information for the user. This is a string of various system-specific fields separated by a comma. It is frequently used to specify the user’s full name, office number, and the like. See man 5 passwd for more details.
6762
6763    New in version Fedora12.
6764
6765--gid INT
6766
6767    The GID of the user’s primary group. If not provided, this defaults to the next available non-system GID.
6768
6769    New in version Fedora19.
6770
6771--groups GROUPS
6772
6773    In addition to the default group, a comma separated list of group names the user should belong to. Any groups that do not already exist will be created. If the group already exists with a different GID, an error will be raised.
6774
6775    New in version Fedora6.
6776
6777    Changed in version Fedora24.
6778
6779    The group name can optionally be followed by a GID in parenthesis, for example, newgroup(5002).
6780
6781vnc
6782
6783vnc [--password PASSWORD] [--host HOST] [--port PORT]
6784
6785New in version Fedora3.
6786
6787Allows the graphical installation to be viewed remotely via VNC. This method is usually preferred over text mode, as there are some size and language limitations in text installs. With no options, this command will start a VNC server on the machine with no password and will print out the command that needs to be run to connect a remote machine.
6788
6789optional arguments:
6790
6791--password PASSWORD
6792
6793    Set a password which must be provided to connect to the VNC session. This is optional, but recommended.
6794
6795    New in version Fedora3.
6796
6797--connect host[:port]
6798
6799    Connect to a remote host instead of starting VNC server locally.
6800
6801    New in version Fedora3.
6802
6803    Changed in version Fedora6.
6804
6805    Added support for host[:port] syntax.
6806
6807    Removed in version Fedora9.
6808
6809--host HOST
6810
6811    Instead of starting a VNC server on the install machine, connect to the VNC viewer process listening on the given hostname.
6812
6813    New in version Fedora6.
6814
6815--port PORT
6816
6817    Provide a port that the remote VNC viewer process is listening on. If not provided, anaconda will use the VNC default.
6818
6819    New in version Fedora6.
6820
6821volgroup
6822
6823volgroup [--noformat] [--useexisting] [--reserved-space RESERVED_SPACE]
6824     [--reserved-percent RESERVED_PERCENT] [--pesize PESIZE]
6825     [<name> [<name> ...]] [<partitions*> [<partitions*> ...]]
6826
6827New in version Fedora3.
6828
6829Creates a Logical Volume Management (LVM) group.
6830
6831positional arguments:
6832
6833<name>
6834
6835    Name given to the volume group. The (which denotes that multiple partitions can be listed) lists the identifiers to add to the volume group.
6836
6837    New in version Fedora3.
6838
6839<partitions*>
6840
6841    Physical Volume partitions to be included in this Volume Group
6842
6843    New in version Fedora3.
6844
6845optional arguments:
6846
6847--noformat
6848
6849    Use an existing volume group. Do not specify partitions when using this option.
6850
6851    New in version Fedora3.
6852
6853--useexisting
6854
6855    Use an existing volume group. Do not specify partitions when using this option.
6856
6857    New in version Fedora3.
6858
6859--reserved-space RESERVED_SPACE
6860
6861    Specify an amount of space to leave unused in a volume group, in MiB. Do not append any units. This option is only used for new volume groups.
6862
6863    New in version Fedora16.
6864
6865--reserved-percent RESERVED_PERCENT
6866
6867    Specify a percentage of total volume group space to leave unused (new volume groups only).
6868
6869    New in version Fedora16.
6870
6871--pesize PESIZE
6872
6873    Set the size of the physical extents in KiB.
6874
6875    New in version Fedora3.
6876
6877    Changed in version Fedora21.
6878
6879    Set the size of the physical extents in KiB.
6880
6881Create the partition first, create the logical volume group, and then create the logical volume. For example:
6882
6883part pv.01 --size 3000
6884volgroup myvg pv.01
6885logvol / --vgname=myvg --size=2000 --name=rootvol
6886
6887xconfig
6888
6889xconfig [--defaultdesktop GNOME|KDE] [--startxonboot]
6890
6891New in version Fedora3.
6892
6893Configures the X Window System. If this option is not given, Anaconda will use X and attempt to automatically configure. Please try this before manually configuring your system.
6894
6895optional arguments:
6896
6897--defaultdesktop GNOME|KDE
6898
6899    Specify either GNOME or KDE to set the default desktop (assumes that GNOME Desktop Environment and/or KDE Desktop Environment has been installed through %packages).
6900
6901    New in version Fedora3.
6902
6903--server SERVER
6904
6905    New in version Fedora3.
6906
6907    Removed in version Fedora6.
6908
6909--startxonboot
6910
6911    Use a graphical login on the installed system.
6912
6913    New in version Fedora3.
6914
6915--card CARD
6916
6917    New in version Fedora3.
6918
6919    Deprecated since version Fedora6.
6920
6921    Removed in version Fedora9.
6922
6923--hsync HSYNC
6924
6925    New in version Fedora3.
6926
6927    Deprecated since version Fedora6.
6928
6929    Removed in version Fedora9.
6930
6931--monitor MONITOR
6932
6933    New in version Fedora3.
6934
6935    Deprecated since version Fedora6.
6936
6937    Removed in version Fedora9.
6938
6939--noprobe NOPROBE
6940
6941    New in version Fedora3.
6942
6943    Deprecated since version Fedora6.
6944
6945    Removed in version Fedora9.
6946
6947--vsync VSYNC
6948
6949    New in version Fedora3.
6950
6951    Deprecated since version Fedora6.
6952
6953    Removed in version Fedora9.
6954
6955--driver DRIVER
6956
6957    New in version Fedora6.
6958
6959    Deprecated since version Fedora10.
6960
6961    Removed in version Fedora14.
6962
6963--depth DEPTH
6964
6965    New in version Fedora3.
6966
6967    Deprecated since version Fedora10.
6968
6969    Removed in version Fedora14.
6970
6971--resolution RESOLUTION
6972
6973    New in version Fedora3.
6974
6975    Deprecated since version Fedora10.
6976
6977    Removed in version Fedora14.
6978
6979--videoram VIDEORAM
6980
6981    New in version Fedora3.
6982
6983    Deprecated since version Fedora10.
6984
6985    Removed in version Fedora14.
6986
6987zerombr
6988
6989zerombr
6990
6991New in version Fedora3.
6992
6993If zerombr is specified, any disks whose formatting is unrecognized are initialized. This will destroy all of the contents of disks with invalid partition tables or other formatting unrecognizable to the installer. It is useful so that the installation program does not ask if it should initialize the disk label if installing to a brand new hard drive.
6994zfcp
6995
6996zfcp --devnum DEVNUM --fcplun FCPLUN --wwpn WWPN
6997
6998New in version Fedora3.
6999
7000optional arguments:
7001
7002--devnum DEVNUM
7003
7004    New in version Fedora3.
7005
7006--fcplun FCPLUN
7007
7008    New in version Fedora3.
7009
7010--wwpn WWPN
7011
7012    New in version Fedora3.
7013
7014--scsiid SCSIID
7015
7016    New in version Fedora3.
7017
7018    Deprecated since version Fedora12.
7019
7020    Removed in version Fedora14.
7021
7022--scsilun SCSILUN
7023
7024    New in version Fedora3.
7025
7026    Deprecated since version Fedora12.
7027
7028    Removed in version Fedora14.
7029
7030%include
7031
7032Use the %include /path/to/file or %include <url> command to include the contents of another file in the kickstart file as though the contents were at the location of the %include command in the kickstart file.
7033%ksappend
7034
7035The %ksappend url directive is very similar to %include in that it is used to include the contents of additional files as though they were at the location of the %ksappend directive. The difference is in when the two directives are processed. %ksappend is processed in an initial pass, before any other part of the kickstart file. Then, this expanded kickstart file is passed to the rest of anaconda where all %pre scripts are handled, and then finally the rest of the kickstart file is processed in order, which includes %include directives.
7036
7037Thus, %ksappend provides a way to include a file containing %pre scripts, while %include does not.
7038Chapter 4. Pre-installation script
7039
7040%pre [--erroronfail] [--interpreter /usr/bin/python] [--log LOG]
7041
7042You can add commands to run on the system immediately after the ks.cfg has been parsed and the lang, keyboard, and url options have been processed. This section must be at the end of the kickstart file (after the commands) and must start with the %pre command. You can access the network in the %pre section; however, name service has not been configured at this point, so only IP addresses will work.
7043
7044Preinstallation scripts are required to be closed with %end.
7045
7046If your script spawns a daemon process, you must make sure to close stdout and stderr. Doing so is standard procedure for creating daemons. If you do not close these file descriptors, the installation will appear hung as anaconda waits for an EOF from the script.
7047
7048Note
7049
7050The pre-install script is not run in the chroot environment.
7051
7052optional arguments:
7053
7054--erroronfail
7055
7056    If the error script fails, this option will cause an error dialog to be displayed and will halt installation. The error message will direct you to where the cause of the failure is logged.
7057
7058    New in version Fedora4.
7059
7060--interpreter /usr/bin/python
7061
7062    Allows you to specify a different scripting language, such as Python. Replace /usr/bin/python with the scripting language of your choice.
7063
7064    New in version Fedora4.
7065
7066--log LOG, --logfile LOG
7067
7068    Log all messages from the script to the given log file.
7069
7070    New in version Fedora4.
7071
7072Example
7073
7074Here is an example %pre section:
7075
7076%pre
7077#!/bin/bash
7078hds=""
7079mymedia=""
7080
7081for file in /sys/block/sd*; do
7082hds="$hds $(basename $file)"
7083done
7084
7085set $hds
7086numhd=$(echo $#)
7087
7088drive1=$(echo $hds | cut -d' ' -f1)
7089drive2=$(echo $hds | cut -d' ' -f2)
7090
7091if [ $numhd == "2" ]  ; then
7092    echo "#partitioning scheme generated in %pre for 2 drives" > /tmp/part-include
7093    echo "clearpart --all" >> /tmp/part-include
7094    echo "part /boot --fstype ext4 --size 512 --ondisk sda" >> /tmp/part-include
7095    echo "part / --fstype ext4 --size 10000 --grow --ondisk sda" >> /tmp/part-include
7096    echo "part swap --recommended --ondisk $drive1" >> /tmp/part-include
7097    echo "part /home --fstype ext4 --size 10000 --grow --ondisk sdb" >> /tmp/part-include
7098else
7099    echo "#partitioning scheme generated in %pre for 1 drive" > /tmp/part-include
7100    echo "clearpart --all" >> /tmp/part-include
7101    echo "part /boot --fstype ext4 --size 521" >> /tmp/part-include
7102    echo "part swap --recommended" >> /tmp/part-include
7103    echo "part / --fstype ext4 --size 2048" >> /tmp/part-include
7104    echo "part /home --fstype ext4 --size 2048 --grow" >> /tmp/part-include
7105fi
7106%end
7107
7108This script determines the number of hard drives in the system and writes a text file with a different partitioning scheme depending on whether it has one or two drives. Instead of having a set of partitioning commands in the kickstart file, include the line:
7109
7110%include /tmp/part-include
7111
7112The partitioning commands selected in the script will be used.
7113Chapter 5. Package Selection
7114
7115%packages [--excludedocs] [--ignoremissing] [--nobase] [--nocore]
7116      [--ignoredeps] [--resolvedeps] [--default] [--instLangs INSTLANGS]
7117      [--multilib] [--excludeWeakdeps] [--timeout TIMEOUT]
7118      [--retries RETRIES]
7119
7120Use the %packages command to begin a kickstart file section that lists the packages you would like to install.
7121
7122Packages can be specified by group or by individual package name. The installation program defines several groups that contain related packages. Refer to the repodata/*comps*.xml file on the first CD-ROM for a list of groups. Each group has an id, user visibility value, name, description, and package list. In the package list, the packages marked as mandatory are always installed if the group is selected, the packages marked default are selected by default if the group is selected, and the packages marked optional must be specifically selected even if the group is selected to be installed.
7123
7124In most cases, it is only necessary to list the desired groups and not individual packages. Note that the Core group is always selected by default, so it is not necessary to specify it in the %packages section.
7125
7126The %packages section is required to be closed with %end. Also, multiple %packages sections may be given. This may be handy if the kickstart file is used as a template and pulls in various other files with the %include mechanism.
7127
7128Here is an example %packages selection:
7129
7130%packages
7131@X Window System
7132@GNOME Desktop Environment
7133@Graphical Internet
7134@Sound and Video
7135dhcp
7136%end
7137
7138As you can see, groups are specified, one to a line, starting with an @ symbol followed by the full group name as given in the comps.xml file. Groups can also be specified using the id for the group, such as gnome-desktop. Specify individual packages with no additional characters (the dhcp line in the example above is an individual package).
7139
7140The @ prefix is also used to request installation of module streams in the following format:
7141
7142@<module name>:<stream name>/<profile name>
7143
7144Profile name is optional and multiple profiles can be installed by using multiple lines, one per profile. Stream name is only optional only if the given module has a default stream.
7145
7146If there are a module and a group named the same, and no stream name and profile are specified, module will be selected instead of a group.
7147
7148Requesting one module more than once with different streams or not specifying a stream name for a module without a default stream will result in an error.
7149
7150Here is an example %packages selection with modules:
7151
7152%packages
7153@^Fedora Server Edition
7154@nodejs:10
7155@django:1.6
7156@postgresql:9.6/server
7157@mariadb:10.1/server
7158@mysql:5.7/default
7159@scala:2.10/default
7160@gimp:2.10/devel
7161vim
7162%end
7163
7164You can also specify environments using the @^ prefix followed by full environment name as given in the comps.xml file. If multiple environments are specified, only the last one specified will be used. Environments can be mixed with both group specifications (even if the given group is not part of the specified environment) and package specifications.
7165
7166Here is an example of requesting the GNOME Desktop environment to be selected for installation:
7167
7168%packages
7169@^gnome-desktop-environment
7170%end
7171
7172Additionally, individual packages may be specified using globs. For instance:
7173
7174%packages
7175vim*
7176kde-i18n-*
7177%end
7178
7179This would install all packages whose names start with “vim” or “kde-i18n-“.
7180
7181You can also specify which packages or groups not to install from the default package list:
7182
7183%packages
7184-autofs
7185-@Sound and Video
7186%end
7187
7188optional arguments:
7189
7190--excludedocs
7191
7192    Do not install any of the documentation from any packages. For the most part, this means files in /usr/share/doc* will not get installed though it could mean other files as well, depending on how the package was built.
7193
7194    New in version Fedora4.
7195
7196--ignoremissing
7197
7198    Ignore any packages or groups specified in the packages section that are not found in any configured repository. The default behavior is to halt the installation and ask the user if the installation should be aborted or continued. This option allows fully automated installation even in the error case.
7199
7200    New in version Fedora4.
7201
7202--nobase
7203
7204    Do not install the @base group (installed by default, otherwise).
7205
7206    New in version Fedora18.
7207
7208    Deprecated since version Fedora18.
7209
7210--nocore
7211
7212    Do not install the @core group (installed by default, otherwise).
7213
7214    Omitting the core group can produce a system that is not bootable or that cannot finish the install. Use with caution.
7215
7216    New in version Fedora21.
7217
7218--ignoredeps
7219
7220    New in version Fedora4.
7221
7222    Deprecated since version Fedora4.
7223
7224--resolvedeps
7225
7226    New in version Fedora4.
7227
7228    Deprecated since version Fedora4.
7229
7230--default
7231
7232    Install the default package set. This corresponds to the package set that would be installed if no other selections were made on the package customization screen during an interactive install.
7233
7234    New in version Fedora7.
7235
7236--instLangs INSTLANGS
7237
7238    Specify the list of languages that should be installed. This is different from the package group level selections, though. This option does not specify what package groups should be installed. Instead, it controls which translation files from individual packages should be installed by setting RPM macros.
7239
7240    New in version Fedora9.
7241
7242--multilib
7243
7244    Enable yum’s “all” multilib_policy as opposed to the default of “best”.
7245
7246    New in version Fedora18.
7247
7248--excludeWeakdeps
7249
7250    Do not install packages from weak dependencies. These are packages linked to the selected package set by Recommends and Supplements flags. By default weak dependencies will be installed.
7251
7252    New in version Fedora24.
7253
7254--timeout TIMEOUT
7255
7256    Set up yum’s or dnf’s timeout. It is a number of seconds to wait for a connection before timing out.
7257
7258    New in version RedHatEnterpriseLinux7.
7259
7260--retries RETRIES
7261
7262    Set up yum’s or dnf’s retries. It is a number of times any attempt to retrieve a file should retry before returning an error.
7263
7264    New in version RedHatEnterpriseLinux7.
7265
7266Group-level options
7267
7268In addition, group lines in the %packages section can take the following options:
7269
7270--nodefaults
7271
7272    Only install the group’s mandatory packages, not the default selections.
7273
7274--optional
7275
7276    In addition to the mandatory and default packages, also install the optional packages. This means all packages in the group will be installed.
7277
7278Chapter 6. Post-installation Script
7279
7280%post [--erroronfail] [--interpreter /usr/bin/python] [--log LOG] [--nochroot]
7281
7282You have the option of adding commands to run on the system once the installation is complete. This section must be at the end of the kickstart file and must start with the %post command. This section is useful for functions such as installing additional software and configuring an additional nameserver.
7283
7284You may have more than one %post section, which can be useful for cases where some post-installation scripts need to be run in the chroot and others that need access outside the chroot.
7285
7286Each %post section is required to be closed with a corresponding %end.
7287
7288If you configured the network with static IP information, including a nameserver, you can access the network and resolve IP addresses in the %post section. If you configured the network for DHCP, the /etc/resolv.conf file has not been completed when the installation executes the %post section. You can access the network, but you can not resolve IP addresses. Thus, if you are using DHCP, you must specify IP addresses in the %post section.
7289
7290If your script spawns a daemon process, you must make sure to close stdout and stderr. Doing so is standard procedure for creating daemons. If you do not close these file descriptors, the installation will appear hung as anaconda waits for an EOF from the script.
7291
7292The post-install script is run in a chroot environment; therefore, performing tasks such as copying scripts or RPMs from the installation media will not work.
7293
7294optional arguments:
7295
7296--erroronfail
7297
7298    If the error script fails, this option will cause an error dialog to be displayed and will halt installation. The error message will direct you to where the cause of the failure is logged.
7299
7300    New in version Fedora4.
7301
7302--interpreter /usr/bin/python
7303
7304    Allows you to specify a different scripting language, such as Python. Replace /usr/bin/python with the scripting language of your choice.
7305
7306    New in version Fedora4.
7307
7308--log LOG, --logfile LOG
7309
7310    Log all messages from the script to the given log file.
7311
7312    New in version Fedora4.
7313
7314--nochroot
7315
7316    Allows you to specify commands that you would like to run outside of the chroot environment.
7317
7318    New in version Fedora4.
7319
7320Examples
7321
7322Run a script named runme from an NFS share:
7323
7324%post
7325mkdir /mnt/temp
7326mount 10.10.0.2:/usr/new-machines /mnt/temp
7327open -s -w -- /mnt/temp/runme
7328umount /mnt/temp
7329%end
7330
7331Copy the file /etc/resolv.conf to the file system that was just installed:
7332
7333%post --nochroot
7334cp /etc/resolv.conf /mnt/sysimage/etc/resolv.conf
7335%end
7336
7337If your kickstart is being interpreted by the livecd-creator tool, you should replace /mnt/sysimage above with $INSTALL_ROOT.
7338Chapter 7. Handling Errors
7339
7340%onerror [--erroronfail] [--interpreter /usr/bin/python] [--log LOG]
7341
7342These scripts run when the installer hits a fatal error, but not necessarily a bug in the installer. Some examples of these situations include errors in packages that have been requested to be installed, failures when starting VNC when requested, and error when scanning storage. When these situations happen, installaton cannot continue. The installer will run all %onerror scripts in the order they are provided in the kickstart file.
7343
7344In addition, %onerror scripts will be run on a traceback as well. To be exact, all %onerror scripts will be run and then all %traceback scripts will be run afterwards.
7345
7346Each %onerror script is required to be closed with a corresponding %end.
7347
7348Note
7349
7350These scripts could potentially run at any stage in installation - early on, between making filesystems and installing packages, before the bootloader is installed, when attempting to reboot, and so on. For this reason, these scripts cannot be run in the chroot environment and you should not trust anything in the installed system. These scripts are primarily for testing and error reporting purposes.
7351
7352optional arguments:
7353
7354--erroronfail
7355
7356    If the error script fails, this option will cause an error dialog to be displayed and will halt installation. The error message will direct you to where the cause of the failure is logged.
7357
7358    New in version Fedora4.
7359
7360--interpreter /usr/bin/python
7361
7362    Allows you to specify a different scripting language, such as Python. Replace /usr/bin/python with the scripting language of your choice.
7363
7364    New in version Fedora4.
7365
7366--log LOG, --logfile LOG
7367
7368    Log all messages from the script to the given log file.
7369
7370    New in version Fedora4.
7371
7372Chapter 8. Handling Tracebacks
7373
7374%traceback [--erroronfail] [--interpreter /usr/bin/python] [--log LOG]
7375
7376These scripts run when the installer hits an internal error (a traceback, as they are called in Python) and cannot continue. When this situation happens, the installer will display an error dialog to the screen that prompts the user to file a bug or reboot. At the same time, it will run all %traceback scripts in the order they are provided in the kickstart file.
7377
7378Each %traceback script is required to be closed with a corresponding %end.
7379
7380Note
7381
7382These scripts could potentially run at any stage in installation - early on, between making filesystems and installing packages, before the bootloader is installed, when attempting to reboot, and so on. For this reason, these scripts cannot be run in the chroot environment and you should not trust anything in the installed system. These scripts are primarily for testing and error reporting purposes.
7383
7384optional arguments:
7385
7386--erroronfail
7387
7388    If the error script fails, this option will cause an error dialog to be displayed and will halt installation. The error message will direct you to where the cause of the failure is logged.
7389
7390    New in version Fedora4.
7391
7392--interpreter /usr/bin/python
7393
7394    Allows you to specify a different scripting language, such as Python. Replace /usr/bin/python with the scripting language of your choice.
7395
7396    New in version Fedora4.
7397
7398--log LOG, --logfile LOG
7399
7400    Log all messages from the script to the given log file.
7401
7402    New in version Fedora4.
7403
7404Chapter 9. Pre-install Script
7405
7406%pre-install [--erroronfail] [--interpreter /usr/bin/python] [--log LOG]
7407
7408You can use the %pre-install section to run commands after the system has been partitioned, filesystems created, and everything is mounted under /mnt/sysimage Like %pre these scripts do not run in the chrooted environment.
7409
7410Each %pre-install section is required to be closed with a corresponding %end.
7411
7412optional arguments:
7413
7414--erroronfail
7415
7416    If the error script fails, this option will cause an error dialog to be displayed and will halt installation. The error message will direct you to where the cause of the failure is logged.
7417
7418    New in version Fedora4.
7419
7420--interpreter /usr/bin/python
7421
7422    Allows you to specify a different scripting language, such as Python. Replace /usr/bin/python with the scripting language of your choice.
7423
7424    New in version Fedora4.
7425
7426--log LOG, --logfile LOG
7427
7428    Log all messages from the script to the given log file.
7429
7430    New in version Fedora4.
7431
7432Chapter 10. Making the Kickstart File Available
7433
7434A kickstart file must be placed in one of the following locations:
7435
7436    On a boot diskette
7437    On a boot CD-ROM
7438    On a network
7439
7440Normally a kickstart file is copied to the boot diskette, or made available on the network. The network-based approach is most commonly used, as most kickstart installations tend to be performed on networked computers.
7441
7442Let us take a more in-depth look at where the kickstart file may be placed.
7443Creating a Kickstart Boot Diskette
7444
7445To perform a diskette-based kickstart installation, the kickstart file must be named ks.cfg and must be located in the boot diskette’s top-level directory. Refer to the section Making an Installation Boot Diskette in the Red Hat Enterprise Linux Installation Guide for instruction on creating a boot diskette. Because the boot diskettes are in MS-DOS format, it is easy to copy the kickstart file under Linux using the mcopy command:
7446
7447mcopy ks.cfg a:
7448
7449Alternatively, you can use Windows to copy the file. You can also mount the MS-DOS boot diskette in Linux with the file system type vfat and use the cp command to copy the file on the diskette.
7450Creating a Kickstart Boot CD-ROM
7451
7452To perform a CD-ROM-based kickstart installation, the kickstart file must be named ks.cfg and must be located in the boot CD-ROM’s top-level directory. Since a CD-ROM is read-only, the file must be added to the directory used to create the image that is written to the CD-ROM. Refer to the Making an Installation Boot CD-ROM section in the Red Hat Enterprise Linux Installation Guide for instruction on creating a boot CD-ROM; however, before making the file.iso image file, copy the ks.cfg kickstart file to the isolinux/ directory.
7453Making the Kickstart File Available on the Network
7454
7455Network installations using kickstart are quite common, because system administrators can easily automate the installation on many networked computers quickly and painlessly. In general, the approach most commonly used is for the administrator to have both a BOOTP/DHCP server and an NFS server on the local network. The BOOTP/DHCP server is used to give the client system its networking information, while the actual files used during the installation are served by the NFS server. Often, these two servers run on the same physical machine, but they are not required to.
7456
7457To perform a network-based kickstart installation, you must have a BOOTP/DHCP server on your network, and it must include configuration information for the machine on which you are attempting to install Fedora or Red Hat Enterprise Linux. The BOOTP/DHCP server will provide the client with its networking information as well as the location of the kickstart file.
7458
7459If a kickstart file is specified by the BOOTP/DHCP server, the client system will attempt an NFS mount of the file’s path, and will copy the specified file to the client, using it as the kickstart file. The exact settings required vary depending on the BOOTP/DHCP server you use.
7460
7461Here is an example of a line from the dhcpd.conf file for the DHCP server:
7462
7463filename "/usr/new-machine/kickstart/";
7464server-name "blarg.redhat.com";
7465
7466Note that you should replace the value after filename with the name of the kickstart file (or the directory in which the kickstart file resides) and the value after server-name with the NFS server name.
7467
7468If the filename returned by the BOOTP/DHCP server ends with a slash (“/”), then it is interpreted as a path only. In this case, the client system mounts that path using NFS, and searches for a particular file. The filename the client searches for is:
7469
7470::
7471    <ip-addr>-kickstart
7472
7473The section of the filename should be replaced with the client’s IP address in dotted decimal notation. For example, the filename for a computer with an IP address of 10.10.0.1 would be 10.10.0.1-kickstart.
7474
7475Note that if you do not specify a server name, then the client system will attempt to use the server that answered the BOOTP/DHCP request as its NFS server. If you do not specify a path or filename, the client system will try to mount /kickstart from the BOOTP/DHCP server and will try to find the kickstart file using the same -kickstart filename as described above.
7476HTTP Headers
7477
7478When Anaconda requests the kickstart over the network it includes several custom HTTP headers:
7479
7480X-Anaconda-Architecture: x86_64 indicates the architecture of the system being installed to.
7481
7482X-Anaconda-System-Release: Fedora indicates the product name being installed.
7483
7484There are also 2 optional headers, controlled by the kernel command line options inst.ks.sendmac and inst.ks.sendsn
7485
7486Prior to Fedora 17 and Red Hat Enterprise Linux 7, these options were named kssendmac and kssendsn.
7487Chapter 11. Making the Installation Tree Available
7488
7489The kickstart installation needs to access an installation tree. An installation tree is a copy of the binary Fedora or Red Hat Enterprise Linux CD-ROMs with the same directory structure.
7490
7491If you are performing a CD-based installation, insert the Fedora or Red Hat Enterprise Linux CD-ROM #1 into the computer before starting the kickstart installation.
7492
7493If you are performing a hard-drive installation, make sure the ISO images of the binary Fedora or Red Hat Enterprise Linux CD-ROMs are on a hard drive in the computer.
7494
7495If you are performing a network-based (NFS, FTP, or HTTP) installation, you must make the installation tree available over the network. Refer to the Preparing for a Network Installation section of the Red Hat Enterprise Linux Installation Guide for details.
7496Chapter 12. Starting a Kickstart Installation
7497
7498To begin a kickstart installation, you must boot the system from a Fedora or Red Hat Enterprise Linux boot diskette, Fedora or Red Hat Enterprise Linux boot CD-ROM, or the Fedora or Red Hat Enterprise Linux CD-ROM #1 and enter a special boot command at the boot prompt. In order to get to the boot prompt you must hit escape at the CD or DVD boot menu. In case you don’t know what I’m talking about I took a screenshot. The installation program looks for a kickstart file if the ks command line argument is passed to the kernel.
7499
7500https://fedoraproject.org/wiki/File:Fedora_boot_screen.png
7501
7502Prior to Fedora 17 and Red Hat Enterprise Linux 7, all the various forms of the inst.ks= parameter were simply named ks=.
7503Boot Diskette
7504
7505If the kickstart file is located on a boot diskette as described in the Section called Creating a Kickstart Boot Diskette in Chapter 6, boot the system with the diskette in the drive, and enter the following command at the boot: prompt:
7506
7507linux inst.ks=floppy
7508CD-ROM #1 and Diskette
7509
7510The linux inst.ks=floppy command also works if the ks.cfg file is located on a vfat or ext2 file system on a diskette and you boot from the Fedora or Red Hat Enterprise Linux CD-ROM #1.
7511
7512An alternate boot command is to boot off the Fedora or Red Hat Enterprise Linux CD-ROM #1 and have the kickstart file on a vfat or ext2 file system on a diskette. To do so, enter the following command at the boot: prompt:
7513
7514linux inst.ks=hd:fd0:/ks.cfg
7515With Driver Disk
7516
7517If you need to use a driver disk with kickstart, specify the dd option as well. For example, to boot off a boot diskette and use a driver disk, enter the following command at the boot: prompt:
7518
7519linux inst.ks=floppy dd
7520Boot CD-ROM
7521
7522If the kickstart file is on a boot CD-ROM as described in the Section called Creating a Kickstart Boot CD-ROM in Chapter 6, insert the CD-ROM into the system, boot the system, and enter the following command at the boot: prompt (where ks.cfg is the name of the kickstart file):
7523
7524linux inst.ks=cdrom:<device>:/ks.cfg
7525Other kickstart options
7526
7527inst.ks=nfs:<server>:/<path>
7528
7529    The installation program will look for the kickstart file on the NFS server , as file . The installation program will use DHCP to configure the Ethernet card. For example, if your NFS server is server.example.com and the kickstart file is in the NFS share /mydir/ks.cfg, the correct boot command would be inst.ks=nfs:server.example.com:/mydir/ks.cfg.
7530
7531inst.ks=http://<server>/<path>
7532
7533    The installation program will look for the kickstart file on the HTTP server , as file . The installation program will use DHCP to configure the Ethernet card. For example, if your HTTP server is server.example.com and the kickstart file is in the HTTP directory /mydir/ks.cfg, the correct boot command would be inst.ks=http://server.example.com/mydir/ks.cfg.
7534
7535inst.ks=floppy
7536
7537    The installation program looks for the file ks.cfg on a vfat or ext2 file system on the diskette in /dev/fd0.
7538
7539inst.ks=floppy:/<path>
7540
7541    The installation program will look for the kickstart file on the diskette in /dev/fd0, as file .
7542
7543inst.ks=hd:<device>:/<file>
7544
7545    The installation program will mount the file system on (which must be vfat or ext2), and look for the kickstart configuration file as in that file system (for example, inst.ks=hd:sda3:/mydir/ks.cfg).
7546
7547inst.ks=bd:<biosdev>:/<path>
7548
7549    The installation program will mount the file system on the specified partition on the specified BIOS device (for example, inst.ks=bd:80p3:/mydir/ks.cfg). Note this does not work for BIOS RAID sets.
7550
7551inst.ks=file:/<file>
7552
7553    The installation program will try to read the file from the file system; no mounts will be done. This is normally used if the kickstart file is already on the initrd image.
7554
7555inst.ks=cdrom:/<path> or in newer versions inst.ks=cdrom:<cdrom device>:/<path>
7556
7557    The installation program will look for the kickstart file on CD-ROM, as file .
7558
7559inst.ks
7560
7561    If ks is used alone, the installation program will configure the Ethernet card to use DHCP. The kickstart file is read from the “bootServer” from the DHCP response as if it is an NFS server sharing the kickstart file. By default, the bootServer is the same as the DHCP server. The name of the kickstart file is one of the following:
7562
7563        If DHCP is specified and the bootfile begins with a /, the bootfile provided by DHCP is looked for on the NFS server.
7564        If DHCP is specified and the bootfile begins with something other then a /, the bootfile provided by DHCP is looked for in the /kickstart directory on the NFS server.
7565        If DHCP did not specify a bootfile, then the installation program tries to read the file /kickstart/1.2.3.4-kickstart, where 1.2.3.4 is the numeric IP address of the machine being installed.
7566
7567inst.ks.device=<device>
7568
7569    The installation program will use this network device to connect to the network. For example, to start a kickstart installation with the kickstart file on an NFS server that is connected to the system through the eth1 device, use the command inst.ks=nfs:<server>:/<path> ksdevice=eth1 at the boot: prompt. For more information, see anaconda boot options.
7570
7571    Prior to Fedora 17 and Red Hat Enterprise Linux 7, this option was named ksdevice=.
7572
7573Example Kickstart Script
7574
7575Since I got tons of errors I thought I would share an example of a kickstart script that works. This also has an example of an lvm setup. I couldn’t find a good example of an lvm anywhere else. I also added comments where I thought would help. Please modify if you think you have some other good examples.
7576
7577# Kickstart file automatically generated by anaconda.
7578
7579#version=DEVEL
7580#url --url http://mirrors.kernel.org/fedora/releases/7/Fedora/i386/os
7581#inst.ks=http://127.0.0.1/ks.cfg
7582#inst.ks=http://localhost/ks.cfg
7583url --url http://ftp.usf.edu/pub/fedora/linux/releases/14/Fedora/i386/os
7584install
7585cdrom
7586lang en_US.UTF-8
7587keyboard us
7588network --onboot yes --device eth0 --bootproto dhcp --noipv6
7589timezone --utc America/New_York
7590rootpw  --iscrypted $6$s9i1bQbmW4oSWMJc$0oHfSz0b/d90EvHx7cy70RJGIHrP1awzAgL9A3x2tbkyh72P3kN41vssaI3/SJf4Y4qSo6zxc2gZ3srzc4ACX1
7591selinux --permissive
7592authconfig --enableshadow --passalgo=sha512 --enablefingerprint
7593firewall --service=ssh
7594# The following is the partition information you requested
7595# Note that any partitions you deleted are not expressed
7596# here so unless you clear all partitions first, this is
7597# not guaranteed to work
7598
7599#I am deleting the old partitions with this
7600clearpart --all --drives=sda
7601
7602#I am creating partitions here
7603#I will create the lvm stuff farther down
7604part /boot --fstype=ext4 --size=500 --ondisk=sda --asprimary
7605part pv.5xwrsR-ldgG-FEmM-2Zu5-Jn3O-sx9T-unQUOe --grow --size=500 --ondisk=sda --asprimary
7606
7607#Very important to have the two part lines before the lvm stuff
7608volgroup VG --pesize=32768 pv.5xwrsR-ldgG-FEmM-2Zu5-Jn3O-sx9T-unQUOe
7609logvol / --fstype=ext4 --name=lv_root --vgname=VG --size=40960
7610logvol /home --fstype=ext4 --name=lv_home --vgname=VG --size=25600
7611logvol swap --fstype swap --name=lv_swap --vgname=VG --size=4096
7612
7613bootloader --location=mbr --driveorder=sda --append="rhgb quiet"
7614
7615%packages
7616@admin-tools
7617#@editors
7618#@fonts
7619@gnome-desktop
7620#@games
7621#@graphical-internet
7622#@graphics
7623@hardware-support
7624@input-methods
7625#@java
7626#@office
7627#@online-docs
7628@printing
7629@sound-and-video
7630@text-internet
7631@base-x
7632xfsprogs
7633mtools
7634#gpgme
7635#openoffice.org-opensymbol-fonts
7636#gvfs-obexftp
7637hdparm
7638#gok
7639#iok
7640#vorbis-tools
7641jack-audio-connection-kit
7642#ncftp
7643gdm
7644%end
7645
7646# Reboot after installation
7647reboot
7648
7649More Kickstart usage examples
7650
7651Various Kickstart usage examples based on real use cases:
7652
7653Reinstalling Fedora with Kickstart on BTRFS
7654
7655Kickstarting a Fedora Live installation
7656
7657© Copyright 2016, Red Hat Installer Engineering Team Revision 29b1886e.
7658Built with Sphinx using a theme provided by Read the Docs.
7659Read the Docs v: latest