Skip to content

macOS Web UI restart causes SIGTRAP crash in TaskPool::worker #5236

@lu920115

Description

@lu920115

Is there an existing issue for this?

  • I have searched the existing issues

Is your issue described in the documentation?

  • I have read the documentation

Describe the Bug

On macOS, clicking the Restart button in the Web UI causes Sunshine to crash with Trace/BPT trap: 5 (SIGTRAP). The process is terminated by itself via raise() from the TaskPool::worker thread during the restart sequence. The service does not automatically recover and must be manually restarted via launchctl or brew services restart.

This is 100% reproducible every time the restart button is clicked in the Web UI.

Expected Behavior

Sunshine should restart cleanly without crashing when the restart button is clicked in the Web UI.

Additional Context

  • The crash occurs in task_pool_util::TaskPool::pushDelayed which calls raise()pthread_kill__pthread_kill, resulting in SIGTRAP.
  • Sunshine is running as a LaunchAgent service (homebrew.mxcl.sunshine).
  • Normal cold start (boot/reboot) works fine; only the Web UI restart triggers the crash.
  • I checked the latest pre-release (v2026.531.163415) changelog and did not find a fix for this specific issue.

Host Operating System

macOS

Operating System Version

macOS 26.5 (25F71)

Architecture

arm64 / Apple Silicon (Mac mini M4)

Sunshine commit or version

2026.516.143833

Package

macOS - Homebrew

GPU Type

Apple Silicon (VideoToolbox)

Config

address = 0.0.0.0
address_family = both
locale = zh
upnp = enabled

Relevant log output

# Crash excerpt from macOS DiagnosticReports (sunshine-2026-06-01-060909.ips)

exception: {"type":"EXC_CRASH","signal":"SIGTRAP"}
termination: {"code":5,"namespace":"SIGNAL","indicator":"Trace/BPT trap: 5","byProc":"sunshine","byPid":62102}
faultingThread: 2

# Thread 2 (TaskPool::worker) stack trace:
0   libsystem_kernel.dylib    __pthread_kill + 8
1   libsystem_pthread.dylib   pthread_kill + 296
2   libsystem_c.dylib         raise + 32
3   sunshine                  task_pool_util::TaskPool::pushDelayed<...>::operator()() + 120
4   sunshine                  std::__1::packaged_task<void ()>::operator()() + 80
5   sunshine                  thread_pool_util::ThreadPool::_main() + 128
6   sunshine                  std::__1::__thread_proxy<...> + 72
7   libsystem_pthread.dylib   _pthread_start + 136

Full crash log

Click to expand full .ips crash report
{"app_name":"sunshine","timestamp":"2026-06-01 06:09:09.00 +0800","app_version":"2026.516.143833","slice_uuid":"9ba8f269-26c2-32d2-91c9-6616d00f8cd1","build_version":"2026.516.143833","platform":1,"share_with_app_devs":1,"is_first_party":1,"bug_type":"309","os_version":"macOS 26.5 (25F71)","roots_installed":0,"incident_id":"E434CD96-98C8-4DA8-B5A2-030FA184CFB2","name":"sunshine"}
{
  "uptime" : 740000,
  "procRole" : "Unspecified",
  "version" : 2,
  "userID" : 501,
  "deployVersion" : 210,
  "modelCode" : "Mac16,10",
  "coalitionID" : 101012,
  "osVersion" : {
    "train" : "macOS 26.5",
    "build" : "25F71",
    "releaseType" : "User"
  },
  "captureTime" : "2026-06-01 06:09:05.5549 +0800",
  "codeSigningMonitor" : 2,
  "incident" : "E434CD96-98C8-4DA8-B5A2-030FA184CFB2",
  "pid" : 62102,
  "translated" : false,
  "cpuType" : "ARM-64",
  "procLaunch" : "2026-05-31 22:21:24.3923 +0800",
  "procExitAbsTime" : 17775791343947,
  "procName" : "sunshine",
  "procPath" : "\/opt\/homebrew\/*\/sunshine",
  "bundleInfo" : {"CFBundleVersion":"2026.516.143833","CFBundleShortVersionString":"2026.516.143833"},
  "parentProc" : "launchd",
  "parentPid" : 1,
  "coalitionName" : "homebrew.mxcl.sunshine",
  "crashReporterKey" : "D8F14FDE-DB36-3E99-FD93-680FB7432767",
  "developerMode" : 1,
  "throttleTimeout" : 10,
  "codeSigningID" : "dev.lizardbyte.app.Sunshine",
  "codeSigningTeamID" : "",
  "codeSigningFlags" : 570425857,
  "codeSigningValidationCategory" : 10,
  "codeSigningTrustLevel" : 4294967295,
  "bootSessionUUID" : "C7454DB7-6E65-453E-9582-E2268034FCA5",
  "sip" : "enabled",
  "exception" : {"codes":"0x0000000000000000, 0x0000000000000000","rawCodes":[0,0],"type":"EXC_CRASH","signal":"SIGTRAP"},
  "termination" : {"flags":0,"code":5,"namespace":"SIGNAL","indicator":"Trace\/BPT trap: 5","byProc":"sunshine","byPid":62102},
  "os_fault" : {"process":"sunshine"},
  "faultingThread" : 2,
  "threads" : [
    {
      "id":7999844,
      "queue":"com.apple.main-thread",
      "frames":[
        {"imageOffset":11000,"symbol":"__ulock_wait","symbolLocation":8,"imageIndex":23},
        {"imageOffset":37140,"symbol":"_pthread_join","symbolLocation":616,"imageIndex":24},
        {"imageOffset":163364,"symbol":"std::__1::thread::join()","symbolLocation":36,"imageIndex":25},
        {"imageOffset":282484,"symbol":"main","symbolLocation":3664,"imageIndex":0},
        {"imageOffset":130560,"symbol":"start","symbolLocation":6992,"imageIndex":26}
      ]
    },
    {
      "triggered":true,
      "id":7999846,
      "name":"TaskPool::worker",
      "frames":[
        {"imageOffset":38376,"symbol":"__pthread_kill","symbolLocation":8,"imageIndex":23},
        {"imageOffset":26840,"symbol":"pthread_kill","symbolLocation":296,"imageIndex":24},
        {"imageOffset":266260,"symbol":"raise","symbolLocation":32,"imageIndex":28},
        {"imageOffset":291456,"symbol":"std::__1::__packaged_task_func<auto task_pool_util::TaskPool::pushDelayed<main::$_0::operator()() const::'lambda'()&, long long, std::__1::ratio<1l, 1l>>(main::$_0::operator()() const::'lambda'()&, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1l>>)::'lambda'(), std::__1::allocator<std::__1::allocator>, void ()>::operator()()","symbolLocation":120,"imageIndex":0},
        {"imageOffset":291800,"symbol":"std::__1::packaged_task<void ()>::operator()()","symbolLocation":80,"imageIndex":0},
        {"imageOffset":285408,"symbol":"thread_pool_util::ThreadPool::_main()","symbolLocation":128,"imageIndex":0},
        {"imageOffset":287600,"symbol":"void* std::__1::__thread_proxy[abi:nqe210106]<std::__1::tuple<std::__1::unique_ptr<std::__1::__thread_struct, std::__1::default_delete<std::__1::__thread_struct>>, void (thread_pool_util::ThreadPool::*)(), thread_pool_util::ThreadPool*>>(void*)","symbolLocation":72,"imageIndex":0},
        {"imageOffset":27736,"symbol":"_pthread_start","symbolLocation":136,"imageIndex":24},
        {"imageOffset":7196,"symbol":"thread_start","symbolLocation":8,"imageIndex":24}
      ]
    }
  ],
  "usedImages" : [
    {
      "source" : "P",
      "arch" : "arm64",
      "base" : 4334600192,
      "size" : 12009472,
      "uuid" : "9ba8f269-26c2-32d2-91c9-6616d00f8cd1",
      "path" : "\/opt\/homebrew\/*\/sunshine",
      "name" : "sunshine"
    }
  ]
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions