AssetGenerateThumbnails fails with SIGSEGV when generating thumbnails from iPhone HEVC MOV

[KillLinux]

I have searched the existing issues, both open and closed, to make sure this is not a duplicate report.

• Yes

The bug

When uploading a HEVC-encoded MOV video captured by iPhone 13 Pro Max, the automatic background task AssetGenerateThumbnails fails. The ffmpeg process is killed with signal SIGSEGV (segmentation fault) during thumbnail generation, resulting in a failed job and missing video thumbnails.

The OS that Immich Server is running on

CentOS Linux release 7.9.2009 (Core)

Version of Immich Server

v2.6.3

Version of Immich Mobile App

v2.6.3

Platform with the issue

• Server
• Web
• Mobile

Device make and model

iPhone 13 ProMax

Your docker-compose.yml content

#
# WARNING: To install Immich, follow our guide: https://docs.immich.app/install/docker-compose
#
# Make sure to use the docker-compose.yml of the current release:
#
# https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
#
# The compose file on main may not be compatible with the latest release.

name: immich

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    #extends:
       #file: hwaccel.transcoding.yml
       #service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
    volumes:
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - .env
    ports:
      - '2283:2283'
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}-cuda
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities:
                - gpu
    volumes:
      - model-cache:/cache
    env_file:
      - .env
    restart: always

  redis:
    container_name: immich_redis
    image: docker.io/valkey/valkey:9@sha256:fb8d272e529ea567b9bf1302245796f21a2672b8368ca3fcb938ac334e613c8f
    healthcheck:
      test: redis-cli ping || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:bcf63357191b76a916ae5eb93464d65c07511da41e3bf7a8416db519b40b1c23
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: '--data-checksums'
      # Uncomment the DB_STORAGE_TYPE: 'HDD' var if your database isn't stored on SSDs
      # DB_STORAGE_TYPE: 'HDD'
    volumes:
      # Do not edit the next line. If you want to change the database storage location on your system, edit the value of DB_DATA_LOCATION in the .env file
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
    shm_size: 511mb
    restart: always

volumes:
  model-cache:

Your .env content

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

# The location where your uploaded files are stored
UPLOAD_LOCATION=/Immich_file

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like "v2.1.0"
IMMICH_VERSION=v2.6.3

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich
TZ=Asia/Shanghai

Reproduction steps

1.Upload a .MOV video file recorded by iPhone 13 Pro Max (HEVC / hvc1 codec);
2.Wait for the microservice job AssetGenerateThumbnails to start automatically;
3.The job throws an error and aborts during ffmpeg processing.

ERROR [Microservices:...] Unable to run job handler (AssetGenerateThumbnails): Error: ffmpeg was killed with signal SIGSEGV

Relevant log output

[Nest] 7  - 03/30/2026, 5:38:10 PM   ERROR [Microservices:{"source":"upload","id":"5ba01949-c3bc-4296-9152-5ac362e54112"}] Unable to run job handler (AssetGenerateThumbnails): Error: ffmpeg was killed with signal SIGSEGV
Error: ffmpeg was killed with signal SIGSEGV
    at ChildProcess.<anonymous> (/usr/src/app/server/node_modules/.pnpm/fluent-ffmpeg@2.1.3/node_modules/fluent-ffmpeg/lib/processor.js:178:22)
    at ChildProcess.emit (node:events:508:28)
    at ChildProcess._handle.onexit (node:internal/child_process:294:12)
[Nest] 7  - 03/30/2026, 5:38:11 PM     LOG [Microservices:MediaService] Transcoding video d13f9e08-bf8e-481f-b7ca-77d0f3e36217 without hardware acceleration
[Nest] 7  - 03/30/2026, 5:38:11 PM     LOG [Microservices:MediaService] Successfully encoded d13f9e08-bf8e-481f-b7ca-77d0f3e36217
[Nest] 7  - 03/30/2026, 5:38:11 PM     LOG [Microservices:PersonService] Detected 1 new faces in asset d13f9e08-bf8e-481f-b7ca-77d0f3e36217
[Nest] 7  - 03/30/2026, 5:38:13 PM     LOG [Microservices:MediaService] Transcoding video 48058753-05f1-46d6-be96-779d2fc99f84 without hardware acceleration
[Nest] 7  - 03/30/2026, 5:38:14 PM     LOG [Microservices:MediaService] Successfully encoded 48058753-05f1-46d6-be96-779d2fc99f84
[Nest] 7  - 03/30/2026, 5:38:14 PM     LOG [Microservices:MediaService] Transcoding video c21c7c80-3a0b-4e95-8fb5-d561f1e1a763 without hardware acceleration
[Nest] 38  - 03/30/2026, 5:38:14 PM     LOG [Api:WebsocketRepository] Websocket Disconnect: H2XmBTzt5nV4LkoDAAAX
[Nest] 7  - 03/30/2026, 5:38:15 PM     LOG [Microservices:MediaService] Successfully encoded c21c7c80-3a0b-4e95-8fb5-d561f1e1a763
[Nest] 7  - 03/30/2026, 5:38:15 PM   ERROR [Microservices:MediaRepository] ffmpeg version 7.1.3-Jellyfin Copyright (c) 2000-2025 the FFmpeg developers
  built with gcc 14 (Debian 14.2.0-19)
  configuration: --prefix=/usr/lib/jellyfin-ffmpeg --target-os=linux --extra-version=Jellyfin --disable-doc --disable-ffplay --disable-static --disable-libxcb --disable-sdl2 --disable-xlib --enable-lto=auto --enable-gpl --enable-version3 --enable-shared --enable-gmp --enable-gnutls --enable-chromaprint --enable-opencl --enable-libdrm --enable-libxml2 --enable-libass --enable-libfreetype --enable-libfribidi --enable-libfontconfig --enable-libharfbuzz --enable-libbluray --enable-libmp3lame --enable-libopus --enable-libtheora --enable-libvorbis --enable-libopenmpt --enable-libdav1d --enable-libsvtav1 --enable-libwebp --enable-libvpx --enable-libx264 --enable-libx265 --enable-libzvbi --enable-libzimg --enable-libfdk-aac --arch=amd64 --enable-libshaderc --enable-libplacebo --enable-vulkan --enable-vaapi --enable-amf --enable-libvpl --enable-ffnvcodec --enable-cuda --enable-cuda-llvm --enable-cuvid --enable-nvdec --enable-nvenc
  libavutil      59. 39.100 / 59. 39.100
  libavcodec     61. 19.101 / 61. 19.101
  libavformat    61.  7.100 / 61.  7.100
  libavdevice    61.  3.100 / 61.  3.100
  libavfilter    10.  4.100 / 10.  4.100
  libswscale      8.  3.100 /  8.  3.100
  libswresample   5.  3.100 /  5.  3.100
  libpostproc    58.  3.100 / 58.  3.100
[aist#0:1/pcm_s16le @ 0x55a5a27e24c0] Guessed Channel Layout: mono
Input #0, mov,mp4,m4a,3gp,3g2,mj2, from '/data/upload/bcb98309-dca4-4d85-8cc9-c80d20212ee3/3f/8f/3f8fb7fb-02ad-4816-88d4-4d0c32c7b628.MOV':
  Metadata:
    major_brand     : qt  
    minor_version   : 0
    compatible_brands: qt  
    creation_time   : 2023-05-13T09:20:27.000000Z
    com.apple.quicktime.location.accuracy.horizontal: 7.726043
    com.apple.quicktime.live-photo.auto: 1
    com.apple.quicktime.content.identifier: C6271053-D7D1-4BE3-8A80-D68E17EF5E81
    com.apple.quicktime.live-photo.vitality-score: 0.939811
    com.apple.quicktime.live-photo.vitality-scoring-version: 0
    com.apple.quicktime.location.ISO6709: +40.1465+116.4059+037.432/
    com.apple.quicktime.make: Apple
    com.apple.quicktime.model: iPhone 13 Pro Max
    com.apple.quicktime.software: 16.3.1
    com.apple.quicktime.creationdate: 2023-05-13T17:20:27+0800
  Duration: 00:00:02.03, start: 0.000000, bitrate: 12636 kb/s
  Stream #0:0[0x1](und): Video: hevc (Main), 1 reference frame (hvc1 / 0x31637668), yuvj420p(pc, smpte170m/smpte432/bt709, left), 1920x1440, 11840 kb/s, 28.52 fps, 30 tbr, 600 tbn (default)
      Metadata:
        creation_time   : 2023-05-13T09:20:27.000000Z
        handler_name    : Core Media Video
        vendor_id       : [0][0][0][0]
        encoder         : HEVC
      Side data:
        Frame cropping: 88/88/66/66
  Stream #0:1[0x2](und): Audio: pcm_s16le (lpcm / 0x6D63706C), 44100 Hz, mono, s16, 705 kb/s (default)
      Metadata:
        creation_time   : 2023-05-13T09:20:27.000000Z
        handler_name    : Core Media Audio
        vendor_id       : [0][0][0][0]
  Stream #0:2[0x3](und): Data: none (mebx / 0x7862656D), 0 kb/s (default)
      Metadata:
        creation_time   : 2023-05-13T09:20:27.000000Z
        handler_name    : Core Media Metadata
  Stream #0:3[0x4](und): Data: none (mebx / 0x7862656D), 32 kb/s (default)
      Metadata:
        creation_time   : 2023-05-13T09:20:27.000000Z
        handler_name    : Core Media Metadata
  Stream #0:4[0x5](und): Data: none (mebx / 0x7862656D), 504 kb/s (default)
      Metadata:
        creation_time   : 2023-05-13T09:20:27.000000Z
        handler_name    : Core Media Metadata
[out#0/image2 @ 0x55a5a280e080] No explicit maps, mapping streams automatically...
[vost#0:0/mjpeg @ 0x55a5a28050c0] Created video stream from input stream 0:0
[Parsed_thumbnail_1 @ 0x55a5a27e12c0] batch size: 12 frames
[Parsed_fps_0 @ 0x55a5a280e180] 0 frames in, 0 frames out; 0 frames dropped, 0 frames duplicated.
Stream mapping:
  Stream #0:0 -> #0:0 (hevc (native) -> mjpeg (native))
[vost#0:0/mjpeg @ 0x55a5a28050c0] Starting thread...
[vf#0:0 @ 0x55a5a27ef880] Starting thread...
[vist#0:0/hevc @ 0x55a5a27e2340] [dec:hevc @ 0x55a5a280cf80] Starting thread...
[in#0/mov,mp4,m4a,3gp,3g2,mj2 @ 0x55a5a27dcd80] Starting thread...
Press [q] to stop, [?] for help
[Parsed_thumbnail_1 @ 0x7f0e38001200] batch size: 12 frames
[graph -1 input from stream 0:0 @ 0x7f0e38010b00] w:1920 h:1440 pixfmt:yuvj420p tb:1/600 fr:30/1 sar:0/1 csp:smpte170m range:pc
[crop @ 0x7f0e380112c0] w:1920 h:1440 sar:0/1 -> w:1744 h:1308 sar:0/1
[Parsed_fps_0 @ 0x7f0e38001300] Set first pts to (in:0 out:0) from start time 0.000000
[Parsed_fps_0 @ 0x7f0e38001300] fps=12/1
[graph -1 input from stream 0:0 @ 0x7f0e38010b00] video frame properties congruent with link at pts_time: 0
[in#0/mov,mp4,m4a,3gp,3g2,mj2 @ 0x55a5a27dcd80] EOF while reading input
[in#0/mov,mp4,m4a,3gp,3g2,mj2 @ 0x55a5a27dcd80] Terminating thread with return code 0 (success)
[vist#0:0/hevc @ 0x55a5a27e2340] [dec:hevc @ 0x55a5a280cf80] Decoder thread received EOF packet
[vist#0:0/hevc @ 0x55a5a27e2340] [dec:hevc @ 0x55a5a280cf80] Decoder returned EOF, finishing
[Parsed_thumbnail_1 @ 0x7f0e38001200] frame id #0 (pts_time=0.000000) selected from a set of 12 images
[vist#0:0/hevc @ 0x55a5a27e2340] [dec:hevc @ 0x55a5a280cf80] Terminating thread with return code 0 (success)
[Parsed_thumbnail_1 @ 0x7f0e38001200] frame id #2 (pts_time=1.166667) selected from a set of 6 images
[Nest] 7  - 03/30/2026, 5:38:15 PM   ERROR [Microservices:{"source":"upload","id":"8f142615-77a5-468b-9468-0aa140951690"}] Unable to run job handler (AssetGenerateThumbnails): Error: ffmpeg was killed with signal SIGSEGV
Error: ffmpeg was killed with signal SIGSEGV
    at ChildProcess.<anonymous> (/usr/src/app/server/node_modules/.pnpm/fluent-ffmpeg@2.1.3/node_modules/fluent-ffmpeg/lib/processor.js:178:22)
    at ChildProcess.emit (node:events:508:28)
    at ChildProcess._handle.onexit (node:internal/child_process:294:12)
[Nest] 7  - 03/30/2026, 5:38:15 PM     LOG [Microservices:PersonService] Detected 2 new faces in asset dfe265c6-795b-47c3-a69a-c4f60267a87b
[Nest] 38  - 03/30/2026, 5:40:28 PM     LOG [Api:SystemConfigService~vnztx85q] LogLevel=log (set via system config)
[Nest] 7  - 03/30/2026, 5:40:28 PM     LOG [Microservices:SystemConfigService] LogLevel=log (set via system config)

Additional information

No response

[KillLinux]

By the way, when starting a backup from this iPhone 13 Pro Max, the immich-server container keeps writing files to the overlay2 directory continuously until the 50GiB hard drive is full.

[alextran1502]

UPLOAD_LOCATION=/Immich_file

Did you mount anything at the /Immich_file location?

[KillLinux]

Yes, I have mounted a ZFS share (1TiB SSD) from TrueNAS under the /Immich_file directory, and Immich can read from and write to it normally.

[alextran1502]

Can you share a sample video?

[KillLinux]

sure,I’ll directly provide you with the problematic video from the logs that caused the error.

3f8fb7fb-02ad-4816-88d4-4d0c32c7b628.MOV

[alextran1502]

Hmm, the video works fine on my instance, seeing an orange Mustang

[KillLinux]

But for some reason, Immich doesn't seem to be able to generate a thumbnail for it, which is quite strange—videos recorded on other devices can all be transcoded and have thumbnails generated normally.

[alextran1502]

What is your Linux Kernel version?

[KillLinux]

3.10.0-1160.119.1.el17.x86_64

[Mirage1337]

I am running into this exact same SIGSEGV issue on my instance during the AssetGenerateThumbnails job.

I wanted to add some metadata context that might help narrow down the root cause. After digging into my logs, the crash consistently happens exclusively on the HEVC .mov components of Apple Live Photos, and specifically from an older iOS version.

In my case the videos are from an iPhone 11 with iOS 14.7.1.

Here's part of the log:

[vist#0:0/hevc @ 0x558f51abafc0] [dec:hevc @ 0x558f51ada400] Decoder thread received EOF packet [Parsed_thumbnail_1 @ 0x7f9c10001200] frame id #0 (pts_time=0.000000) selected from a set of 12 images [vist#0:0/hevc @ 0x558f51abafc0] [dec:hevc @ 0x558f51ada400] Decoder returned EOF, finishing [vist#0:0/hevc @ 0x558f51abafc0] [dec:hevc @ 0x558f51ada400] Terminating thread with return code 0 (success) [Parsed_thumbnail_1 @ 0x7f9c10001200] frame id #4 (pts_time=1.333333) selected from a set of 12 images [Nest] 7 - 04/01/2026, 12:49:45 AM ERROR [Microservices:{"id":"026be73c-927c-4b3c-b3d3-8345cdbe7d3e"}] Unable to run job handler (AssetGenerateThumbnails): Error: ffmpeg was killed with signal SIGSEGV

[KillLinux]

It seems that ffmpeg crashes whenever generating thumbnails for Live Photos taken on an iPhone. I have confirmed on my phone that all the files causing these errors are Live Photos, which is consistent with the situation mentioned by @Mirage1337.

Input #0, mov,mp4,m4a,3gp,3g2,mj2, from '/data/library/bcb98309-dca4-4d85-8cc9-c80d20212ee3/2021/2021-02-10/IMG_6502.mov':
  Metadata:
    major_brand     : qt
    minor_version   : 0
    compatible_brands: qt
    creation_time   : 2021-02-10T14:32:16.000000Z
    com.apple.quicktime.location.accuracy.horizontal: 65.000000
    com.apple.quicktime.location.ISO6709: +41.2790+123.7605+167.947/
    com.apple.quicktime.make: Apple
    com.apple.quicktime.model: iPhone 8 Plus
    com.apple.quicktime.software: 14.3
    com.apple.quicktime.creationdate: 2021-02-10T22:32:09+0800
    com.apple.quicktime.content.identifier: E1F30175-F9D1-4CB0-A214-029C2B3F4BE5
  Duration: 00:00:02.57, start: 0.000000, bitrate: 11562 kb/s
  Stream #0:0[0x1](und): Video: hevc (Main), 1 reference frame (hvc1 / 0x31637668), yuvj420p(pc, smpte170m/smpte432/bt709, left), 1440x1080, 10810 kb/s, 27.27 fps, 30 tbr, 600 tbn (default)
      Metadata:
        creation_time   : 2021-02-10T14:32:16.000000Z
        handler_name    : Core Media Video
        vendor_id       : [0][0][0][0]
        encoder         : HEVC
      Side data:
        Frame cropping: 66/66/50/50
  Stream #0:1[0x2](und): Audio: pcm_s16le (lpcm / 0x6D63706C), 44100 Hz, mono, s16, 705 kb/s (default)
      Metadata:
        creation_time   : 2021-02-10T14:32:16.000000Z
        handler_name    : Core Media Audio
        vendor_id       : [0][0][0][0]
  Stream #0:2[0x3](und): Data: none (mebx / 0x7862656D), 31 kb/s (default)
      Metadata:
        creation_time   : 2021-02-10T14:32:16.000000Z
        handler_name    : Core Media Metadata
  Stream #0:3[0x4](und): Data: none (mebx / 0x7862656D), 43 kb/s (default)
      Metadata:
        creation_time   : 2021-02-10T14:32:16.000000Z
        handler_name    : Core Media Metadata

[Nest] 7  - 04/01/2026, 3:42:50 PM   ERROR [Microservices:{"source":"upload","id":"0288f0c9-d91d-4c11-b2b9-74f4d70c54df"}] Unable to run job handler (AssetGenerateThumbnails): Error: ffmpeg was killed with signal SIGSEGV
Error: ffmpeg was killed with signal SIGSEGV
    at ChildProcess.<anonymous> (/usr/src/app/server/node_modules/.pnpm/fluent-ffmpeg@2.1.3/node_modules/fluent-ffmpeg/lib/processor.js:178:22)
    at ChildProcess.emit (node:events:508:28)
    at ChildProcess._handle.onexit(node:internal/child_process:294:12)

[meesfrensel]

Centos 7 has been end of life since july 2024 and although it's basically a guess, it would not at all surprise me if the segfault is caused by outdated dependencies or something.

To find out if the segfault is caused by a misconfiguration of the ffmpeg command by Immich (unlikely) or your system (more likely), you can try to run the ffmpeg command directly on the host, or from a shell in the server container.

[alextran1502]

I think this issue comes down to the deployment environment. As we have not seen other reports regarding the issue