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¶

Command	Description
`ujust enable-automounting`	Enable BTRFS/EXT4 automount
`ujust disable-automounting`	Disable BTRFS/EXT4 automount
`ujust enable-framework-automount`	Enable Framework laptop automount
`ujust disable-framework-automount`	Disable Framework automount
`ujust enable-steamos-automount`	Enable SteamOS automount
`ujust disable-steamos-automount`	Disable SteamOS automount
`ujust enable-automount-all`	Enable all automounting
`ujust disable-automount-all`	Disable all automounting

BTRFS Features¶

Command	Description
`ujust enable-deduplication`	Enable BTRFS dedup for /var/home
`ujust enable-rmlint`	Enable/disable rmlint trim
`ujust config-snapshots`	Enable/disable snapper snapshots

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"