Test repo for the Atomic Desktops
Find a file
2024-10-08 21:46:18 +02:00
ci ci: Manually install python3-libdnf5 first 2024-08-30 20:20:19 +02:00
.gitignore gitignore: Add more paths to ignore 2024-02-11 12:50:08 +01:00
.gitlab-ci.yml Use new Atomic names 2024-06-19 18:54:02 +02:00
.zuul.yaml zuul: Waiting for F41 cloud images 2024-08-30 20:20:19 +02:00
base-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
bootc.yaml Use conditional includes to separate bootable containers 2024-07-26 17:06:23 +02:00
bootupd.yaml bootupd: Drop unnecessary / 2024-02-09 18:41:05 +01:00
budgie-atomic-common.yaml Branch Fedora 41 from Rawhide 2024-08-12 15:33:03 +05:30
budgie-atomic-ostree.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
budgie-atomic-packages.yaml comps-sync f41 2024-10-08 2024-10-08 21:46:18 +02:00
budgie-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
cinnamon-atomic-packages.yaml comps-sync f41 2024-10-08 2024-10-08 21:46:18 +02:00
cinnamon-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
common-packages.yaml comps-sync f41 2024-09-14 2024-09-14 01:07:35 +02:00
common.yaml common: Also keep fuse-libs for AppImage compatibility 2024-09-20 19:16:17 +02:00
comps-sync-exclude-list.yml comps-sync-exclude-list: glibc-all-langpacks is always included 2024-08-30 20:20:19 +02:00
comps-sync.py Silverblue: Drop X11 from default installation 2024-07-15 15:34:06 +02:00
deepin-atomic-packages.yaml comps-sync f41 2024-10-08 2024-10-08 21:46:18 +02:00
deepin-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
dnf5.yaml Use conditional includes to separate bootable containers 2024-07-26 17:06:23 +02:00
fedora-41-updates.repo Rawhide is now f41 2024-02-13 19:01:33 +00:00
fedora-41.repo Rawhide is now f41 2024-02-13 19:01:33 +00:00
fedora-kinoite.yaml Fix un-symlinked manifests from branching 2024-08-19 16:10:21 +02:00
fedora-onyx.yaml Fix un-symlinked manifests from branching 2024-08-19 16:10:21 +02:00
fedora-sericea.yaml Fix un-symlinked manifests from branching 2024-08-19 16:10:21 +02:00
fedora-silverblue.yaml Fix un-symlinked manifests from branching 2024-08-19 16:10:21 +02:00
group group: Fix tape & input GIDs 2022-11-10 17:01:09 +00:00
grub2-workaround.yaml common: Add workaround for issue with newer GRUB2 2024-08-30 20:20:19 +02:00
initramfs-tpm-luks.yaml Include systemd-pcrphase dracut module only on !ppc64le 2024-07-26 17:06:23 +02:00
initramfs.yaml Include systemd-pcrphase dracut module only on !ppc64le 2024-07-26 17:06:23 +02:00
justfile justfile: Remove checks for manifest command 2024-07-26 17:06:23 +02:00
kinoite-common.yaml Kinoite: Make sure rpm-ostree support is installed 2024-09-02 18:29:56 +02:00
kinoite-mobile-packages.yaml comps-sync f41 2024-08-21 2024-08-21 19:59:52 +02:00
kinoite-mobile.yaml Kinoite Mobile: Factor out common parts of the manifest 2024-09-02 18:29:53 +02:00
kinoite-ostree.yaml Kinoite Mobile: Factor out common parts of the manifest 2024-09-02 18:29:53 +02:00
kinoite-packages.yaml comps-sync-exclude-list: glibc-all-langpacks is always included 2024-08-30 20:20:19 +02:00
kinoite.yaml Kinoite Mobile: Factor out common parts of the manifest 2024-09-02 18:29:53 +02:00
LICENSE LICENSE: Add MIT license text 2021-12-16 11:39:31 +01:00
lxqt-atomic-packages.yaml Update manifests names for variants and their package lists 2024-06-13 11:30:19 +02:00
lxqt-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
mate-atomic-packages.yaml comps-sync f41 2024-10-08 2024-10-08 21:46:18 +02:00
mate-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
ostree-classic.yaml Revert "Bootable Containers: Remove ostree-grub2" 2024-08-26 11:32:55 +02:00
passwd passwd: Fix (no)login shell paths 2022-11-10 17:01:09 +00:00
README.md Update manifests names for variants and their package lists 2024-06-13 11:30:19 +02:00
silverblue-common.yaml Branch Fedora 41 from Rawhide 2024-08-12 15:33:03 +05:30
silverblue-ostree.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
silverblue-packages.yaml comps-sync f41 2024-08-15 2024-08-15 16:11:13 -04:00
silverblue.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
sway-atomic-common.yaml Branch Fedora 41 from Rawhide 2024-08-12 15:33:03 +05:30
sway-atomic-ostree.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
sway-atomic-packages.yaml comps-sync f41 2024-07-17 2024-07-17 17:46:39 +02:00
sway-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00
sysroot-ro.yaml common: Setup read only sysroot via ostree config 2024-06-11 10:36:44 +02:00
xfce-atomic-packages.yaml comps-sync f41 2024-10-08 2024-10-08 21:46:18 +02:00
xfce-atomic.yaml Drop fedora-rawhide repo for f41 branch. 2024-08-15 12:57:02 -07:00

Manifests for Fedora Atomic Desktops variants

This is the configuration needed to create rpm-ostree based, desktop variants of Fedora, also known as Fedora Atomic Desktops.

This repo is managed by the Fedora Atomic Desktops SIG.

The currently official Fedora Atomic Desktop variants are:

  • Fedora Silverblue
  • Fedora Kinoite
  • Fedora Sway Atomic
  • Fedora Budgie Atomic

Reach out to the SIG if you are interested in creating and maintaining a new Atomic variant.

Repository content

Each variant is described in a YAML treefile which is then used by rpm-ostree to compose an ostree commit with the package requested.

In the Fedora infrastructure, composes are made via pungi with the configuration from:

Installer ISOs are built using Lorax and additional templates: pagure.io/fedora-lorax-templates.

Website

The sources for the Silverblue, Kinoite, Sway Atomic and Budgie Atomic websites are in gitlab.com/fedora/fedora-websites-3.0.

Issue trackers

Issues common to all Fedora Atomic Desktops are tracked in gitlab.com/fedora/ostree/sig.

Desktop specific issues should be filed in their respective issue trackers:

Documentation

The documentation for Fedora Atomic variants is currently duplicated for each variant at Atomic Desktops.

There are plans to unify the documentation: ostree/sig#10

Documentation sources:

Building

All commonly used commands are listed as recipes in the justfile (see Just).

Example to do a local build of Fedora Silverblue:

# Clone the config
$ git clone https://pagure.io/workstation-ostree-config && cd workstation-ostree-config

# Build the classic ostree commits (currently the default in Fedora)
$ just compose-legacy variant=silverblue

# Or build the new ostree native container (not default yet, still in development)
$ just compose-image variant=silverblue

Testing

Instructions to test the resulting build for classic ostree commits:

simple-http-server --index --ip 192.168.122.1 --port 8000
  • Then, on an already installed Silverblue system:
# Add an ostree remote
sudo ostree remote add testremote http://192.168.122.1:8000/repo --no-gpg-verify

# Pin the currently deployed (and probably working) version
sudo ostree admin pin 0

# List refs from variant remote
sudo ostree remote refs testremote

# Switch to your variant
sudo rpm-ostree rebase testremote:fedora/rawhide/x86_64/silverblue

# Reboot and test!

Instructions to test the resulting build for ostree native containers:

  • Push the OCI archive to a container registry
  • Rebase to it:
$ rpm-ostree rebase ostree-unverified-image:registry:<oci image>

See URL format for ostree native containers for details.

Syncing with Fedora Comps

Fedora Comps are "XML files used by various Fedora tools to perform grouping of packages into functional groups."

Changes to the comps files need to be regularly propagated to this repo so that the Fedora Atomic variants are kept updated with the other desktop variants.

Using just

If you have the just command installed, you can run just comps-sync from a git checkout of this repo to update the packages included in the Fedora Atomic variants. Examine the changes and cross-reference them with PRs made to the fedora-comps repo. Create a pull request with the changes and note any PRs from fedora-comps in the commit message that are relevant to the changes you have generated.

Using comps-sync.py directly

If you don't have just installed or want to run the comps-sync.py script directly, you need to have an up-to-date git checkout of https://pagure.io/fedora-comps and a git checkout of this repository.

Using the comps-sync.py script, provide the updated input XML file to examine the changes as a dry-run:

$ ./comps-sync.py /path/to/fedora-comps/comps-f41.xml.in

Examine the changes and cross-reference them with PRs made to the fedora-comps repo. When you are satisfied that the changes are accurate and appear safe, re-run the script with the --save option:

$ ./comps-sync.py --save /path/to/fedora-comps/comps-f41.xml.in

Create a pull request with the changes and note any PRs from fedora-comps in the commit message that are relevant to the changes you have generated.

Branching instructions for new Fedora releases

Follow those steps during the Fedora branch process in Fedora:

Fedora Ansible

Make a PR similar to ansible#1318 in fedora-infra/ansible.

On Rawhide / main branch

sed -i "s/41/42/g" *.repo comps-sync.py
sed -i "s/releasever: 41/releasever: 42/" common.yaml
sed -i "s/# - fedora-41/# - fedora-42/" *.yaml
mv fedora-41.repo fedora-42.repo
mv fedora-41-updates.repo fedora-42-updates.repo
sed -i "s/42/42/g" README.md
sed -i "s/41/42/g" README.md

On the new branch (f41)

rm fedora-rawhide.repo
sed -i "/- fedora-rawhide/d" fedora-*.yaml
sed -i "s/# - fedora-41/- fedora-41/" *.yaml
sed -i "s/ref: fedora\/rawhide/ref: fedora\/41/" *.yaml

Historical references

Building and testing instructions:

For some background, see:

Note also this repo obsoletes https://pagure.io/atomic-ws