Storage

Storage - Bazzite Storage Management

Overview

Bazzite supports automatic mounting of drives, BTRFS features like deduplication and snapshots, and disk optimization with rmlint.

Quick Reference

Automounting

BTRFS Features

Automounting

Standard Automounting

# Enable automounting for BTRFS/EXT4 labeled partitions
ujust enable-automounting

# Disable
ujust disable-automounting

Mounts drives with recognized labels at:

• /run/media/$USER/<label>

Framework Laptop

# Enable Framework-specific automounting
ujust enable-framework-automount

# Disable
ujust disable-framework-automount

Handles Framework expansion cards and storage modules.

SteamOS Mounts

# Enable SteamOS-style automounting
ujust enable-steamos-automount

# Disable
ujust disable-steamos-automount

Compatibility with SteamOS mount paths.

All Automounting

# Enable everything
ujust enable-automount-all

# Disable everything
ujust disable-automount-all

BTRFS Deduplication

Enable Deduplication

# Enable BTRFS deduplication for /var/home
ujust enable-deduplication

Benefits:

• Saves space with duplicate files
• Runs in background
• Minimal performance impact

Note: Only for BTRFS partitions.

Disk Trimming

Enable rmlint

# Enable/disable rmlint trim feature
ujust enable-rmlint

rmlint finds and removes:

• Duplicate files
• Empty directories
• Broken symlinks
• Other disk clutter

Snapshots

Configure Snapper

# Enable/disable snapper snapshots for /var/home
ujust config-snapshots

Snapper:

• Creates automatic snapshots
• Allows rollback of /var/home
• Timeline-based retention

Warning: Snapshots use disk space.

Common Workflows

Add External Drive

# Enable automounting
ujust enable-automounting

# Plug in drive - mounts automatically
# Access at /run/media/$USER/<label>

Space Optimization

# Enable deduplication
ujust enable-deduplication

# Enable rmlint for cleanup
ujust enable-rmlint

Backup with Snapshots

# Enable snapshots
ujust config-snapshots

# View snapshots
snapper list

# Rollback
snapper rollback <number>

Framework Setup

# Enable Framework automounting
ujust enable-framework-automount

# Expansion cards auto-mount when inserted

Manual Mount Management

Mount Manually

# Create mount point
sudo mkdir -p /mnt/data

# Mount
sudo mount /dev/sdb1 /mnt/data

# Mount BTRFS with options
sudo mount -o compress=zstd /dev/sdb1 /mnt/data

Add to fstab

# Get UUID
lsblk -o NAME,UUID,FSTYPE

# Edit fstab
sudo nano /etc/fstab

# Add line:
# UUID=<uuid> /mnt/data btrfs defaults,compress=zstd 0 0

Verification

Check Mounts

# List mounts
mount | grep -E "/dev/sd|/dev/nvme"

# List block devices
lsblk

# Check BTRFS usage
btrfs filesystem usage /var/home

Check Deduplication

# Check dedup status
btrfs filesystem df /var/home

Check Snapshots

# List snapshots
snapper list

# Snapshot details
snapper status <number>

Troubleshooting

Drive Not Automounting

Check label:

lsblk -o NAME,LABEL,FSTYPE

Check automount status:

# Is automounting enabled?
gsettings get org.gnome.desktop.media-handling automount

Manual mount to test:

sudo mount /dev/sdb1 /mnt/test

Deduplication Not Working

Verify BTRFS:

# Must be BTRFS
df -T /var/home | grep btrfs

Check status:

btrfs filesystem du -s /var/home

Snapshots Filling Disk

List and clean:

# List snapshots
snapper list

# Delete old snapshots
snapper delete <number>

# Or disable entirely
ujust config-snapshots

Cross-References

• bazzite:system - System cleanup
• bazzite:security - LUKS encryption
• bazzite-ai:configure - Docker/Podman storage

When to Use This Skill

Use when the user asks about:

• "mount drive", "automount", "external drive"
• "Framework storage", "expansion card", "SteamOS mount"
• "BTRFS dedup", "deduplication", "save space"
• "disk trim", "rmlint", "cleanup duplicates"
• "snapshots", "snapper", "backup home", "rollback"
• "partition mount", "fstab", "mount on boot"