Documentation for a newer release is available. View Latest

Preface

The System Administrator’s Guide contains information on how to customize the Fedora 39 system to fit your needs. If you are looking for a comprehensive, task-oriented guide for configuring and customizing your system, this is the manual for you.

This manual discusses many intermediate topics such as the following:

Installing and managing packages using DNF
Configuring Apache HTTP Server, Postfix, Sendmail and other enterprise-class servers and software
Working with kernel modules and upgrading the kernel

Some of the graphical procedures and menu locations are specific to GNOME, but most command line instructions will be universally applicable.

Target Audience

The System Administrator’s Guide assumes you have a basic understanding of the Fedora operating system. If you need help with the installation of this system, refer to the Fedora Installation Guide.

How to Read this Book

This manual is divided into the following main categories:

Basic System Configuration: This part covers basic system administration tasks such as keyboard configuration, date and time configuration, managing users and groups, and gaining privileges.

Opening Graphical Applications describes methods for opening Graphical User Interface, or GUI, applications in various environments.

System Locale and Keyboard Configuration covers basic language and keyboard setup. Read this chapter if you need to configure the language of your desktop, change the keyboard layout, or add the keyboard layout indicator to the panel.

Configuring the Date and Time covers the configuration of the system date and time. Read this chapter if you need to set or change the date and time.

Managing Users and Groups covers the management of users and groups in a graphical user interface and on the command line. Read this chapter if you need to manage users and groups on your system, or enable password aging.

Gaining Privileges covers ways to gain administrative privileges using setuid programs such as su and sudo.
Package Management: This part describes how to manage software packages on Fedora using DNF.

DNF describes the DNF package manager. Read this chapter for information how to search, install, update, and uninstall packages on the command line.
Infrastructure Services: This part provides information on how to configure services and daemons, configure authentication, and enable remote logins.

Services and Daemons covers the configuration of the services to be run when a system is started, and provides information on how to start, stop, and restart the services on the command line using the systemctl utility.

OpenSSH describes how to enable a remote login via the SSH protocol. It covers the configuration of the sshd service, as well as a basic usage of the ssh, scp, sftp client utilities. Read this chapter if you need a remote access to a machine.

TigerVNC describes the virtual network computing (VNC) method of graphical desktop sharing which allows you to remotely control other computers.
Servers: This part discusses various topics related to servers such as how to set up a Web server or share files and directories over the network.

Web Servers focuses on the Apache HTTP Server, a robust, full-featured open source web server developed by the Apache Software Foundation. Read this chapter if you need to configure a web server on your system.

Mail Servers reviews modern email protocols in use today, and some of the programs designed to send and receive email, including Postfix, Sendmail, Fetchmail, and Procmail. Read this chapter if you need to configure a mail server on your system.

Directory Servers covers the installation and configuration of OpenLDAP, an open source implementation of the LDAPv2 and LDAPv3 protocols. Read this chapter if you need to configure a directory server on your system.

File and Print Servers guides you through the installation and configuration of Samba, an open source implementation of the Server Message Block (SMB) protocol, and vsftpd, the primary FTP server shipped with Fedora. Additionally, it explains how to use the Printer Configuration tool to configure printers. Read this chapter if you need to configure a file or print server on your system.

Configuring NTP Using the chrony Suite covers the installation and configuration of the chrony suite, a client and a server for the Network Time Protocol (NTP). Read this chapter if you need to configure the system to synchronize the clock with a remote NTP server, or set up an NTP server on this system.

Configuring NTP Using ntpd covers the installation and configuration of the NTP daemon, ntpd, for the Network Time Protocol (NTP). Read this chapter if you need to configure the system to synchronize the clock with a remote NTP server, or set up an NTP server on this system, and you prefer not to use the chrony application.

Configuring PTP Using ptp4l covers the installation and configuration of the Precision Time Protocol application, ptp4l, an application for use with network drivers that support the Precision Network Time Protocol (PTP). Read this chapter if you need to configure the system to synchronize the system clock with a master PTP clock.
Monitoring and Automation: This part describes various tools that allow system administrators to monitor system performance, automate system tasks, and report bugs.

System Monitoring Tools discusses applications and commands that can be used to retrieve important information about the system. Read this chapter to learn how to gather essential system information.

Viewing and Managing Log Files describes the configuration of the rsyslog daemon, and explains how to locate, view, and monitor log files. Read this chapter to learn how to work with log files.

Automating System Tasks provides an overview of the cron, at, and batch utilities. Read this chapter to learn how to use these utilities to perform automated tasks.

OProfile covers OProfile, a low overhead, system-wide performance monitoring tool. Read this chapter for information on how to use OProfile on your system.
Kernel, Module and Driver Configuration: This part covers various tools that assist administrators with kernel customization.

Working with the GRUB 2 Boot Loader describes the GNU GRand Unified Boot loader (GRUB) version 2 boot loader, which enables selecting an operating system or kernel to be loaded at system boot time.

Manually Upgrading the Kernel provides important information on how to manually update a kernel package using the rpm command instead of dnf. Read this chapter if you cannot update a kernel package with the DNF package manager.

Working with Kernel Modules explains how to display, query, load, and unload kernel modules and their dependencies, and how to set module parameters. Additionally, it covers specific kernel module capabilities such as using multiple Ethernet cards and using channel bonding. Read this chapter if you need to work with kernel modules.
RPM: This appendix concentrates on the RPM Package Manager (RPM), an open packaging system used by Fedora, and the use of the rpm utility. Read this appendix if you need to use rpm instead of dnf.
The Wayland Display Server: This appendix looks at Wayland, a new display server used in GNOME for Fedora and how to troubleshoot issues with the Wayland display server.

We want feedback

If you find errors or have suggestions for improvement, we want your advice. Open an issue at https://pagure.io/.

In the issue:

Provide a short summary of the error or your suggestion in the Issue Title field.
Copy the following template into the Comment field and give us the details of the error or suggestion as specifically as you can. If possible, include some surrounding text so we know where the error occurs or the suggestion fits.
```
Document URL:

Section name:

Error or suggestion:

Additional information:
```
Click the Create Issue button.

Acknowledgments

Certain portions of this text first appeared in the Red Hat Enterprise Linux 7 System Administrator’s Guide, copyright © 2014–2023 Red Hat, Inc., available at https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/index.html.

Monitoring Performance with Net-SNMP is based on an article written by Michael Solberg.

The authors of this book would like to thank the following people for their valuable contributions: Adam Tkáč, Andrew Fitzsimon, Andrius Benokraitis, Brian Cleary Edward Bailey, Garrett LeSage, Jeffrey Fearn, Joe Orton, Joshua Wulf, Karsten Wade, Lucy Ringland, Marcela Mašláňová, Mark Johnson, Michael Behm, Miroslav Lichvár, Radek Vokál, Rahul Kavalapara, Rahul Sundaram, Sandra Moore, Zbyšek Mráz, Jan Včelák, Peter Hutterer, T.C. Hollingsworth, and James Antill, among many others.

Want to help? Learn how to contribute to Fedora Docs ›