https://github.com/dverdonschot/fedora-cosmic-atomic-ewt
https://github.com/dverdonschot/fedora-cosmic-atomic-ewt
atomic bluebuild bluebuild-image custom-image image-based immutable linux linux-custom-image oci oci-image operating-system
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/dverdonschot/fedora-cosmic-atomic-ewt
- Owner: dverdonschot
- License: apache-2.0
- Created: 2025-10-30T16:12:26.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-05-15T06:47:30.000Z (about 1 month ago)
- Last Synced: 2026-05-15T08:46:41.548Z (about 1 month ago)
- Topics: atomic, bluebuild, bluebuild-image, custom-image, image-based, immutable, linux, linux-custom-image, oci, oci-image, operating-system
- Language: Shell
- Size: 199 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# fedora-cosmic-atomic-ewt [](https://github.com/dverdonschot/fedora-cosmic-atomic-ewt/actions/workflows/build.yml)
A custom Fedora Atomic image built on COSMIC desktop environment, featuring personal customizations and development tools.
## Features
- **COSMIC Desktop Environment:** Modern, Rust-based desktop from System76
- **Development Tools:** Pre-configured with Rust, Node.js, Python, and more
- **Virtualization Ready:** libvirt, QEMU, virt-manager included
- **AMD GPU Stability Fixes:** Automatic kernel parameters for Radeon graphics
- **COSMIC Vimified:** Keyboard-driven hint navigation (in development)
## Projects in this Repository
### COSMIC Vimified
A keyboard-driven hint navigation system for COSMIC desktop, inspired by the Vimium browser extension. This allows mouseless interaction with GUI elements across your entire desktop.
**Status:** Planning & Specification Phase
See [cosmic-vimified/README.md](cosmic-vimified/README.md) for details.
## Installation
> [!WARNING]
> [This is an experimental feature](https://www.fedoraproject.org/wiki/Changes/OstreeNativeContainerStable), try at your own discretion.
To rebase an existing atomic Fedora installation to the latest build:
- First rebase to the unsigned image, to get the proper signing keys and policies installed:
```
rpm-ostree rebase ostree-unverified-registry:ghcr.io/dverdonschot/fedora-cosmic-atomic-ewt:latest
```
- Reboot to complete the rebase:
```
systemctl reboot
```
- Then rebase to the signed image, like so:
```
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/dverdonschot/fedora-cosmic-atomic-ewt:latest
```
- Reboot again to complete the installation
```
systemctl reboot
```
The `latest` tag will automatically point to the latest build. That build will still always use the Fedora version specified in `recipe.yml`, so you won't get accidentally updated to the next major version.
## ISO
If build on Fedora Atomic, you can generate an offline ISO with the instructions available [here](https://blue-build.org/learn/universal-blue/#fresh-install-from-an-iso). These ISOs cannot unfortunately be distributed on GitHub for free due to large sizes, so for public projects something else has to be used for hosting.
## Post-Installation Configuration
### AMD GPU Stability (Built-in)
This image includes AMD GPU stability fixes for systems with AMD Radeon integrated graphics (tested on Radeon 780M). The following kernel parameters are automatically applied:
- `amdgpu.gpu_recovery=1` - Enables GPU recovery mechanisms
- `amdgpu.ppfeaturemask=0xffffffff` - Enables all power play features
These fixes address spontaneous reboot issues related to GPU power state restoration failures. No manual configuration is needed.
### Optional: CPU C-State Configuration (AMD CPUs)
If you still experience issues with deep CPU sleep states after the GPU fixes above, you can limit CPU C-states:
```bash
rpm-ostree kargs --append=processor.max_cstate=3
systemctl reboot
```
**Note:** The incorrect Intel-specific parameter `intel_idle.max_cstate=5` should NOT be used on AMD systems. Use `processor.max_cstate` instead, which works on both Intel and AMD CPUs.
This setting persists across updates and only needs to be applied once.
## Verification
These images are signed with [Sigstore](https://www.sigstore.dev/)'s [cosign](https://github.com/sigstore/cosign). You can verify the signature by downloading the `cosign.pub` file from this repo and running the following command:
```bash
cosign verify --key cosign.pub ghcr.io/dverdonschot/fedora-cosmic-atomic-ewt
```