docs/release-docs-home
21
1
Fork 3
Code Issues 2 Pull requests Projects Activity Actions

(a) Add KDE Plasma as an Edition

Browse source 
(b) Add Cosmic Atomic, update the names of Sway Atomic and Budgie Atomic.
(c) Provide some narrative about atomic desktops and installation limitations.
(d) Minor text tweaks
This commit is contained in:
philipmgrant 2025-08-20 14:35:56 +00:00
commit 7b768cb231
1 changed files with 54 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

100
modules/ROOT/pages/getting-started.adoc
View file

@ -1,26 +1,26 @@
= Getting Started
The Fedora docs team
:revnumber: F40
:revdate: 2024-03-04
:revnumber: F42
:revdate: 2025-08-20
// Redirect the old (generic) installation guide to this page
:page-aliases: rawhide@fedora:install-guide:index.adoc
:page-aliases: f42@fedora:install-guide:index.adoc
// on 64-bit AMD, Intel and Arm SystemReady machines
[abstract]
This guide intends to provide an overview of and an introduction to installing Fedora. It takes into account users with varying levels of knowledge and experience with Fedora, and therefore covers greater detail than some users are likely to require. This should specifically help new users to complete the installation process without interruptions. Users may skip section about familiar topics.
This guide intends to provide an overview of and an introduction to installing Fedora. It takes into account users with varying levels of knowledge and experience with Fedora, and therefore covers greater detail than some users are likely to require. This should specifically help new users to complete the installation process without interruptions. Users may skip sections about familiar topics.
== Introduction
This guide covers installation of Fedora, a Linux distribution built on free and open source software. This manual helps you install Fedora on desktops, laptops, and servers. The installation system is easy to use, even if you lack previous knowledge of Linux or computer networks. If you select default options, Fedora provides a complete operating system, with solid _security settings_ and _including productivity applications_, Internet utilities, and administration tools.
Fedora is provided in several distribution items tailored for special Purposes. We call it *Editions* and *spins*.
Fedora is provided in several variants tailored for special purposes. We call them *Editions*, *Atomic Desktops* and *Spins*.
_Because of these differences, there is no single installation procedure._
Most editions and spins, but not all, use Anaconda, the Fedora installer, but in a way that is quite different in detail.
Most Fedora variants, but not all, use Anaconda, the Fedora installer, but in a way that is quite different in detail.
Therefore, _each edition describes the installation separately_. Most spins are based on one of the editions, mostly Fedora Workstation, and use the corresponding installation procedure.
@ -29,15 +29,17 @@ Nevertheless, there are some preparatory steps that are almost the same for all
== Fedora variants and how to install
Fedora Workstation Edition::
This variant is installed by using a Live CD
=== Editions
Fedora Workstation::
This variant (using GNOME as the desktop environment) is installed by using a Live USB, CD, or DVD.
+
Software download at https://fedoraproject.org/workstation/download/
Fedora Workstation Spins::
Most spins use a Live CD for installation as well.
Fedora KDE Plasma Desktop::
This variant (using KDE Plasma as the desktop environment) is also installed by using a Live USB, CD, or DVD.
+
Software download at https://fedoraproject.org/spins/
Software download at https://fedoraproject.org/kde/download/
Fedora Server Edition::
This variant provides a flexible and highly adaptable Server, suitable to provide a wide range of services.
@ -47,7 +49,7 @@ The project provides a dedicated https://docs.fedoraproject.org/en-US/fedora-ser
Software download at https://fedoraproject.org/server/download/
Fedora IoT Edition::
This variant implements a server for the 'Internet of Things' or 'edge computing'
This variant implements a server for the 'Internet of Things' or 'edge computing'.
+
The project provides a dedicated https://docs.fedoraproject.org/en-US/iot/[installation guide] and documentation about usage and administration.
+
@ -58,43 +60,65 @@ A minimal, container-focused operating system, designed for clusters but also op
+
Software download at https://fedoraproject.org/coreos/download/?stream=stable
Fedora Silverblue::
An immutable desktop variant of Fedora Workstation Edition, featuring the GNOME desktop, and an excellent platform for container-focused workflows.
+
More information at https://fedoraproject.org/silverblue/
Fedora Kinoite::
An immutable desktop variant of Fedora Workstation Edition, featuring the KDE Plasma desktop, and an excellent platform for container-focused workflows.
+
More information at https://fedoraproject.org/kinoite/
Fedora Sericea::
An immutable desktop variant of Fedora Workstation Edition, featuring the Sway tiling window manager, and an excellent platform for container-focused workflows.
+
More information at https://fedoraproject.org/sericea/
Fedora Onyx::
An immutable desktop variant of Fedora Workstation Edition, featuring the Budgie desktop, and an excellent platform for container-focused workflows.
+
More information at https://fedoraproject.org/onyx/
Fedora Cloud::
As the name indicates, it focuses on Fedora on cloud networks. Installation and usage follows the respective cloud systems.
+
More information at https://fedoraproject.org/cloud/
=== Spins
Fedora Workstation Spins::
Most spins use a Live CD, DVD or USB for installation.
+
Software download at https://fedoraproject.org/spins/
=== Atomic Desktops
Atomic desktops use a read-only root filesystem. This means that every installation is identical to every other installation of the same version.
The operating system root filesystem on disk is exactly the same from one machine to the next, and it never changes as it is used.
Atomic desktops use the Anaconda installer, but have some limitations on installation options compared to Editions and Spins. The
https://docs.fedoraproject.org/en-US/fedora-silverblue/installation/[Silverblue installation documentation] describes these limitations,
which apply to all the Fedora atomic desktop variants
Fedora Silverblue::
An atomic desktop variant of Fedora, featuring the GNOME desktop, and an excellent platform for container-focused workflows.
+
More information at https://fedoraproject.org/atomic-desktops/silverblue/
Fedora Kinoite::
An atomic desktop variant of Fedora, featuring the KDE Plasma desktop.
+
More information at https://fedoraproject.org/atomic-desktops/kinoite/
Fedora Sway Atomic::
An atomic desktop variant of Fedora, featuring the Sway tiling window manager.
+
More information at https://fedoraproject.org/atomic-desktops/sway/
Fedora Budgie Atomic::
An atomic desktop variant of Fedora, featuring the Budgie desktop.
+
More information at https://fedoraproject.org/atomic-desktops/budgie/
Fedora COSMIC Atomic::
An atomic desktop variant of Fedora, featuring the COSMIC desktop (currently in alpha version).
+
More information at https://fedoraproject.org/atomic-desktops/cosmic/
=== Labs
Fedora Labs::
Curated bundles of purpose-driven software, maintained by community members. The respective compilations are either installed as independent, complete Fedora versions or complement existing Fedora installations.
+
https://labs.fedoraproject.org
According to different usage und purposes the variation not only differ in their installation process, they differ in administration and usage. To learn how to use an installed Fedora system, see the manuals available at the specific variant documentation pages.
Regarding installation, be especially prepared for the fact that each variant requires additional post-installation processes.
== General preparations
According to different usage and purposes the variation not only differ in their installation process, they differ in administration and usage. To learn how to use an installed Fedora system, see the manuals available at the specific variant documentation pages.
Regarding installation, be especially prepared for the fact that each variant requires additional post-installation processes.
Despite all the differentiation, some things are the same for all variants.
=== Download the software deliverables
@ -107,7 +131,7 @@ Visit the link:++https://fedoraproject.org/++[Fedora Project website] to downloa
=== Prepare boot media
An install on hardware usually requires to transfer the download file to a bootable medium, mostly an USB stick.
An install on hardware usually requires to transfer the download file to a bootable medium, mostly a USB stick.
xref:preparing-boot-media.adoc#fedora_media_writer[Fedora Media Writer] is the tool of choice, developed and supported by Fedora.
Alternatively you may try https://etcher.balena.io/[balenaEtcher] or the https://www.ventoy.net/en/index.html[Ventoy project], both available for Linux, macOS, and Windows.