immich-app/immich
1
0
Fork 0
mirror of https://github.com/immich-app/immich.git synced 2026-02-05 08:41:28 +03:00
Code Issues 26 Packages Projects Releases 10 Wiki Activity

Incorrect storage display size for Mac #1404

New Issue
Open
opened 2026-02-05 01:40:40 +03:00 by OVERLORD · 17 comments
OVERLORD commented 2026-02-05 01:40:40 +03:00
Owner
Copy Link

Originally created by @Rihcus on GitHub (Oct 3, 2023).

The bug

Storage counter in home ui broken.

image

My host mac has 256gb ssd and 1tb hard drive (usb)

The external 1tb hardrive contains the immich library and is using Mac OS Extended (Journaled) file system

Admin panal storage count is correct however:

image

The OS that Immich Server is running on

macOS 12.6.2 21G320 x86_64

Version of Immich Server

v1.80.0

Version of Immich Mobile App

v1.79.0

Platform with the issue

  • Server
  • Web
  • Mobile

Your docker-compose.yml content

version: "3.8"

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    command: [ "start.sh", "immich" ]
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /Volumes/MACHD/PhotoLibrary/Library/Photos/Oneplus8/OP8_Camera_Backup/Camera:/mnt/media/Camera:ro
    env_file:
      - .env
    depends_on:
      - redis
      - database
      - typesense
    restart: always

  immich-microservices:
    container_name: immich_microservices
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # extends:
    #   file: hwaccel.yml
    #   service: hwaccel
    command: [ "start.sh", "microservices" ]
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /Volumes/MACHD/PhotoLibrary/Library/Photos/Oneplus8/OP8_Camera_Backup/Camera:/mnt/media/Camera:ro
    env_file:
      - .env
    depends_on:
      - redis
      - database
      - typesense
    restart: always

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    volumes:
      - model-cache:/cache
    env_file:
      - .env
    restart: always

  immich-web:
    container_name: immich_web
    image: ghcr.io/immich-app/immich-web:${IMMICH_VERSION:-release}
    env_file:
      - .env
    restart: always

  typesense:
    container_name: immich_typesense
    image: typesense/typesense:0.24.1@sha256:9bcff2b829f12074426ca044b56160ca9d777a0c488303469143dd9f8259d4dd
    environment:
      - TYPESENSE_API_KEY=${TYPESENSE_API_KEY}
      - TYPESENSE_DATA_DIR=/data
      # remove this to get debug messages
      - GLOG_minloglevel=1
    volumes:
      - tsdata:/data
    restart: always

  redis:
    container_name: immich_redis
    image: redis:6.2-alpine@sha256:70a7a5b641117670beae0d80658430853896b5ef269ccf00d1827427e3263fa3
    restart: always

  database:
    container_name: immich_postgres
    image: postgres:14-alpine@sha256:28407a9961e76f2d285dc6991e8e48893503cc3836a4755bbc2d40bcc272a441
    env_file:
      - .env
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
    volumes:
      - pgdata:/var/lib/postgresql/data
    restart: always

  immich-proxy:
    container_name: immich_proxy
    image: ghcr.io/immich-app/immich-proxy:${IMMICH_VERSION:-release}
    environment:
      # Make sure these values get passed through from the env file
      - IMMICH_SERVER_URL
      - IMMICH_WEB_URL
    ports:
      - 2283:8080
    depends_on:
      - immich-server
      - immich-web
    restart: always

volumes:
  pgdata:
  model-cache:
  tsdata:

Your .env content

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=/Volumes/MACHD/PhotoLibrary/immich-upload

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secrets for postgres and typesense. You should change these to random passwords
TYPESENSE_API_KEY=some-random-text
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_HOSTNAME=immich_postgres
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

REDIS_HOSTNAME=immich_redis

Reproduction steps

1. Set up docker compose on macOS 12.6.2 21G320 x86_64 
2. Plug in an external usb hard drive (make sure its formated in Mac OS Extended (Journaled) file system).
3. Mount some external libraries to docker-compose.yml
4. Install immich and update the web ui accordingly
5. Run a library scan
6. Check the storage counter in the home ui and compare it to admin panal
...

Additional information

Possibly related issues:

Originally created by @Rihcus on GitHub (Oct 3, 2023). ### The bug Storage counter in home ui broken. <img width="245" alt="image" src="https://github.com/immich-app/immich/assets/30292597/1d384a10-afc2-4b57-ba23-e83b2489f7d4"> My host mac has 256gb ssd and 1tb hard drive (usb) The external 1tb hardrive contains the immich library and is using Mac OS Extended (Journaled) file system Admin panal storage count is correct however: <img width="928" alt="image" src="https://github.com/immich-app/immich/assets/30292597/4aba031e-9ce6-47b3-9810-07a9a8457c33"> ### The OS that Immich Server is running on macOS 12.6.2 21G320 x86_64 ### Version of Immich Server v1.80.0 ### Version of Immich Mobile App v1.79.0 ### Platform with the issue - [x] Server - [X] Web - [X] Mobile ### Your docker-compose.yml content ```YAML version: "3.8" services: immich-server: container_name: immich_server image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release} command: [ "start.sh", "immich" ] volumes: - ${UPLOAD_LOCATION}:/usr/src/app/upload - /Volumes/MACHD/PhotoLibrary/Library/Photos/Oneplus8/OP8_Camera_Backup/Camera:/mnt/media/Camera:ro env_file: - .env depends_on: - redis - database - typesense restart: always immich-microservices: container_name: immich_microservices image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release} # extends: # file: hwaccel.yml # service: hwaccel command: [ "start.sh", "microservices" ] volumes: - ${UPLOAD_LOCATION}:/usr/src/app/upload - /Volumes/MACHD/PhotoLibrary/Library/Photos/Oneplus8/OP8_Camera_Backup/Camera:/mnt/media/Camera:ro env_file: - .env depends_on: - redis - database - typesense restart: always immich-machine-learning: container_name: immich_machine_learning image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release} volumes: - model-cache:/cache env_file: - .env restart: always immich-web: container_name: immich_web image: ghcr.io/immich-app/immich-web:${IMMICH_VERSION:-release} env_file: - .env restart: always typesense: container_name: immich_typesense image: typesense/typesense:0.24.1@sha256:9bcff2b829f12074426ca044b56160ca9d777a0c488303469143dd9f8259d4dd environment: - TYPESENSE_API_KEY=${TYPESENSE_API_KEY} - TYPESENSE_DATA_DIR=/data # remove this to get debug messages - GLOG_minloglevel=1 volumes: - tsdata:/data restart: always redis: container_name: immich_redis image: redis:6.2-alpine@sha256:70a7a5b641117670beae0d80658430853896b5ef269ccf00d1827427e3263fa3 restart: always database: container_name: immich_postgres image: postgres:14-alpine@sha256:28407a9961e76f2d285dc6991e8e48893503cc3836a4755bbc2d40bcc272a441 env_file: - .env environment: POSTGRES_PASSWORD: ${DB_PASSWORD} POSTGRES_USER: ${DB_USERNAME} POSTGRES_DB: ${DB_DATABASE_NAME} volumes: - pgdata:/var/lib/postgresql/data restart: always immich-proxy: container_name: immich_proxy image: ghcr.io/immich-app/immich-proxy:${IMMICH_VERSION:-release} environment: # Make sure these values get passed through from the env file - IMMICH_SERVER_URL - IMMICH_WEB_URL ports: - 2283:8080 depends_on: - immich-server - immich-web restart: always volumes: pgdata: model-cache: tsdata: ``` ### Your .env content ```Shell # You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables # The location where your uploaded files are stored UPLOAD_LOCATION=/Volumes/MACHD/PhotoLibrary/immich-upload # The Immich version to use. You can pin this to a specific version like "v1.71.0" IMMICH_VERSION=release # Connection secrets for postgres and typesense. You should change these to random passwords TYPESENSE_API_KEY=some-random-text DB_PASSWORD=postgres # The values below this line do not need to be changed ################################################################################### DB_HOSTNAME=immich_postgres DB_USERNAME=postgres DB_DATABASE_NAME=immich REDIS_HOSTNAME=immich_redis ``` ### Reproduction steps ```bash 1. Set up docker compose on macOS 12.6.2 21G320 x86_64 2. Plug in an external usb hard drive (make sure its formated in Mac OS Extended (Journaled) file system). 3. Mount some external libraries to docker-compose.yml 4. Install immich and update the web ui accordingly 5. Run a library scan 6. Check the storage counter in the home ui and compare it to admin panal ... ``` ### Additional information Possibly related issues: - https://github.com/docker/for-mac/issues/2136 - https://github.com/goharbor/harbor/pull/5695/files#diff-863faac4a7e2eea4d78a34dc31ce004d72d6578aead1cf569176de4b6f017d87R60-R66
OVERLORD added the 🗄️server label 2026-02-05 01:40:40 +03:00
OVERLORD commented 2026-02-05 01:40:42 +03:00
Author
Owner
Copy Link

@bo0tzz commented on GitHub (Oct 3, 2023):

This is a docker bug that we can't really do anything about.

@bo0tzz commented on GitHub (Oct 3, 2023): This is a docker bug that we can't really do anything about.
OVERLORD commented 2026-02-05 01:40:45 +03:00
Author
Owner
Copy Link

@jrasm91 commented on GitHub (Oct 3, 2023):

I'd like to take a look at this one actually.

@jrasm91 commented on GitHub (Oct 3, 2023): I'd like to take a look at this one actually.
OVERLORD commented 2026-02-05 01:40:50 +03:00
Author
Owner
Copy Link

@Mika571 commented on GitHub (Oct 8, 2023):

Also seeing this on macOS Monterey w/ docker desktop 4.24
image
image

@Mika571 commented on GitHub (Oct 8, 2023): Also seeing this on macOS Monterey w/ docker desktop 4.24 ![image](https://github.com/immich-app/immich/assets/4703888/6707f38d-a65d-4103-8c2c-4934247ec253) ![image](https://github.com/immich-app/immich/assets/4703888/65ac2367-8d35-406b-b411-3ba0e6fbcd73)
OVERLORD commented 2026-02-05 01:40:53 +03:00
Author
Owner
Copy Link

@cedvan commented on GitHub (Jan 20, 2024):

I have exactly the same problem. After investigation, some images are missing in the originals "upload/library" folder.

WARNING, Immich may have deleted or not uploaded somes photos correctly.
The "upload/thumbs" previews exists and the images are presents in the database. But their originals may be missing.
Which explains this delta.
Immich front display thumbs images and hide this problem. Try download image to test original is present or check picture path in "upload/library"

The storage "bottom left" indicates the true size of the library from the File system "upload/library".
The servers stats indicates the size obtained from the database, so maybe bad

@cedvan commented on GitHub (Jan 20, 2024): I have exactly the same problem. After investigation, some images are missing in the originals "upload/library" folder. WARNING, Immich may have deleted or not uploaded somes photos correctly. The "upload/thumbs" previews exists and the images are presents in the database. But their originals may be missing. Which explains this delta. Immich front display thumbs images and hide this problem. Try download image to test original is present or check picture path in "upload/library" The storage "bottom left" indicates the true size of the library from the File system "upload/library". The servers stats indicates the size obtained from the database, so maybe bad
OVERLORD commented 2026-02-05 01:40:56 +03:00
Author
Owner
Copy Link

@MatissAndersons commented on GitHub (Mar 1, 2024):

I just installed Immich on MacOS through docker compose. For me it was the same until I set the quotas for the users. I set the quota of 150gb and it shows 308.7mb usage which is exactly the same number as Finder app shows for library folder.

@MatissAndersons commented on GitHub (Mar 1, 2024): I just installed Immich on MacOS through docker compose. For me it was the same until I set the quotas for the users. I set the quota of 150gb and it shows 308.7mb usage which is exactly the same number as Finder app shows for library folder.
OVERLORD commented 2026-02-05 01:41:01 +03:00
Author
Owner
Copy Link

@scottrbaxter commented on GitHub (Mar 7, 2024):

I just installed Immich on MacOS through docker compose. For me it was the same until I set the quotas for the users. I set the quota of 150gb and it shows 308.7mb usage which is exactly the same number as Finder app shows for library folder.

I've experienced exactly this with immich 1.97.0 on both macOS Sonoma 14.3.1 with Docker Desktop 4.26.1, as well as Synology's Container Manager "Docker 20.10.23-1437".

macOS - without quota
Screenshot 2024-03-06 at 5 06 34 PM

1000 GB quota
Screenshot 2024-03-06 at 5 07 58 PM

Synology - without quota (this is the only user, so 6.5GB should be the total storage used, which matches what the underlying system reports)
Screenshot 2024-03-06 at 5 01 20 PM

1000 GB quota
Screenshot 2024-03-06 at 5 01 36 PM

I can actually revert back to the incorrect storage size simply by changing my user quota from 1000 back to 0.

@scottrbaxter commented on GitHub (Mar 7, 2024): > I just installed Immich on MacOS through docker compose. For me it was the same until I set the quotas for the users. I set the quota of 150gb and it shows 308.7mb usage which is exactly the same number as Finder app shows for library folder. I've experienced exactly this with immich 1.97.0 on both macOS Sonoma 14.3.1 with Docker Desktop 4.26.1, as well as Synology's Container Manager "Docker 20.10.23-1437". macOS - without quota <img width="249" alt="Screenshot 2024-03-06 at 5 06 34 PM" src="https://github.com/immich-app/immich/assets/4142806/3c65b601-4ef1-421a-b10c-80a48ee2b539"> 1000 GB quota <img width="246" alt="Screenshot 2024-03-06 at 5 07 58 PM" src="https://github.com/immich-app/immich/assets/4142806/566400ce-8b6f-4120-b680-ea8995a0a6d8"> --- Synology - without quota (this is the only user, so 6.5GB should be the total storage used, which matches what the underlying system reports) <img width="258" alt="Screenshot 2024-03-06 at 5 01 20 PM" src="https://github.com/immich-app/immich/assets/4142806/075df12b-cdf1-499b-8130-5303a3e6d503"> 1000 GB quota <img width="250" alt="Screenshot 2024-03-06 at 5 01 36 PM" src="https://github.com/immich-app/immich/assets/4142806/17f2cfe6-4a73-41d5-93bf-2f0b176addc0"> I can actually revert back to the incorrect storage size simply by changing my user quota from `1000` back to `0`.
OVERLORD commented 2026-02-05 01:41:03 +03:00
Author
Owner
Copy Link

@krakowski commented on GitHub (Mar 12, 2024):

This does also seem to affect Linux. Setting a quota (500 GiB in my case) fixes the calculated size, as mentioned in https://github.com/immich-app/immich/issues/4318#issuecomment-1972017633.

Screenshot from 2024-03-12 07-10-48Screenshot from 2024-03-12 07-10-57

  • Immich version: v1.98.2
  • Host OS: Ubuntu 22.04
  • Host architecture: aarch64
  • Kernel version: 5.15
  • Deployment: Docker
  • Storage: sshfs
@krakowski commented on GitHub (Mar 12, 2024): This does also seem to affect Linux. Setting a quota (500 GiB in my case) fixes the calculated size, as mentioned in https://github.com/immich-app/immich/issues/4318#issuecomment-1972017633. ![Screenshot from 2024-03-12 07-10-48](https://github.com/immich-app/immich/assets/7255767/6fcbf159-4acd-477e-8c3e-0769c74ed518)![Screenshot from 2024-03-12 07-10-57](https://github.com/immich-app/immich/assets/7255767/682b660f-4917-4a58-9e37-a1faef513de4) * __Immich version__: v1.98.2 * __Host OS__: Ubuntu 22.04 * __Host architecture__: aarch64 * __Kernel version__: 5.15 * __Deployment__: Docker * __Storage__: sshfs
OVERLORD commented 2026-02-05 01:41:06 +03:00
Author
Owner
Copy Link

@mufeedali commented on GitHub (Apr 1, 2024):

Seems to affect every case where storage is using sshfs

image

Still present in v1.100.0

@mufeedali commented on GitHub (Apr 1, 2024): Seems to affect every case where storage is using sshfs ![image](https://github.com/immich-app/immich/assets/28823274/b4468ca2-a2d0-412b-be7a-6be4201b6f90) Still present in v1.100.0
OVERLORD commented 2026-02-05 01:41:11 +03:00
Author
Owner
Copy Link

@0x5e commented on GitHub (Sep 7, 2024):

I guess the total size is from linux machine on macos so it's not true. If we can't get it, it will be better display unknown instead of a wrong size.

@0x5e commented on GitHub (Sep 7, 2024): I guess the total size is from linux machine on macos so it's not true. If we can't get it, it will be better display unknown instead of a wrong size.
OVERLORD commented 2026-02-05 01:41:14 +03:00
Author
Owner
Copy Link

@tmryvz commented on GitHub (Nov 8, 2024):

Any progress on this? On my Docker Desktop for Mac 4.35.1 and immich v1.120.1 its still showing me wrong numbers..

@tmryvz commented on GitHub (Nov 8, 2024): Any progress on this? On my Docker Desktop for Mac 4.35.1 and immich v1.120.1 its still showing me wrong numbers..
OVERLORD commented 2026-02-05 01:41:18 +03:00
Author
Owner
Copy Link

@mmomjian commented on GitHub (Dec 20, 2024):

@jrasm91 can we close this as an upstream docker bug / deprioritized as a Docker Desktop-only issue?

@mmomjian commented on GitHub (Dec 20, 2024): @jrasm91 can we close this as an upstream docker bug / deprioritized as a Docker Desktop-only issue?
OVERLORD commented 2026-02-05 01:41:25 +03:00
Author
Owner
Copy Link

@pawnjiang commented on GitHub (Jan 10, 2025):

I've found a way to solve this problem temporarily: configure the Quota Size in the settings of immich, and then the storage space can be displayed normally. Btw, my immich version is 1.230.0 for Casaos.
image

image

@pawnjiang commented on GitHub (Jan 10, 2025): I've found a way to solve this problem temporarily: configure the Quota Size in the settings of immich, and then the storage space can be displayed normally. Btw, my immich version is 1.230.0 for Casaos. ![image](https://github.com/user-attachments/assets/05cf9cf7-92cd-4bfe-be4b-2e91ae9992f5) ![image](https://github.com/user-attachments/assets/cce37584-1095-4c53-9727-c1e1c452eaf8)
OVERLORD commented 2026-02-05 01:41:29 +03:00
Author
Owner
Copy Link

@4IEU commented on GitHub (Jul 25, 2025):

I'm running Immich v1.136.0 on a Mac Studio M3 Ultra with the following hardware:
CPU: 24 cores
RAM: 256GB
Internal SSD: 2TB
External Storage: 4 × 28TB HDDs configured with OpenZFS RAIDZ1, providing a total storage capacity of 83.64TB for UPLOAD_LOCATION=/Volumes/HDD4x28TB_RAIDZ1/immich

Database Location: DB_DATA_LOCATION=./postgres

However, the Immich web UI incorrectly reports the available storage as 181.4 TiB of 464.5 TiB used, which is not accurate given the actual disk setup and capacity.
Image

@4IEU commented on GitHub (Jul 25, 2025): I'm running Immich v1.136.0 on a Mac Studio M3 Ultra with the following hardware: CPU: 24 cores RAM: 256GB Internal SSD: 2TB External Storage: 4 × 28TB HDDs configured with OpenZFS RAIDZ1, providing a total storage capacity of 83.64TB for UPLOAD_LOCATION=/Volumes/HDD4x28TB_RAIDZ1/immich Database Location: DB_DATA_LOCATION=./postgres However, the Immich web UI incorrectly reports the available storage as 181.4 TiB of 464.5 TiB used, which is not accurate given the actual disk setup and capacity. ![Image](https://github.com/user-attachments/assets/1f7b6323-28c5-4fac-9d8c-f8a831fd1da7)
OVERLORD commented 2026-02-05 01:41:33 +03:00
Author
Owner
Copy Link

@albarago commented on GitHub (Aug 21, 2025):

I too have the same exact problem. MacBook Pro M3 pro with about 20 TB total storage, 12 of which is visible to immich.

I had to set quotas to have it report properly, but, as the admin I would like to easily see how much space is left for the entirety of available storage. This is very very useful.

So big +1 on figuring this out

Here's how it looks for me. How I wish I had that much storage!!

Image
@albarago commented on GitHub (Aug 21, 2025): I too have the same exact problem. MacBook Pro M3 pro with about 20 TB total storage, 12 of which is visible to immich. I had to set quotas to have it report properly, but, as the admin I would like to easily see how much space is left for the entirety of available storage. This is very very useful. So big +1 on figuring this out Here's how it looks for me. How I wish I had that much storage!! <img width="257" height="897" alt="Image" src="https://github.com/user-attachments/assets/124c484a-c915-46c5-ad36-ee3770f59e9c" />
OVERLORD commented 2026-02-05 01:41:35 +03:00
Author
Owner
Copy Link

@rizkyarlin commented on GitHub (Oct 17, 2025):

Same problem on my Mac Mini M1.
I use 4TB external HDD as the storage.

I use colima for the docker with start command:
colima start --memory 6 --mount "/Volumes/main/:w" --mount "~:w"

Image

MatissAndersons:

I just installed Immich on MacOS through docker compose. For me it was the same until I set the quotas for the users. I set the quota of 150gb and it shows 308.7mb usage which is exactly the same number as Finder app shows for library folder.

After setting the storage limit:

Image
@rizkyarlin commented on GitHub (Oct 17, 2025): Same problem on my Mac Mini M1. I use 4TB external HDD as the storage. I use `colima` for the docker with start command: `colima start --memory 6 --mount "/Volumes/main/:w" --mount "~:w"` <img width="234" height="160" alt="Image" src="https://github.com/user-attachments/assets/10dfcc10-2f36-47c8-b216-7f2325a9386a" /> [MatissAndersons](https://github.com/MatissAndersons): > I just installed Immich on MacOS through docker compose. For me it was the same until I set the quotas for the users. I set the quota of 150gb and it shows 308.7mb usage which is exactly the same number as Finder app shows for library folder. After setting the storage limit: <img width="215" height="159" alt="Image" src="https://github.com/user-attachments/assets/26ce0a5d-dc4d-4ad1-a19a-5f6aa68fa24e" />
OVERLORD commented 2026-02-05 01:41:36 +03:00
Author
Owner
Copy Link

@DevilLnC commented on GitHub (Nov 21, 2025):

Is this any fix to this guys? I’m facing the same issue.

@DevilLnC commented on GitHub (Nov 21, 2025): Is this any fix to this guys? I’m facing the same issue.
OVERLORD commented 2026-02-05 01:41:38 +03:00
Author
Owner
Copy Link

@ezequielp commented on GitHub (Jan 1, 2026):

I installed immich on a macbook just for testing before I move to an actual linux server. I noticed this issue and I spent some time researching.

So, the issue is that the implementation of checkDiskUsage is incorrect. This seems to be a common error that only becomes evident on some filesystems. I documented the issue on libuv, as I think that the only clean way to fix this is for them to expose the missing frsize field.

Storage reported on Settings:
Image

Storage reported by df inside Docker:

root@9b38b1a4d717:/usr/src/app# df /data -H
Filesystem            Size  Used Avail Use% Mounted on
/run/host_mark/Users  495G  479G   17G  97% /data

Reportedy by immich:

Image

Since df does get the right values, I tested using the output from df:

Image

The code I used is just a quick proof of concept by patching my server/dist/repositories/storage.repository.js:

async checkDiskUsage(folder) {
      const { execSync } = require('child_process');
      const output = execSync(`df -B1 "${folder}" | tail -1`).toString();
      const parts = output.trim().split(/\s+/);
      return {
          available: parseInt(parts[3], 10),
          free: parseInt(parts[1], 10) - parseInt(parts[2], 10),
          total: parseInt(parts[1], 10),
      };
  }

this code is blocking and potentially unsafe.

Maybe somebody with more node experience can come up with a better solution.

@ezequielp commented on GitHub (Jan 1, 2026): I installed immich on a macbook just for testing before I move to an actual linux server. I noticed this issue and I spent some time researching. So, the issue is that the implementation of [checkDiskUsage](https://github.com/immich-app/immich/blob/3321c1a9dfa8f483cbb011cdb5617a3b0b61d239/server/src/repositories/storage.repository.ts#L173-L180) is incorrect. This seems to be a common error that only becomes evident on some filesystems. I documented the issue on libuv, as I think that the only clean way to fix this is for them to expose the missing frsize field. Storage reported on Settings: <img width="199" height="36" alt="Image" src="https://github.com/user-attachments/assets/268a3c83-33f3-4dbf-8d7a-971a2db383d3" /> Storage reported by df inside Docker: ``` root@9b38b1a4d717:/usr/src/app# df /data -H Filesystem Size Used Avail Use% Mounted on /run/host_mark/Users 495G 479G 17G 97% /data ``` Reportedy by immich: ![Image](https://github.com/user-attachments/assets/1bf5a8da-f5ab-49c8-a801-52309e218ad8) Since df does get the right values, I tested using the output from df: <img width="492" height="270" alt="Image" src="https://github.com/user-attachments/assets/b052e5d5-9f36-40f6-b9b8-edc916fdc574" /> The code I used is just a quick proof of concept by patching my `server/dist/repositories/storage.repository.js`: ```javascript async checkDiskUsage(folder) { const { execSync } = require('child_process'); const output = execSync(`df -B1 "${folder}" | tail -1`).toString(); const parts = output.trim().split(/\s+/); return { available: parseInt(parts[3], 10), free: parseInt(parts[1], 10) - parseInt(parts[2], 10), total: parseInt(parts[1], 10), }; } ``` this code is blocking and potentially unsafe. Maybe somebody with more node experience can come up with a better solution.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
accessibility
changelog:enhancement
changelog:security
changelog:skip
changelog:translation
cli
date-time
documentation
external-library
format
good first issue
needs-answer
nice to have
sharing
tech-debt
📱mobile
🖥️web
🗄️server
🧠machine-learning
No Label 🗄️server
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
OVERLORD
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#1404
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?