bluefin-common

Shared OCI layer containing common configuration files used across all Bluefin variants (bluefin, bluefin-dx, bluefin-lts).

What's Inside

This layer contains two main configuration directories:

/etc/ublue-os/ - System Configuration

• Bling - CLI theming settings
• Fastfetch settings - System information display configuration
• Setup configuration - First-boot and system setup parameters

/usr/share/ublue-os/ - User-Space Configuration

• Firefox defaults - Pre-configured Firefox settings
• Flatpak overrides - Application-specific Flatpak configurations
• Homebrew Brewfiles - Curated application bundles installable via bbrew
  • full-desktop.Brewfile - Full collection of GNOME Circle and community flatpak applications
  • Other specialized Brewfiles for fonts, CLI tools, AI tools, etc.
• Just recipes - Additional command recipes for system management
• MOTD templates - Message of the day and tips
• Setup hooks - Scripts for privileged, system, and user setup stages

Usage in Containerfile

Reference this layer as a build stage and copy the directories you need:

Copy everything:

FROM ghcr.io/ublue-os/bluefin-common:latest AS bluefin-common

# Copy all system files
COPY --from=bluefin-common /system_files /

Copy only system configuration:

This is what Aurora should use, gives shares the common set of files and keeps the images opinions seperate.

FROM ghcr.io/ublue-os/bluefin-common:latest AS bluefin-common

# Copy only /etc configuration
COPY --from=bluefin-common /system_files/etc /etc

Copy only the image opinion:

FROM ghcr.io/ublue-os/bluefin-common:latest AS bluefin-common

# Copy only /usr/share configuration
COPY --from=bluefin-common /system_files/usr /usr

Brewfiles

The /usr/share/ublue-os/homebrew/ directory contains curated application bundles installable via bbrew:

• full-desktop.Brewfile - Comprehensive collection of GNOME Circle and community flatpak applications for a full desktop experience
• fonts.Brewfile - Additional monospace fonts for development
• cli.Brewfile - CLI tools and utilities
• ai-tools.Brewfile - AI and machine learning tools
• cncf.Brewfile - Cloud Native Computing Foundation tools
• k8s-tools.Brewfile - Kubernetes tools
• ide.Brewfile - Integrated development environments
• artwork.Brewfile - Design and artwork applications

Users can install these bundles using the ujust bbrew command, which will prompt them to select a Brewfile.

Building Locally

just build

Contributor Metrics