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

Commit

Permalink
chore: Opinionated changes to index
Browse files Browse the repository at this point in the history
Also fixed some documentation links.
  • Loading branch information
nicknamenamenick authored Mar 5, 2024
1 parent ec4acfe commit a63097f
Showing 1 changed file with 27 additions and 20 deletions.
47 changes: 27 additions & 20 deletions docs/index.md
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) is 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)!

0 comments on commit a63097f

Please sign in to comment.