Pages with tag how-to

Accessibility – Installing Fedora with Orca

Thanks for choosing to install Fedora. The first thing you’ll need to do is put an installer onto a removable disk, like a DVD or Flash Drive. For maximum accessibility,… Read more

Accessibility – Getting Started After Installation with Orca

Now that the system is installed, you’ll need to log in with your user account password. But, Orca isn’t speaking at this point. To turn it on, press Alt +… Read more

Accessibility – Why Choose Fedora Linux?

As other, proprietary, computer operating systems (OS) decline in accessibility, or fail to move forward on lofty promises, people with disabilities may begin looking for an alternative, particularly as computers… Read more

Adding or removing software repositories in Fedora

This section describes how to add, enable, or disable a software repository with the DNF application. Adding repositories This section describes how to add software repositories with the dnf config-manager… Read more

Adding a user to sudoers

One of the most common operations that administrators want to accomplish when managing sudo permissions is to grant a new user general sudo access. This is helpful if you want… Read more

Checking Integrity With AIDE

Advanced Intrusion Detection Environment (AIDE) is a utility that creates a database of files on the system, and then uses that database to ensure file integrity and detect system intrusions.… Read more

Anaconda Logging

Introduction Anaconda tracks all of its activities in logs. This includes: changing installation steps (that roughly correspond to different screens in the graphical installer) storage devices detection and manipulation installation… Read more

Automatic Updates

You must decide whether to use automatic DNF updates on each of your machines. There are a number of arguments both for and against automatic updates to consider. However, there… Read more

Using Bugzilla

Fedora uses Red Hat Bugzilla for bug tracking. This page and the other pages under the "Bugs" header on the left offer some tips and guidance. Permissions Any user, including… Read more

Managing Bugzilla email notifications

Bugzilla allows you to set granular email notification preferences. Email preferences To set your email preferences, go to the Email Preferences tab of your user preferences. You will see a… Read more

How to file a bug

The purpose of this document is to give step by step instructions on filing bugs in Fedora. For more information about using Bugzilla, see the Bugs section of the Quick… Read more

Bugzilla – Finding the Correct Component

When filing a bug, it helps if you can identify the component at fault. This is not always obvious, so here are some tips. Which program is it? If you… Read more

Finding duplicates in Bugzilla

Fedora developers want to hear about specific and reproducible bugs that happen when you use Fedora Linux, but it does not help to have the same bug reported many times.… Read more

Providing a Stack Trace

A stack trace is one of the most important pieces of information you can provide to help others debug an application crash. This page details the importance of stack traces… Read more

Bugzilla queries

Bugzilla lets you search for bug reports that match specified conditions. This page covers common options. The Red Hat Bugzilla User Guide has more information. Simple queries The simple Bugzilla… Read more

Reporting Bugzilla spam

Like any website that allows user contribution, Red Hat Bugzilla sometimes gets spam comments. There are two ways to report spam. Tag comment The preferred way is to tag the… Read more

Changing Hostname

A new installation of Fedora will assign a default hostname. You may wish to set a different name for easier identification of your host(s) on a network. There are three… Read more

Configuring IP networking with nmcli

How to configure networking using the nmcli (NetworkManager Command Line Interface) command-line utility. Getting started with nmcli The nmcli (NetworkManager Command Line Interface) command-line utility is used for controlling NetworkManager… Read more

Configuring X Window System using the xorg.conf file

About xorg.conf Traditionally, the xorg.conf file is used to configure an Xorg display server. In Fedora (where an Xorg display server is configured instead of the default Wayland) the X… Read more

Configuring Xorg as the default GNOME session

Wayland is the default GNOME display server, and has been the default in Fedora since Fedora 25. However, users may still need to use the older Xorg display server for… Read more

Contribute to Quick Docs

The goal is to move away from wikis, where helpful guides are mixed with draft documentation, internal notes, to a nice, topic-oriented how-to guides and code-packed tutorials with a pull-request-based… Read more

GPG Keys Management

This document explains in detail how to obtain a GPG key using common Fedora utilities. It also provides information on managing your key as a Fedora contributor. Creating GPG Keys… Read more

Creating a Disk Partition in Linux

Creating and deleting partitions in Linux is a regular practice because storage devices (such as hard drives and USB drives) must be structured in some way before they can be… Read more

Creating and using a live installation image

Downloading Fedora You can download Fedora from There are multiple desktops available for use with Fedora. Each has a slightly different look and feel and offers varying levels of… Read more

Creating Windows virtual machines using virtIO drivers

Fedora infrastructure hosts virtIO drivers and additional software agents for Windows virtual machines running on kernel-based virtual machines (KVM). virtIO is a virtualization standard for network and disk device drivers.… Read more

CUPS – How to Debug Printing Issues

If you are experiencing a problem with printing, please take a look at the common bugs page before filing a bug. If the problem you are seeing is not listed… Read more

CUPS – How to Debug Scanning Issues

SANE library, communication libraries and backends can turn on and off debug logging via SANE_DEBUG_* environment variables. The common environment variables: SANE_DEBUG_DLL - enables debugging SANE library SANE_DEBUG_SANEI_USB - enables… Read more

CUPS – Filing a Bug Report

Deciding which component Problems involving printing may relate to several components. The configuration GUI (See above) is either GNOME 3 System Settings application or system-config-printer. These packages also provide the… Read more

CUPS – Known Issues

Here are several known issues, which arise with certain circumstances, and there isn’t general solution or upstream didn’t want to add the solution to its project: cups-browsed Cannot print due… Read more

CUPS – Printing and Scanning Terminology

Printing Print queue Abstraction unit in CUPS for a printer - it has a device uri, which represents connection to the device, and can exist with classic driver (PPD file… Read more

CUPS – Useful Tricks

How to install a print queue The fact whether you have to install a printer or not depends on several things: what is the device you want to install -… Read more

How to debug Dracut problems

Foreword If you are experiencing a problem with system initialization due to Dracut, please see the common bugs document before filing a bug. Some easy configuration tweaks that fix a… Read more

Disabling the GNOME automatic screen locking

In the interest of safety and privacy, the GNOME automatic screen lock is enabled by default. When the screen locks after a period of inactivity, you must enter your password… Read more

Displaying a User Prompt on the GNOME Login Screen

To show a user prompt instead of a list of users on the GNOME login screen, open a terminal and perform the following steps: Create a file for the GNOME… Read more

DNF Package Manager Quick Reference

This sections lists the most useful commands provided by the dnf utility. For a complete list of commands, options, and their syntax, see the dnf(8) man page. dnf help command… Read more

DNF and its APT command equivalents on Fedora

APT is the package manager/dependency solver for the Debian ecosystem, i.e. it manages .deb packages installed by the DPKG program. Fedora software is based on .rpm packages, and thus uses… Read more

Using the DNF software package manager

DNF is a software package manager that installs, updates, and removes packages on Fedora and is the successor to YUM (Yellow-Dog Updater Modified). DNF makes it easy to maintain packages… Read more

How to enable touchpad click

Scope Fedora tries to make various desktop environments available to its users. Since Fedora tries to stay as close to upstream as possible, we follow the various defaults selected by… Read more

Fedora Repositories

This page explains the various Fedora repositories that exist for different Fedora Releases, the relationship between them, and what packages they contain. The fedora repository The fedora repository exists for… Read more

Control of System Accessibility by firewalld

A firewall is a way to protect machines from any unwanted access from outside. In Fedora, it is installed by default during the installation of the operating system, enabled and… Read more

Adding New Fonts in Fedora

Fedora pre-installs several basic fonts by default. This page explains how to add new fonts to a Fedora installation. Packaged fonts Did you know Fedora packages several freely-licensed fonts? There… Read more

Getting started with Apache HTTP Server

The Apache HTTP Server is one of the most commonly-used web servers. This section acts as a quick-start guide to deploying and configuring Apache on Fedora. Installing HTTPD This procedure… Read more

Setting a key shortcut to run an application in GNOME

If you frequently use a certain application, you can set a keyboard shortcut to quickly launch that application on GNOME. This example shows how to set a key shortcut to… Read more

GNOME Shell extensions

From the website: "GNOME Shell extensions are small pieces of code written by third party developers that modify the way GNOME works. (If you are familiar with Chrome Extensions or… Read more

The GRUB2 Bootloader – Installation and Configuration

GRUB2 is the latest version of GNU GRUB, the GRand Unified Bootloader. A bootloader is the first software program that runs when a computer starts. It is responsible for loading… Read more

Installing and Running VLC

Installing VLC Install VLC: Running VLC To run the VLC media player using GUI: Open the launcher by pressing the Super key. Type vlc. Press Enter. To run VLC from… Read more

Installing Chromium or Google Chrome browsers

Chromium and Google Chrome web browsers Fedora Workstation, in its out of the box configuration, only includes free and open source software. Mozilla Firefox is the browser included in Fedora… Read more

Installing software from source on Fedora

Most of the software you will install on your Fedora system will either come from a desktop application manager tool such as the GNOME Software tool or from a command… Read more

Installing Java

Java is a popular programming language that allows you run programs on many platforms, including Fedora. If you want to create Java programs, you need to install a JDK (Java… Read more

Installing MySQL/MariaDB

MySQL is a popular RDBMS (Relational Database Management System). MariaDB was born as a fork of MySQL. Nowadays the two products are a little bit different. Migrating data from one… Read more

Installing plugins for playing movies and music

As a Fedora user and system administrator, you can use these steps to install additional multimedia plugins that enable you to play various video and audio types. Procedure Use the… Read more

Installing Skype on Fedora

Skype is a cross-platform proprietary chat (text and video) application. It also provides voice calls and desktop sharing. It uses a proprietary Internet telephony (VoIP) network called the Skype protocol.… Read more

Installing Spotify on Fedora

Spotify is a cross-platform proprietary music streaming service. Spotify is a freemium service, with advertisements which can be removed by purchasing a subscription. Although Spotify is not officially supported on… Read more

Installing virtual operating systems with GNOME Boxes

GNOME Boxes is an application in GNOME Desktop Environment, which enables you to virtually access various operating systems. Installing a virtual operating system from the list of predefined systems To… Read more

Jitsi Meet Self-Hosting Guide

Jitsi video conferencing stack enables users to create virtual meetings, conferences, and collaboration sessions among other notable use-cases. Jitsi video conferencing stack provides: Jitsi Meet (jitsi-meet): a web-based client application… Read more

Joining an Active Directory or FreeIPA domain

Fedora can join Active Directory and FreeIPA domains using the realm command. If you want your Fedora machine to be part of an Active directory or FreeIPA domain just follow… Read more


Setting an installed kernel to boot by default To set a specific installed kernel to boot by default, first check the kernels installed on the system. Identify the kernel to… Read more

Building a Custom Kernel

This document provides instructions for advanced users who want to rebuild the kernel from some source. Some common reasons to build a custom kernel are: To apply patches for testing… Read more

Installing Kernel from Koji

A quick guide on installing a kernel from the Koji repository. Koji is the build system Fedora developers use to build software for inclusion into Fedora. If there is a… Read more

Kernel Test Days

A quick guide for Kernel Test Days. During Kernel Test Days, contributors are asked to run a Kernel Regression Test which will help to detect and troubleshoot any issue with… Read more

Testing Patches

A quick guide for testing if a patch resolves your issue. Occassionally, when attempting to resolve a kernel issue (particularly one that’s specific to your hardware) you may be asked… Read more


The kernel, like any software, has bugs. It’s a large, complex project and can be difficult to troubleshoot problems. This document covers some basic troubleshooting techniques to help narrow down… Read more

How to Manage Various Database Server from GUI

For database management, it is more user-friendly to use graphical tools: MySQL/MariaDB: phpMyAdmin.noarch : A web interface for MySQL and MariaDB MySQL Specific: MySQL Workbench is a unified visual tool… Read more

Managing keyboard shortcuts for running an application in GNOME

Adding keyboard shortcuts for custom applications in GNOME This section describes how to add a keyboard shortcut for starting a custom application in GNOME. Procedure Open Settings and choose the… Read more

Machine Owner Key Enrollment

This page documents how to enroll a machine owner key that is created during the Nvidia driver installation (typically in GNOME Software). Prerequisite The Nvidia driver has been installed and… Read more

Network Manager Quick Reference

NetworkManager status Overall status of NetworkManager Display active connections Display all configured connections Connect/disconnect to an already configured connection Connect to a configured connection by name Disconnection by name Wi-Fi… Read more


This page contains information on the Cisco OpenH264 codec. Background Cisco provides an OpenH264 codec (as a source and a binary), which is their of implementation H.264 codec, and they… Read more

Package management system

Package Management System Introduction Fedora is a distribution that uses a package management system. This system is based on rpm , the RPM Package Manager, with several higher level tools… Read more

PackageKit Items Not Found

Missing Package Unfortunately, the package you were searching for is not available in Fedora. There are a few common reasons why a package might not be in Fedora’s repositories: Fedora… Read more

Performing administration tasks using sudo

How to perform tasks requiring root privileges without logging in as root. What is sudo? The sudo command allows users to gain administrative or root access. When trusted users precede… Read more


Installation The installation and initialization of the postgresql server is a little bit different in comparison to other packages and other Linux distros. This document aims to summarize basic installation… Read more

How to use QEMU

QEMU is a very flexible virtualization technology however it is quite slow and it is recommended that you understand and evaluate alternative solutions before picking this one. Refer to Getting… Read more

Fedora on Raspberry Pi

The Raspberry Pi is a credit card-sized ARM based single board computer (SBC). This documentation describes how to get started The Raspberry Pi 4 is officially supported from Fedora release… Read more

Root Account Locked

Phenomenon Cannot open access to console, the root account is locked in emergency mode (dracut emergency shell) Reason This is a known problem. It happens Fedora releases 28 and newer,… Read more

Enabling the RPM Fusion repositories

Third party repositories There are a number of third-party software repositories for Fedora. They have more liberal licensing policies and provide software packages that Fedora excludes for various reasons. These… Read more

Screen Recorder – Comparison of Applications and How to Use Them

Using Gnome’s native screencast tool Gnome3 has already a screen recording functionality. Pressing Alt+Ctrl+Shift+R recording will start. There should be a red icon on the message tray in the right-bottom… Read more

Securing the system by keeping it up-to-date

This section explains: Why it is important to update your system regularly How to apply updates manually by using the GUI or CLI How to enable automatic updates Why it… Read more

Changing SELinux States and Modes

Permanent changes in SELinux states and modes As discussed in Getting started with SELinux SELinux can be enabled or disabled. When enabled, SELinux has two modes: enforcing and permissive. Use… Read more

Getting started with SELinux

Introduction to SELinux Security Enhanced Linux (SELinux) provides an additional layer of system security. SELinux fundamentally answers the question: May <subject> do <action> to <object>?, for example: May a web… Read more

Troubleshooting Problems Related to SELinux

If you plan to enable SELinux on systems where it has been previously disabled or if you run a service in a non-standard configuration, you might need to troubleshoot situations… Read more

How to Set Nvidia as Primary GPU on Optimus-based Laptops

Introduction The objective is to enable NVIDIA GPU of an Optimus-based laptop all the time and use it for every single activity. Please do not use this guide if you… Read more

Understanding and administering systemd

Learn the basic principles of the systemd init system: how to configure it and use it to administer the system. Understanding systemd Systemd is a system and service manager for… Read more

Troubleshooting Bluetooth problems

Bluetooth is a short range wireless protocol that is used to connect to various low bandwidth I/O devices (like keyboards, mice, headsets). Newer versions have a low-energy mode with a… Read more

Troubleshooting Java Programs

Java provides a range of information to resolve problems with application programs or the runtime environment, in particular stack traces. These should be attached to a bug report. This page… Read more

Troubleshooting Mozilla Products

This article helps affected users in reporting of Firefox and Thunderbird bugs and ease package maintainers fixing them. Using Mozilla crash reporter Application crash can occur during runtime. Application window… Read more

Troubleshooting Wayland Problems

Wayland is intended as a simpler replacement for X11. Wayland changes the design of a Linux desktop architecture considerably. Unlike X11, there is no dedicated standalone server in Wayland. What… Read more

Upgrading Fedora Linux to a New Release

This article mainly describes the update procedures for the Fedora Desktop variants. Some of the descriptions also apply to the server versions. However, the latter may provide their own documentation… Read more

Upgrading Fedora Linux Using DNF System Plugin

dnf-plugin-system-upgrade is a plugin for the DNF package manager and is used to upgrade your system to the current release of Fedora Linux. For Fedora Silverblue and Fedora CoreOS, which… Read more

Upgrading Fedora Linux Online Using Package Manager

This page contains information explaining how to upgrade Fedora Linux online using dnf (without the DNF system upgrade plugin). Upgrading Fedora Linux using dnf directly Participate If you are upgrading… Read more

Using Kubernetes on Fedora

Overview This how-to provides an overview of the Kubernetes (K8s) rpms in the Fedora repositories, how to use them in a few scenarios and a short cluster creation guide using… Read more

How to enable nested virtualization in KVM

Nested virtualization allows you to run a virtual machine (VM) inside another VM while still using hardware acceleration from the host. Checking if nested virtualization is supported For Intel processors,… Read more

Using Shared System Certificates

The Shared System Certificates storage enables NSS, GnuTLS, OpenSSL, and Java to share a default source for retrieving system certificate anchors and black list information. By default, the trust store… Read more

Using YubiKeys with Fedora

What is a YubiKey? A YubiKey is a small USB and NFC based device, a so called hardware security token, with modules for many security related use-cases. It generates one… Read more

Viewing logs in Fedora

Log files contain messages about the system, including the kernel, services, and applications running on it. These contain information that helps troubleshoot issues, or simply monitor system functions. Fedora uses… Read more

Virtualization – an Overview

This page covers the efforts to integrate various virtualization technologies into Fedora. Introduction Virtualization allows one to run many guest virtual machines on top of a host operating system such… Read more

Virtualization – Getting Started

Fedora uses the libvirt family of tools as its virtualization solution. Enabling hardware virtualization support This section covers setting up libvirt on your system. After setting up libvirt, you can… Read more

Virtualization – How to Debug Issues

Effective bug reporting Reporting bugs effectively is an important skill for any Fedora user or developer. Narrowing down the possible causes of the bug and providing the right information in… Read more

VMware – what is it and how use it?

VMware provides cloud computing and virtualization software and services, their most important products are: VMware Workstation Player, is a virtualization software package and can run existing virtual appliances and create… Read more

Wine – Running Windows applications in the Fedora GUI

Wine is an open source implementation of the Windows API on top of X and OpenGL. Wine emulates the Windows runtime environment by translating Windows system calls into POSIX-compliant system… Read more

Installing Zoom on Fedora

Description Zoom Video Communications. Inc. is an American communications technology company headquartered in San Jose, California. It provides videotelephony and online chat services through a cloud-based peer-to-peer software platform and… Read more