[Feature] Show Storage space of Immich, not whole drive

[tymalo]

I have searched the existing feature requests to make sure this is not a duplicate request.

• Yes

The feature

The Storage space indicator in the bottom left page of the screen is showing the total used space of my drive. But its including everything that is being used. Not just Immich. It would be more beneficial to show Immich usage broken out from the total.

Platform

• Server
• Web
• Mobile

[demeesterroeland]

This is something I've been digging into recently and I think it's worth explaining why this happens at the code level, because the fix isn't as simple as swapping one number for another.

Why the whole disk is shown

The storage numbers come from fs.statfs() in server/src/repositories/storage.repository.ts:

async checkDiskUsage(folder: string): Promise<DiskUsage> {
  const stats = await fs.statfs(folder); // returns ENTIRE mount point stats
  return {
    available: stats.bavail * stats.bsize,
    free:      stats.bfree  * stats.bsize,
    total:     stats.blocks * stats.bsize,
  };
}

fs.statfs() does not inspect the folder's contents — it reports statistics for the entire mount point that folder lives on. So if your Immich upload path is on a volume shared with anything else (OS files, backups, an external library source, another service), all of that is included in diskUse.

This feeds directly into server/src/services/server.service.ts:

const libraryBase = StorageCore.getBaseFolder(StorageFolder.Library);
const diskInfo = await this.storageRepository.checkDiskUsage(libraryBase);
serverInfo.diskUse = asHumanReadable(diskInfo.total - diskInfo.free);

And then the sidebar widget (storage-space.svelte) displays diskUseRaw / diskSizeRaw as-is when no user quota is set — framing the whole-volume number as if it were Immich's own footprint.

Concrete example (Docker on a Linux VPS, CIFS-mounted NAS)

Measurement	Size
Immich actual data (du on upload folder)	~267 GiB
Volume used (statfs)	~644 GiB
Gap	~377 GiB — a Google Takeout archive sharing the same CIFS mount

The sidebar shows "644 GiB of 1 TiB used" when Immich is responsible for only 267 GiB. A user with 50 GiB of their own photos sees the same inflated bar with no explanation.

Related issues

This also connects to #4318 (incorrect storage display on Mac), where the frsize vs bsize distinction compounds the confusion — frsize (fragment size, what you should use for space calculations) can differ from bsize (block size, the I/O size) on some filesystems, meaning the numbers are not only scoped to the wrong thing but can also be arithmetically wrong. And #16852 notes that the server stats endpoint doesn't respect user quota for the available storage figure, which is the same conflation from a different angle.

[demeesterroeland]

Proposed solution

Here's what I'd propose to fix the UX without touching the backend calculations (which remain correct for what they measure).

1a — Sidebar widget: three-tone bar for no-quota users

Instead of showing the raw statfs volume total as if it were an Immich capacity, split the bar into three segments that make the breakdown immediately readable:

Current:
[████████████████░░░░░░]  644 GiB of 1 TiB used

Proposed:
[░░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓]

░  Your data              50 GiB   (white)
▒  Other on this volume  594 GiB   (grey)
▓  Free                  380 GiB   (black)

The large grey block makes it immediately clear that the "used" space is not the user's doing. An alternative (Option A) would be to drop the volume context entirely for no-quota users and show only their own usage with a "no storage limit" label.

1b — Sidebar widget: disk-constrained quota users

The current quota bar gives users false confidence: it shows headroom up to their quota limit, but if the physical disk is nearly full they will hit a wall before reaching it.

This is confirmed in the source: requireQuota in server/src/services/asset-media.service.ts only checks quota — there is no disk-space guard on upload:

private requireQuota(auth: AuthDto, size: number) {
  if (auth.user.quotaSizeInBytes !== null &&
      auth.user.quotaSizeInBytes < auth.user.quotaUsageInBytes + size) {
    throw new BadRequestException('Quota has been exceeded!');
  }
  // ← no check against actual available disk space
}

If the physical volume fills up while the user still has quota remaining, the upload fails with a raw OS-level I/O error — not a clean "disk is full" message. The sidebar meanwhile still shows the quota headroom as fully available, so the user has no warning before the failure.

A three-segment bar should only appear when disk_free < quota_remaining — otherwise the normal two-segment quota bar is shown unchanged:

Normal (disk has plenty of room):
[░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓▓▓]

░  Used           50 GiB
▓  Free (quota)  450 GiB   (up to your 500 GiB quota)


Disk-constrained (disk_free < quota_remaining):
[░░░░░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒]▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

░  Used                      50 GiB
▒  Available on disk        243 GiB   ⚠
▓  Quota headroom on disk   207 GiB

The ⚠ tooltip on the grey segment: "Your quota allows 450 GiB more, but only 243 GiB is free on the server's disk."

Note: fixing the upload path to return a clean error when the disk is full (rather than a raw I/O error) would be a separate backend improvement, but is worth mentioning alongside this UI change.

This way the bar is only as complex as it needs to be — the extra segments only appear when they carry actionable information.

2 — Admin server-status: dedicated "Volume Disk Space" card

Add a card that separates what Immich manages from everything else on the volume, with a per-user breakdown — inspired by how another photo solution presents shared family storage:

Volume Disk Space   (/usr/src/app/upload)

644 GiB of 1 TiB used

[░░░░░░░░░░░░░░░░░░░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓]
░ Immich (267 GiB)      ▒ Other (377 GiB)      ▓ Free (380 GiB)

STORAGE DETAILS
────────────────────────────────────────────────────────────────────
░  Immich                                                  267 GiB
       Alice                                     147 GiB
       Bob                                        76 GiB
       (admin)                                    44 GiB
▒  Other (not managed by Immich)                 377 GiB     ⓘ
▓  Free                                          380 GiB

                                    Total volume size:  1.02 TiB

Legend: ░ white = Immich-managed · ▒ grey = other data on volume · ▓ black = free

The ⓘ tooltip: "Disk space on this volume not tracked by Immich — may include external library source files, backups, or other services sharing the same mount."

The per-user data is already available via the existing quota APIs — this is purely a presentation change, no new backend work needed.

Why not use du instead of statfs?

du on a large library is slow and expensive — not suitable for a UI that loads on every page. The statfs approach is correct for volume capacity. The improvement is to display the two concepts separately rather than replacing one with the other.

I'm happy to work on a PR for this if the approach looks good to the maintainers — wanted to share the proposal here first to make sure the direction makes sense before writing code.

[demeesterroeland]

Following up on my earlier comments — I've put together interactive mockups for all three proposed changes so the design is easier to evaluate without
reading code. Full collection: https://codepen.io/collection/JYymGJ

Change 1 — Sidebar: no-quota users
Rather than showing the raw volume total (644 GiB of 1 TiB used), show only the user's own data with an ∞ icon on the right — consistent with how the
admin/users list already signals unlimited quota.
🔗 https://codepen.io/demeesterroeland/pen/gbwEWYE

Change 2 — Sidebar: quota users when disk is tighter than quota
Triggered only when disk_free < quota_remaining. The bar is capped at actual disk free (amber) and a warning line is added below. When the disk has
plenty of room the existing quota bar is shown unchanged.
🔗 https://codepen.io/demeesterroeland/pen/QwKovjj

Change 3 — Admin server-status: Volume Disk Space section
A new section below the existing user-usage table. The three-segment bar (Immich / Other / Free) and the storage-details breakdown are cross-linked:
hovering a user row highlights their bar segment, and vice versa. The per-user table from the existing section is merged in under the Immich row.
🔗 https://codepen.io/demeesterroeland/pen/gbwEWrJ

---

All three mockups use Tailwind CDN with Immich's actual utility classes (rounded-3xl, bg-subtle, font-mono, text-primary, h-35) and the
mdiInfinity / mdiAlertOutline icon paths already in the codebase. No new backend work needed — all required data (diskAvailableRaw,
quotaUsageInBytes, usageByUser) is already exposed by existing endpoints.

Happy to open a draft PR if the direction looks good.