https://github.com/yasershahi/bluestream
A custom Fedora Silverblue image with development tools, multimedia support, and Intel GPU optimization
https://github.com/yasershahi/bluestream
bootc fedora fedora-silverblue immutable linux-desktop
Last synced: 7 months ago
JSON representation
A custom Fedora Silverblue image with development tools, multimedia support, and Intel GPU optimization
- Host: GitHub
- URL: https://github.com/yasershahi/bluestream
- Owner: yasershahi
- License: gpl-3.0
- Created: 2025-03-15T09:34:41.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-06-04T06:26:07.000Z (8 months ago)
- Last Synced: 2025-06-04T07:59:01.851Z (8 months ago)
- Topics: bootc, fedora, fedora-silverblue, immutable, linux-desktop
- Language: Dockerfile
- Homepage:
- Size: 87.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BlueStream
A custom Fedora Silverblue 42 image built on top of bootc-based Fedora Silverblue with RPM Fusion (free & nonfree) and Terra repositories enabled. Optimized for developers and power users with additional tools and multimedia support.
[](https://github.com/yasershahi/bluestream/actions/workflows/build.yml)
## Features
- 🛠️ **Developer Tools**
- VS Code
- Docker & Podman with Compose
- Distrobox
- Android Tools & Scrcpy
- Neovim
- tmux
- 🎥 **Multimedia Support**
- FFmpeg with all codecs
- Hardware acceleration for Intel GPUs
- GStreamer plugins
- HEIF support
- 🔧 **System Utilities**
- Fish shell
- fastfetch
- lm_sensors
- p7zip & unrar
- Tailscale
- 🌐 **Web Browsers**
- Ungoogled Chromium
## Before Rebasing
It's recommended to reset rpm-ostree and pin your current deployment before rebasing. This ensures you can return to your current state if needed:
```bash
# View available deployments
rpm-ostree status
# Pin your current deployment (0 is usually the active deployment)
sudo ostree admin pin 0
# Switch to bootc
sudo bootc switch quay.io/fedora/fedora-silverblue:42
# After switch, reboot the system
systemctl reboot
```
## Rebase to BlueStream
### Rebase Command
```bash
# Optional: Verify image signature before switching (recommended)
cosign verify --key cosign.pub ghcr.io/yasershahi/bluestream:42
# Switch to BlueStream
sudo bootc switch ghcr.io/yasershahi/bluestream:42
# After the rebase, reboot the system
systemctl reboot
```
Note: While bootc doesn't handle signature verification automatically, you can manually verify the image's signature using Cosign before switching. The public key (cosign.pub) is provided in this repository.
## Pre-configured Features
- RPM Fusion (free & nonfree) repositories
- Terra repository from Fyra Labs
- Hardware video acceleration for Intel GPUs
- Faster boot with NetworkManager wait disabled
- Flathub repository enabled by default
- Common GNOME extensions removed for a cleaner experience
- Optimized systemd timeout settings
> **Notice:** After first boot, the flatpak-replace-fedora-apps service will automatically remove applications installed from the Fedora Flatpak repository and replace them with their Flathub versions. Consider that this process will use additional internet traffic to download the Flathub versions of those apps.
## Post-install Steps (Optional)
After installing BlueStream, you may want to perform some additional setup for a better experience:
### Docker Setup
Docker is provided in this image, but you need to perform a few steps to enable it for your user:
1. **Create the docker group (if it doesn't exist):**
```sh
sudo groupadd docker
```
2. **Add your user to the docker group:**
```sh
sudo usermod -aG docker $USER
```
3. **Enable Docker and containerd services:**
```sh
sudo systemctl enable docker.service
sudo systemctl enable containerd.service
```
4. **Apply group changes without rebooting:**
```sh
newgrp docker
```
After these steps, you should be able to use Docker as your regular user without sudo.
### Change Default Shell to Fish
Fish shell is included in this image. If you wish to use it as your default shell, follow these steps:
1. **Run fish for the first time:**
```sh
fish
```
2. **Locate the installed path:**
```sh
which fish
# Should output: /usr/sbin/fish
```
3. **Add fish to /etc/shells (if not already present):**
```sh
echo /usr/sbin/fish | sudo tee -a /etc/shells
```
4. **Change your default shell to fish:**
```sh
chsh -s /usr/sbin/fish
```
5. **Reopen your terminal. To disable the Fish welcome message:**
```sh
nano ~/.config/fish/config.fish
```
Add this line to the file:
```sh
set -g fish_greeting ""
```
You may need to log out and log back in for the shell change to take effect.
### (Optional) Install Fisher (Fish Plugin Manager)
Fisher is a popular plugin manager for Fish shell. To install it, run:
```sh
curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source && fisher install jorgebucaran/fisher
```
For more information and plugin usage, see the [Fisher GitHub page](https://github.com/jorgebucaran/fisher).
### (Optional) Enhance Your Fish Shell with Starship Prompt
1. **Install a Nerd Font** (required for best Starship experience):
- Download and install a font like JetBrainsMono from [Nerd Fonts](https://www.nerdfonts.com/).
2. **Install Starship prompt:**
```sh
curl -sS https://starship.rs/install.sh | sh
```
3. **Configure Fish shell to initialize Starship:**
```sh
nano ~/.config/fish/config.fish
```
Add this line to the end of the file:
```sh
starship init fish | source
```
4. **(Optional) Use a Starship preset:**
- See available [Starship presets](https://starship.rs/presets/)
- Example (Pure preset):
```sh
starship preset pure-preset -o ~/.config/starship.toml
```
After these steps, your Fish shell will have a beautiful, fast, and informative prompt!
### Container Development with Toolbox and Distrobox
BlueStream includes both Toolbox and Distrobox for containerized development environments.
#### Toolbox Setup
Toolbox provides a Fedora container that works like a regular Fedora workstation:
1. **Create and enter a toolbox:**
```sh
toolbox enter
```
This will automatically set up a Fedora container on first run.
2. **Access named toolboxes:**
```sh
toolbox enter
```
3. **GUI access:** Toolboxes appear in your default terminal.
For more information, visit the [Toolbox documentation](https://containertoolbx.org/).
#### Distrobox for Multi-Distribution Support
For access to other Linux distributions, Distrobox is recommended:
1. **Install a GUI manager** (choose one):
- [DistroShelf](https://flathub.org/apps/com.ranfdev.DistroShelf) - `flatpak install flathub com.ranfdev.DistroShelf`
- [BoxBuddy](https://flathub.org/apps/io.github.dvlv.boxbuddyrs) - `flatpak install flathub io.github.dvlv.boxbuddyrs`
2. **Benefits:** Access to any distribution's packages - from Debian/Ubuntu repositories to Arch AUR packages, all in friendly GUI app.
## Disclaimer
Fedora® is a registered trademark of Red Hat, Inc. This project is not affiliated with, endorsed by, or sponsored by the Fedora Project or Red Hat, Inc.
This image is provided "as is" without warranty of any kind, either express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability arising from, out of, or in connection with the image or the use or other dealings in the image.
The user assumes all responsibility for the use of this image, including but not limited to:
- Backing up data before use
- Testing compatibility with their hardware and use case
- Understanding that this is a community project and comes with no warranties or guarantees