Skip to content
This repository has been archived by the owner on Mar 25, 2024. It is now read-only.

chore: Opinionated changes to index #723

Merged
merged 2 commits into from
Mar 5, 2024
Merged

chore: Opinionated changes to index #723

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a63097f
chore: Opinionated changes to index
nicknamenamenick Mar 5, 2024
54c1ee3
chore: fix capitalization and grammar
nicknamenamenick Mar 5, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 27 additions & 20 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ hide:

# Custom Operating System images based on Fedora

This is a collection of container images using Fedora's support for OCI/Docker containers as a [transport and delivery mechanism for operating system content](https://fedoraproject.org/wiki/Changes/OstreeNativeContainerStable). That's nerdspeak for the ultimate Linux client: the reliability of a Chromebook, but with the flexibility and power of a traditional Linux desktop. At long last, we've ascended.
This is a collection of container images using Fedora's support for OCI/Docker containers as a [transport and delivery mechanism for operating system content](https://fedoraproject.org/wiki/Changes/OstreeNativeContainerStable). That's nerd-speak for the ultimate Linux client: the reliability of a Chromebook, but with the flexibility and power of a traditional Linux desktop. At long last, we've ascended!

This project provides:

Expand All @@ -22,27 +22,31 @@ This project provides:

</div>

Our main images offer GNOME, KDE, XFCE, LXQt, Budgie, and MATE, with more being [added regularly](https://github.com/orgs/ublue-os/packages). Our [NVIDIA images](https://github.com/orgs/ublue-os/packages?repo_name=nvidia) offer a unique blend of reliability and ease of use that you won't find anywhere else. These are offered in a variety of images to fit your needs:
Our main images offer GNOME, KDE, XFCE, LXQt, Budgie, and MATE, with more being [added regularly](https://github.com/orgs/ublue-os/packages). Our [NVIDIA images](https://github.com/orgs/ublue-os/packages?repo_name=nvidia) offer a unique blend of reliability and ease of use that you won't find anywhere else.

These are offered in a variety of images to fit the needs of your hardware:

- [Asus](https://github.com/orgs/ublue-os/packages?repo_name=asus) - Fedora-based images with [asus-linux.org](https://asus-linux.org) kernels
- [Framework](https://github.com/orgs/ublue-os/packages?repo_name=framework) - Framework's recommended Fedora settings
- [Surface](https://github.com/orgs/ublue-os/packages?repo_name=surface) - Fedora-based images with [linux-surface](https://github.com/linux-surface/linux-surface) kernels

## End-User Focused Images

Check out [Bazzite](https://bazzite.gg), the ultimate gaming setup for your PC, Steam Deck, ASUS ROG Ally and Legion Go. Fedora's upstream pipeline automated directly to your device, nice.
- [Bazzite](https://bazzite.gg) - The ultimate gaming setup for your PC, Steam Deck, ASUS ROG Ally and Legion Go. Fedora's upstream pipeline automated directly to your device, nice.

[Bluefin](https://universal-blue.discourse.group/c/bluefin/6) is a simple to use desktop with the mission of serving a mass audience. The [Bluefin DX](https://universal-blue.discourse.group/t/bluefin-dx-the-bluefin-developer-experience/39) edition is designed to be the ultimate Linux workstation for open source developers.
- [Bluefin](https://projectbluefin.io/) - A simple to use desktop with the mission of serving a mass audience.

- [Bluefin DX Edition](https://universal-blue.discourse.group/docs?topic=39) - Designed to be the ultimate Linux workstation for open source developers.

## Why would I use these?
### Why would I use these?

These images reflect a more [cloud-native](https://en.wikipedia.org/wiki/Cloud-native_computing) approach to running Linux on your desktop. We feel that a dedicated group of enthusiasts can automate a large amount of toil that plagues existing Linux desktops today. This is achieved by reusing cloud technologies as a delivery mechanism to deliver a more reliable experience. To quote the [goals of bootc](https://github.com/containers/bootc):
These images reflect a more [cloud-native](https://about.gitlab.com/topics/cloud-native/) approach to running Linux on your desktop. We feel that a dedicated group of enthusiasts can automate a large amount of toil that plagues existing Linux desktops today. This is achieved by reusing cloud technologies as a delivery mechanism to deliver a more reliable experience, and to quote the [goals of `bootc`](https://github.com/containers/bootc):

> A toplevel goal is that every tool and technique a Linux system administrator knows around how to build, inspect, mirror and manage application containers also applies to bootable host systems.
> "A top-level goal is that every tool and technique a Linux system administrator knows around how to build, inspect, mirror and manage application containers also applies to bootable host systems."

We like the sound of that, and we're hoping to be your "Desktop DevOps team". Bringing the patterns from the server world to the desktop world means that there is a new layer on top of the distribution. You can now atomically share maintenance of things that people currently do by hand as post-installation. Universal Blue automates that. Contributors use a [gitops approach](https://github.com/open-gitops/documents/blob/main/PRINCIPLES.md) to maintaining these images, all out in the open for everyone to inspect, resulting in a system that now leverages the expertise of system administrators right to your desktop. It's pretty awesome.
We like the sound of that, and we're hoping to be your "Desktop DevOps" team. Bringing the patterns from the server world to the desktop world means that there is a new layer on top of the distribution.

If you want to learn, come hang out. We are here to teach and learn from each other!
Users can now atomically share maintenance of things that people currently do by hand as post-installation. Universal Blue automates these changes. Contributors use a [GitOps approach](https://github.com/open-gitops/documents/blob/main/PRINCIPLES.md) to maintaining these images, all out in the open for anyone to inspect, resulting in a system that now leverages the expertise of system administrators right to your desktop.

<iframe width="560" height="315" src="https://www.youtube.com/embed/vZ1LRe_foJY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

Expand All @@ -54,41 +58,44 @@ If you want to learn, come hang out. We are here to teach and learn from each ot
- No compiling or building Nvidia drivers on the local client, they come pre-made on the image
- [Kernel mods](https://github.com/ublue-os/akmods) right on the image
- Clean separation of the base system from applications and your data
- Integration of Flatpak applications via [Flathub](https://flathub.org/home).
- Integration of Flatpak applications via [Flathub](https://flathub.org/home)
- [Toolbox](https://github.com/containers/toolbox) and [Distrobox](https://github.com/89luca89/distrobox) support, run applications from any distribution in a containerized environment
- Unbridled customization
- Craft your perfect image from scratch or derive from others
- Community Maintained
- The project is maintained by a community of cloud-native contributors with an [explicit mission](/mission)
- Reuses standards-based tooling from cloud
- Built using ostree-enabled [OCI compliant images](https://opencontainers.org/)
- Built using OSTree-enabled [OCI compliant images](https://opencontainers.org/)
- Built-in container tools for developers
- Consume packages and software from any repo without risking breakage on the client
- Easy consumption of other OCI images, if it's on the [CNCF Landscape](https://landscape.cncf.io/) it's a first class citizen thanks to Podman!
- Easy consumption of other OCI images if it's on the [CNCF Landscape](https://landscape.cncf.io/)
- It's a first class citizen thanks to Podman

!!! example "What we mean by reliability:"

An important concept with this model is that the system is designed to reliably deliver your software. Software bugs and issues still occur with individual software. We mean reliability when it comes to installation and upgrades of the entire system, if you were destined to get a kernel bug that day, it still happens. This might sound counterintuitive at first, but be level of efficiency improves so dramatically over the long term that it allows developers to catch issues earlier in the testing process. This is awesome stuff, ask your local cloud nerd.

### Other Features

- Rebase back to pure [Fedora](https://getfedora.org/en/) without reinstallation. This is why we don't call it a distribution, it's an atomic layer of customization on an existing distribution that can be removed.
- Rebase back to pure [Fedora](https://getfedora.org/en/) without reinstallation
- This is why we don't call it a distribution, it's an atomic layer of customization on an existing distribution that can be removed
- Fast updates: minimum of once-a-day updates so you're never behind Fedora
- Hosted on [ghcr.io](https://github.com/features/packages):
- Ninety (_90_) days of image archives allowing for flexible rollback options
- Globally distributed via CDN for fast image downloads, thanks Microsoft!
- Images signed with standard [sigstore tools](https://www.sigstore.dev/)
- And some more features explained here:
- More features are explained in this video:

<iframe width="560" height="315" src="https://www.youtube.com/embed/X8h304Jp9N8?start=435" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
<iframe width="560" height="315" src="https://www.youtube.com/embed/X8h304Jp9N8?start=435" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

## Join Us
<hr>

We're always looking for people to help, all skill levels and areas of expertise are welcome. Check out [the roadmap](https://github.com/orgs/ublue-os/projects/1) to get a feel for the project, then:
## Join Us
If you want to learn, come hang out on our [forums](https://universal-blue.discourse.group/). We are here to teach and learn from each other! We're always looking for people to help, all skill levels and areas of expertise are welcome. Check out [the roadmap](https://github.com/orgs/ublue-os/projects/1) to get a feel for the project, then:

- Discuss the project with us on [Discourse](https://universal-blue.discourse.group/).
- Discuss the project with us on [Discourse forums](https://universal-blue.discourse.group/).
- [Join our Discord](https://discord.gg/WEu6BdFEtp)
- We strive for a safe, inclusive community.
- Pull requests encouraged and accepted.
- Pull requests are encouraged.

If you're building your own custom images feel free to add them to [our awesome list](https://universal-blue.discourse.group/t/list-of-community-created-custom-images/340)!
If you're building your own custom images feel free to add them to [our awesome list](https://universal-blue.discourse.group/docs?topic=340)!
Loading