system
System maintenance for Bazzite OS. Updates via topgrade, cleanup of podman/flatpaks,viewing logs and changelogs, diagnostics, and power measurements. Use when usersneed to update, clean, or diagnose their Bazzite system.
When & Why to Use This Skill
The Bazzite System Maintenance skill is a comprehensive utility designed to streamline the management of Bazzite OS. It provides an automated interface for performing critical system tasks including full updates via topgrade, disk space optimization by cleaning up podman and flatpak resources, and advanced system diagnostics. By integrating logging, benchmarking, and power measurement tools, it enables users to maintain peak system performance and resolve technical issues efficiently through a simplified command structure.
Use Cases
- Routine Maintenance: Executing full system updates and cleaning up unused container images or orphaned flatpak runtimes to ensure a lean and updated OS.
- Troubleshooting & Support: Accessing current or previous boot logs to diagnose crashes and generating shareable pastebin links for system logs and device info to facilitate technical support.
- Performance Optimization: Measuring idle power consumption and running stress-test benchmarks to evaluate hardware health and battery efficiency.
- System Configuration: Toggling automatic updates and switching between standard and enhanced CLI experiences (Bluefin-style) to customize the user environment.
| name | system |
|---|---|
| description | | |
System - Bazzite System Maintenance
Overview
The system skill covers core Bazzite maintenance tasks: updates, cleanup, logging, diagnostics, and benchmarking.
Quick Reference
| Command | Description |
|---|---|
ujust update |
Update system via topgrade |
ujust upgrade |
Alias for update |
ujust changelogs |
View stable release notes |
ujust changelogs-testing |
View pre-release notes |
ujust toggle-updates |
Enable/disable automatic updates |
ujust clean-system |
Cleanup podman, flatpaks, rpm-ostree |
ujust logs-this-boot |
Current boot journal logs |
ujust logs-last-boot |
Previous boot journal logs |
ujust get-logs |
Upload logs to pastebin |
ujust device-info |
Upload device info to pastebin |
ujust check-idle-power-draw |
Measure idle power with powerstat |
ujust check-local-overrides |
Compare /usr/etc vs /etc |
ujust benchmark |
1-minute stress test |
ujust bazzite-cli |
Toggle Bluefin CLI experience |
Updates
Update System
# Full system update (flatpaks, containers, rpm-ostree)
ujust update
# Same as update
ujust upgrade
Uses topgrade to update:
- Flatpak applications
- Podman containers
- rpm-ostree packages
- System components
View Changelogs
# Stable release notes
ujust changelogs
# Pre-release/testing notes
ujust changelogs-testing
Automatic Updates
# Toggle uupd.timer (automatic updates)
ujust toggle-updates
Cleanup
# Clean podman images, flatpaks, rpm-ostree content
ujust clean-system
Removes:
- Unused podman images
- Orphaned flatpak runtimes
- Old rpm-ostree deployments
Logging
View Logs
# Current boot
ujust logs-this-boot
# Previous boot (useful after crash)
ujust logs-last-boot
Share Logs
# Upload system logs to pastebin for support
ujust get-logs
# Upload device info to pastebin
ujust device-info
Returns a pastebin URL to share with support.
Diagnostics
Power Measurement
# Measure idle power draw
ujust check-idle-power-draw
Uses powerstat to measure system power consumption.
Local Overrides
# Compare /usr/etc vs /etc
ujust check-local-overrides
Shows files in /etc that override /usr/etc defaults.
Benchmarking
# 1-minute stress test
ujust benchmark
Uses stress-ng to benchmark CPU, memory, and I/O.
CLI Experience
# Toggle Bluefin-style CLI (bling)
ujust bazzite-cli
Enables/disables enhanced CLI features from Bluefin.
Common Workflows
Weekly Maintenance
# Update everything
ujust update
# Clean unused resources
ujust clean-system
Troubleshooting Crashes
# Check previous boot logs
ujust logs-last-boot
# Share logs for support
ujust get-logs
Performance Testing
# Run benchmark
ujust benchmark
# Check power draw
ujust check-idle-power-draw
Troubleshooting
Update Fails
Check: Network connectivity, disk space
# Manual rpm-ostree update
rpm-ostree upgrade
# Check for pending changes
rpm-ostree status
Logs Too Long
Use journalctl filters:
# Last 100 lines
journalctl -n 100
# Since specific time
journalctl --since "1 hour ago"
# Specific unit
journalctl -u <service-name>
Cross-References
- bazzite-ai:configure - Service configuration
- bazzite:boot - Boot and GRUB settings
- bazzite:storage - Disk management and snapshots
When to Use This Skill
Use when the user asks about:
- "update bazzite", "upgrade system", "system update"
- "view changelog", "release notes", "what's new"
- "clean up system", "free disk space", "remove unused"
- "view logs", "system logs", "check journal"
- "share logs", "upload logs", "support pastebin"
- "power consumption", "idle power", "battery"
- "benchmark", "stress test", "performance"
- "automatic updates", "disable updates"