An interactive post-installation script for Fedora 44 Workstation (GNOME).
Built from years of actual Fedora usage, covering the things I find myself setting up on every fresh install: driver detection, multimedia codecs, dev tools, gaming, shell customization, Docker, and virtualization.
Note
Architecture Support: This script is engineered with architecture-aware detection supporting x86_64 and aarch64 architectures across AMD, Intel, and NVIDIA hardware, with vendor-specific GPU driver compilation and GPU compute runtimes (CUDA / ROCm / Level Zero).
- Interactive: every step asks before running; nothing happens behind your back
- Hardware-aware: detects Intel / AMD / NVIDIA GPUs, hybrid Optimus setups, chassis type (laptop vs desktop), and CPU virtualization support
- Secure Boot-aware NVIDIA setup: builds kernel modules, generates keys, and walks you through MOK enrollment
- Idempotent: state file tracks what's done; you can interrupt and pick up where you left off, or
--forceto re-run - Profile-based: six profiles with layered modular architecture so you only install what you actually need
- Dry-run mode: preview everything without touching the system
- Backup and restore: backs up config files before modifying them
- Plain English guide: see HOW_IT_WORKS.md for a friendly, creative layman walkthrough and transformation guide
- Visual architecture: see PSEUDOCODE.md for end-to-end Mermaid flowcharts and step-by-step logic specs
- Curl-Ready One-Liner Execution: Full support for interactive execution via
bash -c "$(curl -fsSL ...)"andcurl -fsSL ... | bashwith automatic/dev/ttyfallback handling. - Systemd Drop-In ZRAM & Memory Tuning: Migrated to
/etc/systemd/zram-generator.conf.d/10-zram.conf, removed the arbitrary 16GB RAM cap in favor of dynamic full-RAM allocation (zram-size = ram), and applied high-performance zstd kernel sysctl parameters (swappiness = 180,watermark_scale_factor = 125,watermark_boost_factor = 0). - Zero-Trust Security & Git Protection: Removed silent
core.pager catclobbering, gated git workflow settings behind explicit confirmation with automated backups of~/.gitconfig, and made sudo asterisk feedback opt-in. - Hardware-Agnostic Multi-Monitor Safety: Added external display safety checks and confirmation prompts to hybrid Vulkan priority configuration, protecting laptops with display outputs wired directly to discrete GPUs.
- Ghostty Tab Alignment & Filesystem Hygiene: Corrected Ghostty configuration path to
config.ghosttyenforcing tab layout defaults, and moved third-party clones into~/.local/share/.
See CHANGELOG.md for the full history.
Run directly via curl without cloning the repository:
# Full profile, interactive
bash -c "$(curl -fsSL https://raw.githubusercontent.com/kk376/fedora-post-install/main/setup.sh)"
# Preview dev profile without making changes
bash -c "$(curl -fsSL https://raw.githubusercontent.com/kk376/fedora-post-install/main/setup.sh)" -- --profile=dev -n# Clone repository
git clone https://github.com/kk376/fedora-post-install.git
cd fedora-post-install
# Full profile, interactive
./setup.sh
# Preview without changes
./setup.sh --dry-run
# Re-run already-completed steps
./setup.sh --forceWhen run interactively without options, ./setup.sh displays a menu to select your desired profile directly from the terminal:
minimal(4 steps)workstation(11 steps)dev(15 steps: includes prompt for developer genres: systems, web, android, ai, or all)gaming(12 steps)creator(12 steps)full(17 steps: default)
| Profile | Steps | What it installs |
|---|---|---|
minimal |
4 | DNF config, DNS, core CLI utilities, shell (Fish/Zsh/Bash) & terminal |
workstation |
11 | Minimal + fonts, codecs & dynamic PipeWire audio, GNOME tweaks, desktop apps, power, GPU drivers (last) |
dev |
15 | Workstation + developer toolchains (--dev-type), Code Editor, Docker & Compose, KVM/QEMU, GPU drivers (last) |
gaming |
12 | Workstation + Steam (H.264 unlock), MangoHud, GameMode, Heroic Games Launcher, GPU drivers (last) |
creator |
12 | Workstation + OBS Studio, v4l2loopback, wf-recorder, NVIDIA Broadcast, GPU drivers (last) |
full |
17 | Complete power-user suite: Workstation + Dev + Gaming + Creator + GPU drivers |
- Architecture:
x86_64oraarch64(AMD, Intel, NVIDIA). - OS: Fedora 44 Workstation
- Desktop: GNOME
- Disk: At least 20GB free (varies by profile)
- Tested on: Intel, AMD, and NVIDIA systems, both desktop and laptop
- Some steps require a reboot (GPU drivers, Docker group, Secure Boot, KVM)
- NVIDIA users: read the Secure Boot prompts carefully; follow the MOK enrollment steps when prompted and complete key enrollment on reboot
- Default shell change (interactive choice for Fish, ZSH, or Bash in Dev and Full profiles) requires a logout/login
- The VSCodium repository is imported with official GPG key verification (
https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg).
DNF optimization (parallel downloads, fastest mirror, version pinning), RPM Fusion, Flathub, optional DNS override (Cloudflare or Google), disable auto-sleep (GDM system dconf keyfile + user session), system fonts and FiraCode Nerd Font.
Fish (recommended default) and ZSH, syntax highlighting, autosuggestions, clean modern aliases (clear, ls, cat, less). Developer and full profiles feature interactive login shell selection (Fish, ZSH, Bash), an interactive prompt for Starship cross-shell prompt installation with feature disclaimer, and a dedicated menu for developer environment exports and Git aliases. All other profiles receive clean standard aliases without Starship or developer environment exports. Developer and full profiles also include interactive modern GPU terminal selection (Ghostty recommended, Kitty, or Alacritty) with self-contained Tokyo Night configuration.
TLP (optional, warns about GNOME power profiles conflict), tuned virtual-host profile for KVM.
Brave Browser, FFmpeg freeworld, VA-API / NVENC support, OpenH264.
Intel media driver, AMD freeworld VA/VDPAU, NVIDIA proprietary (akmods, Secure Boot key enrollment with guided walkthrough).
GCC, Clang, LLVM, ccache (interactive disclaimer prompt for 50GB compressed cache in systems genre), Java, Node.js, Python, Ruff linter/formatter, PostgreSQL 18, Docker + Docker Compose, Corepack, Code Editor selection (Zed, VS Codium, Antigravity IDE, or VS Code), Rust (optional), Git LFS & git-filter-repo, Android tools, debuggers, build systems.
Steam (with H.264 unlock), MangoHud (auto-configured with 32px HUD scaling, alpha transparency, and rounded corners), Vesktop, and Heroic Games Launcher (official Flathub Flatpak for Epic/GOG/sideloaded games, pre-configured with disableUMU to eliminate container exit lag, shared wine prefixes, and NVIDIA Prime offload). Included on gaming and full profiles.
KVM/QEMU, libvirt with socket activation, virt-manager, VirtIO drivers for Windows VMs, firewall and storage pool setup.
GNOME Tweaks, Extension Manager, extension recommendations.
The repository includes automated test suites covering all profiles, CLI arguments, helper functions, and backup/restore workflows:
# Run all test suites
bash tests/run_tests.shScript failed mid-run? Re-run it. The state file tracks progress, so it picks up from the last successful step.
Low disk space warning? Free up space or acknowledge the prompt to continue anyway.
Docker not working after install? Reboot to apply group membership, then test:
docker run --rm hello-worldKVM permission denied? Run the post-reboot commands the script shows you, or:
sudo usermod -aG libvirt $USER
# Then rebootNVIDIA drivers not loading? Complete MOK enrollment on reboot (the blue "MOK Manager" screen).
Bluetooth earbuds/headset sound degraded or tinny? When an application (Chrome, Discord, OBS) accesses the microphone, PipeWire switches Bluetooth devices from A2DP Stereo (AAC / SBC-XQ) to HFP/HSP Handsfree (16kHz mono). Fix: Open GNOME Settings ➔ Sound, set Input Device to your laptop's Internal Microphone (not the Bluetooth headset), then disconnect and reconnect Bluetooth.
Chrome / Chromium video playback showing vertical split line on YouTube?
On Linux/Wayland with hybrid AMD/Mesa graphics, Chromium's hardware video decoder can render a 1px seam across viewport tiles.
Fix: In Google Chrome, go to chrome://settings/system ➔ Toggle "Use graphics acceleration when available" to OFF ➔ Relaunch. (Ryzen/Intel multi-core CPU handles 4K/1080p software decode with <3% CPU).
git clone https://github.com/kk376/fedora-post-install.git
cd fedora-post-install
chmod +x setup.sh
./setup.shWant to know exactly what this script does before running it?
- 📖 HOW_IT_WORKS.md: A friendly, creative, plain-English guide covering the "Before vs After" transformation, peace-of-mind safety rules, profile picker, and beginner FAQ.
- 🗺️ PSEUDOCODE.md: Detailed visual Mermaid flowcharts, decision trees, and step-by-step logic specs for all 18 functions and disaster recovery mechanisms.
See CONTRIBUTING.md for contribution guidelines and testing instructions.
MIT. See LICENSE.