Skip to content
This repository was archived by the owner on Oct 24, 2026. It is now read-only.
Merged
Changes from all commits
Commits
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
84 changes: 49 additions & 35 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,63 +1,70 @@
# Uranium
# Bluefin LTS

> NOTE: This once was Project Bluefin's LTS it's still close to the original just different branding.
# NOTE THIS IS STAYING IN UBLUE

[![Build Uranium](https://github.com/thallium-suite/uranium/actions/workflows/build-regular.yml/badge.svg)](https://github.com/thallium-suite/uranium/actions/workflows/build-regular.yml)
*Achillobator giganticus*

Long-term support desktop built on CentOS Stream 10 for longer support windows, conservative upgrades, and production-focused workstations.
[![Build Bluefin LTS](https://github.com/projectbluefin/bluefin-lts/actions/workflows/build-regular.yml/badge.svg)](https://github.com/projectbluefin/bluefin-lts/actions/workflows/build-regular.yml) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/10098/badge)](https://www.bestpractices.dev/projects/10098) [![Bluefin LTS on ArtifactHub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/bluefin)](https://artifacthub.io/packages/container/bluefin/bluefin) [![Installs](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ublue-os/countme/main/badge-endpoints/bluefin-lts.json&label=Installs)](https://github.com/projectbluefin/bluefin-lts) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/projectbluefin/bluefin-lts)

Larger, more lethal [Bluefin](https://projectbluefin.io). Built on CentOS Stream 10 for longer support windows, conservative upgrades, and production-focused workstations.

![image](https://github.com/user-attachments/assets/2e160934-44e6-4aee-b2b8-accb3bcf0a41)

## Latest Release

<a href="https://docs.projectbluefin.io/changelogs/">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://docs.projectbluefin.io/img/cards/bluefin-lts-dark.png">
<img src="https://docs.projectbluefin.io/img/cards/bluefin-lts-light.png" alt="Bluefin LTS latest release" width="800">
</picture>
</a>

## Images

### Uranium
Full catalog at [docs.projectbluefin.io/images →](https://docs.projectbluefin.io/images/)

### Bluefin LTS

Long-term support stream built on CentOS Stream 10.
Long-term support Bluefin stream built on CentOS Stream 10.

```bash
# LTS — recommended
sudo bootc switch ghcr.io/thallium-suite/uranium:stable --enforce-container-sigpolicy
sudo bootc switch ghcr.io/projectbluefin/bluefin-lts:stable --enforce-container-sigpolicy
# LTS — NVIDIA
sudo bootc switch ghcr.io/thallium-suite/uranium-nvidia:stable --enforce-container-sigpolicy
sudo bootc switch ghcr.io/projectbluefin/bluefin-lts-nvidia:stable --enforce-container-sigpolicy
```

## Migrating
## Migrating from ublue-os/bluefin-lts

Uranium is published at a new registry path, so existing installs keep
receiving updates from their current image reference and **will not** be moved
automatically. There is no automatic migration: switch explicitly.
Users on the previous `ghcr.io/ublue-os/bluefin*:lts` images will be migrated automatically via a systemd service. No action required — your machine will switch on its next reboot after pulling the update.

| Previous image | Current image |
| Old image (ublue-os) | New image (projectbluefin) |
|---|---|
| `ghcr.io/projectbluefin/bluefin-lts:stable` | `ghcr.io/thallium-suite/uranium:stable` |
| `ghcr.io/projectbluefin/bluefin-lts-nvidia:stable` | `ghcr.io/thallium-suite/uranium-nvidia:stable` |
| `ghcr.io/projectbluefin/bluefin-lts-hwe:stable` | `ghcr.io/thallium-suite/uranium:stable` |
| `ghcr.io/projectbluefin/bluefin-dx-hwe:stable` | `ghcr.io/thallium-suite/uranium:stable` + run `ujust devmode` after reboot |
| `ghcr.io/ublue-os/bluefin:lts` (legacy) | `ghcr.io/thallium-suite/uranium:stable` |
| `ghcr.io/ublue-os/bluefin:lts-hwe` (legacy) | `ghcr.io/thallium-suite/uranium:stable` |
| `ghcr.io/ublue-os/bluefin-dx:lts` (legacy) | `ghcr.io/thallium-suite/uranium:stable` + run `ujust devmode` after reboot |
| `ghcr.io/ublue-os/bluefin-dx:lts-hwe` (legacy) | `ghcr.io/thallium-suite/uranium:stable` + run `ujust devmode` after reboot |
| `ghcr.io/ublue-os/bluefin-gdx:lts` (legacy) | `ghcr.io/thallium-suite/uranium-nvidia:stable` + run `ujust devmode` after reboot |
| arm64 variants | No in-place migration — reinstall from the current image |
| `bluefin:lts` | `bluefin-lts:stable` |
| `bluefin:lts-hwe` (legacy tag) | `bluefin-lts:stable` |
| `bluefin-dx:lts` | `bluefin-lts:stable` + run `ujust devmode` after reboot |
| `bluefin-dx:lts-hwe` (legacy tag) | `bluefin-lts:stable` + run `ujust devmode` after reboot |
| `bluefin-gdx:lts` | `bluefin-lts-nvidia:stable` + run `ujust devmode` after reboot |
| arm64 variants | No automatic migration — reinstall from new image |

To migrate manually before the automatic migration ships:

```bash
sudo bootc switch ghcr.io/thallium-suite/uranium:stable --enforce-container-sigpolicy
sudo bootc switch ghcr.io/projectbluefin/bluefin-lts:stable --enforce-container-sigpolicy
```

### HWE note
## Getting Started

If you are currently on a `bluefin-lts-hwe` or `ublue-os/bluefin:lts-hwe` image, you are
already running the Fedora CoreOS stable kernel — the same kernel track Uranium uses
for **all** of its builds. Uranium does not publish a separate HWE variant; the
hardware-enablement kernel and common akmods (xone, OpenRazer, Framework laptop,
v4l2loopback) ship in every Uranium image by default. No action is needed for the
kernel: switching to Uranium keeps you on the same newer kernel and module set.
Visit **[projectbluefin.io](https://projectbluefin.io/#scene-picker)** to download Bluefin LTS, or check the **[LTS Documentation](https://docs.projectbluefin.io/lts/)** for installation and upgrade instructions.

Rebasing between the Fedora-based Amotic family and Uranium is not supported.
Plan migrations as fresh installs or supported upgrade paths.
Rebasing between the Bluefin (Fedora) and Bluefin LTS (CentOS) image families is not supported. Plan migrations as fresh installs or supported upgrade paths.

## Community

Uranium has no community infrastructure of its own yet. Until it does, use this
repository's [issue tracker](https://github.com/thallium-suite/uranium/issues)
- 📰 **[Blog](https://blog.projectbluefin.io/)** — announcements and release posts
- 💬 **[Discussions](https://community.projectbluefin.io/)** — community forum
- 📋 **[Project Board](https://todo.projectbluefin.io/)** — what we're working on
- 📖 **[Documentation](https://docs.projectbluefin.io/)** — user guides and reference

## Contributing

Expand All @@ -69,4 +76,11 @@ Report security vulnerabilities via [SECURITY.md](SECURITY.md).

Apache License 2.0 — see [LICENSE](LICENSE).

Bluefin LTS incorporates [CentOS Stream](https://www.centos.org/centos-stream/), [GNOME](https://www.gnome.org/), [Universal Blue](https://universal-blue.org/), and various CNCF projects, each under their respective licenses.
Report security vulnerabilities via [SECURITY.md](SECURITY.md).

## License

Apache License 2.0 — see [LICENSE](LICENSE).

Uranium incorporates [CentOS Stream](https://www.centos.org/centos-stream/), [GNOME](https://www.gnome.org/), [Universal Blue](https://universal-blue.org/), and various CNCF projects, each under their respective licenses.
Loading