Product SiteDocumentation Site

Fedora 23

Installation Guide

Installing Fedora 23 on 32 and 64-bit AMD and Intel

Edition 1

Fedora Documentation Team

Fedora Documentation Project

Legal Notice

Copyright © 2015 Red Hat, Inc. and others.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
For guidelines on the permitted uses of the Fedora trademarks, refer to
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
All other trademarks are the property of their respective owners.
This manual explains how to boot the Fedora installation program, Anaconda, and how to install Fedora 23 on 32 and 64-bit AMD and Intel systems. It also covers advanced installation methods such as automated Kickstart installations, booting the installation from a network location, remote access to the installation system using VNC, and system upgrades from previous versions of Fedora. It also describes common post-installation tasks and explains how to troubleshoot common issues related to the installation.

1. Document Conventions
1.1. Typographic Conventions
1.2. Pull-quote Conventions
1.3. Notes and Warnings
2. We Need Feedback!
3. Acknowledgments
1. Introduction
1.1. Background
1.1.1. About Fedora
1.1.2. Getting Additional Help
1.2. About This Document
1.2.1. Goals
1.2.2. Target Audience
2. Downloading Fedora
I. Installing Fedora
3. Preparing for Installation
3.1. Upgrade or Install?
3.2. Downloading Boot and Installation Images
3.3. Verifying the Downloaded Image
3.3.1. Verifying checksums on Windows systems
3.3.2. Verifying checksums on Linux and OSX systems
3.4. Preparing Boot Media
4. Booting the Installation
4.1. Preparing to Boot
4.2. The Boot Menu
5. Installing Using Anaconda
5.1. Introduction to Anaconda
5.2. Consoles and Logging During the Installation
5.2.1. Accessing Consoles
5.2.2. Saving Screenshots
5.3. Installing in Text Mode
5.4. Installing in the Graphical User Interface
5.4.1. Welcome Screen and Language Selection
5.4.2. Installation Summary
5.4.3. Date & Time
5.4.4. Keyboard Layout
5.4.5. Language Support
5.4.6. Installation Source
5.4.7. Software Selection
5.4.8. Installation Destination
5.4.9. Installation Destination - Specialized & Network Disks
5.4.10. Manual Partitioning
5.4.11. Kdump
5.4.12. Network & Hostname
5.4.13. Configuration and Installation Progress
5.4.14. Root Password
5.4.15. Create User
6. After the Installation
6.1. Initial Setup
6.2. GNOME Initial Setup
6.3. Common Post-installation Tasks
7. Troubleshooting
7.1. Getting Help
7.1.1. Log Files Generated During the Installation
7.1.2. Transferring Log Files from the Installation System
7.2. Trouble Beginning the Installation
7.2.1. Problems with Booting into the Graphical Installation
7.2.2. Serial Console Not Detected
7.3. Trouble During the Installation
7.3.1. No Disks Detected
7.4. Problems After Installation
7.4.1. Resetting the Root Password
7.4.2. Are You Unable to Boot With Your RAID Card?
7.4.3. Trouble With the Graphical Boot Sequence
7.4.4. Booting into a Graphical Environment
7.4.5. No Graphical User Interface Present
7.4.6. X Server Crashing After User Logs In
7.4.7. Is Your RAM Not Being Recognized?
II. Advanced Installation Options
8. Boot Options
8.1. Configuring the Installation System at the Boot Menu
8.2. Available Boot Options
8.2.1. Specifying the Installation Source
8.2.2. Kickstart Boot Options
8.2.3. Console, Environment and Display Options
8.2.4. Network Boot Options
8.2.5. Advanced Installation Options
8.2.6. Enabling Remote Access Using VNC
8.2.7. Debugging and Troubleshooting
8.3. Deprecated Boot Options
8.4. Removed Boot Options
8.5. Using the Maintenance Boot Modes
8.5.1. Loading the Memory (RAM) Testing Mode
8.5.2. Verifying Boot Media
8.5.3. Booting Your Computer in Rescue Mode
9. Automating the Installation with Kickstart
9.1. How to Perform a Kickstart Installation
9.1.1. Creating a Kickstart File
9.1.2. Verifying the Kickstart File
9.1.3. Making the Kickstart File Available
9.1.4. Starting the Kickstart Installation
10. Setting Up an Installation Server
10.1. PXE Installation Overview
10.2. DHCP Server Configuration
10.3. Installing the tftp server
10.4. Providing and configuring bootloaders for PXE clients
10.5. Getting the kernel and initrd
10.6. Providing repositories
10.7. Advanced network installations with Cobbler
11. Installing Using VNC
11.1. Installing a VNC Viewer
11.2. Performing a VNC Installation
11.2.1. Choosing a VNC Installation Mode
11.2.2. Installing in VNC Direct Mode
11.2.3. Installing in VNC Connect Mode
11.3. Kickstart Considerations
11.4. Considerations for Headless Systems
12. Upgrading Your Current System
12.1. Manual System Upgrade or Reinstallation
III. Technical Appendixes
A. Kickstart Syntax Reference
A.1. Installation Methods and Sources
A.1.1. device (optional) - Install Extra Device Drivers
A.1.2. driverdisk (optional) - Use a Driver Disk
A.1.3. install (required) - Configure Installation Method
A.1.4. mediacheck (optional) - Verify Installation Media Integrity
A.1.5. ostreesetup (optional) - Install from an OSTree
A.1.6. repo (optional) - Configure Additional Repositories
A.2. Storage and Partitioning
A.2.1. autopart (optional) - Automatic Partitioning
A.2.2. bootloader (required) - Configure Boot Loader
A.2.3. btrfs (optional) - Create Btrfs Volume or Subvolume
A.2.4. clearpart (optional) - Remove All Existing Partitions
A.2.5. fcoe (optional) - Configure Fibre Channel Over Ethernet Devices
A.2.6. ignoredisk (optional) - Ignore Specified Disks
A.2.7. iscsi (optional) - Configure iSCSI Devices
A.2.8. iscsiname (optional) - Assign Name to iSCSI Device
A.2.9. logvol (optional) - Create LVM Logical Volume
A.2.10. part (required) - Create Physical Partition
A.2.11. raid (optional) - Create Software RAID
A.2.12. reqpart (optional) - Create Required Partitions
A.2.13. volgroup (optional) - Create LVM Volume Group
A.2.14. zerombr (optional) - Reinitialize Partition Tables
A.2.15. zfcp (optional) - Configure Fibre Channel Device
A.3. Network Configuration
A.3.1. firewall (optional) - Configure Firewall
A.3.2. network (optional) - Configure Network Interfaces
A.4. Console and Environment
A.4.1. keyboard (optional) - Configure Keyboard Layouts
A.4.2. lang (optional) - Configure Language During Installation
A.4.3. services (optional) - Configure Services
A.4.4. skipx (optional) - Do Not Configure X Window System
A.4.5. timezone (optional) - Configure Time Zone
A.4.6. xconfig (optional) - Configure X Window System
A.5. Users, Groups and Authentication
A.5.1. auth or authconfig (optional) - Configure Authentication
A.5.2. group (optional) - Create User Group
A.5.3. pwpolicy (optional) - Change the Default Password Policy
A.5.4. realm (optional) - Join an Active Directory or IPA Domain
A.5.5. rootpw (required) - Set Root Password
A.5.6. selinux (optional) - Configure SELinux
A.5.7. sshkey (optional) - Add an Authorized SSH Key
A.5.8. user (optional) - Create User Account
A.6. Installation Environment
A.6.1. autostep (optional) - Go Through Every Screen
A.6.2. cmdline (optional) - Perform Installation in Command Line Mode
A.6.3. graphical (optional) - Perform Installation in Graphical Mode
A.6.4. logging (optional) - Configure Error Logging During Installation
A.6.5. rescue (optional) - Rescue Mode
A.6.6. sshpw (optional) - Restrict ssh Access During Installation
A.6.7. text (optional) - Perform Installation in Text Mode
A.6.8. unsupported_hardware (optional) - Suppress Unsupported Hardware Alerts
A.6.9. vnc (optional) - Configure VNC Access
A.7. After the Installation
A.7.1. %addon com_redhat_kdump (optional) - Configure kdump
A.7.2. firstboot (optional) - Enable or Disable Initial Setup
A.7.3. halt (optional) - Halt System After Installation
A.7.4. poweroff (optional) - Power Off After Installation
A.7.5. reboot (optional) - Reboot After Installation
A.7.6. shutdown (optional) - Shut Down After Installation
A.8. %addon (optional) - Include an Anaconda Add-on
A.9. %anaconda (optional) - Additional Anaconda Configuration
A.10. %include (optional) - Include Contents of Another File
A.11. %ksappend (optional) - Append Contents of Another File
A.12. %packages (required) - Package Selection
A.13. %pre (optional) - Pre-installation Script
A.14. %post (optional) - Post-installation Script
A.15. Example Kickstart Configurations
A.15.1. Advanced Partitioning Example
A.15.2. Example Pre-installation Script
A.15.3. Example Post-installation Script
B. An Introduction to Disk Partitions
B.1. Hard Disk Basic Concepts
B.1.1. File Systems
B.1.2. Partitions: Turning One Drive Into Many
B.1.3. Partitions Within Partitions - An Overview of Extended Partitions
B.1.4. GUID Partition Table (GPT)
B.2. Strategies for Disk Repartitioning
B.2.1. Using Unpartitioned Free Space
B.2.2. Using Space from an Unused Partition
B.2.3. Using Free Space from an Active Partition
B.3. Partition Naming Schemes and Mount Points
B.3.1. Partition Naming Scheme
B.3.2. Disk Partitions and Mount Points
B.3.3. How Many Partitions?
C. Understanding LVM
D. Revision History