fix: detect .deb installs and show apt-specific update messaging (#281)

* fix: detect system-managed installs and show apt-specific update messaging

On Linux system-managed installs (.deb), the ToDesktop in-app auto-updater
cannot self-update the package. Detect system-managed installs by checking
the executable path (installed under /opt/ or /usr/) and expose update
capabilities to the renderer via a capability-based IPC contract:

  { canAutoUpdate: boolean, systemManaged: boolean }

The renderer uses these capabilities to:
- Show apt-specific instructions when an update is available
- Hide the Download button when canAutoUpdate is false
- Show apt guidance when Check for Updates reports up-to-date

The ToDesktop updater is still attempted - if electron-updater's pkexec
path works, the standard flow proceeds. Otherwise users see clear
instructions to use their system package manager.

Closes #280

Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019d12c7-2178-74d2-b898-b627c26ffe01

* fix: render backtick commands as code tags and strengthen test assertions

- Rename boldify to formatMarkdown; also convert backticks to <code>
- SettingsView tests now mock useModal and assert the correct i18n
  string (upToDate vs debUpToDate) is passed to modal.alert
- UpdateBanner test verifies backticks are rendered as <code> tags

Amp-Thread-ID: https://ampcode.com/threads/T-019d12c7-2178-74d2-b898-b627c26ffe01
Co-authored-by: Amp <amp@ampcode.com>

---------

Co-authored-by: Amp <amp@ampcode.com>

Author: Kosinkadink

locales/en.json

@@ -317,7 +317,9 @@
     "retry": "Retry",
     "updateCheck": "Update Check",
     "updateError": "Update Error",
-    "upToDate": "You are running the latest version of ComfyUI Desktop 2.0."
+    "upToDate": "You are running the latest version of ComfyUI Desktop 2.0.",
+    "debAvailable": "Update **v{version}** is available. Run `sudo apt update && sudo apt upgrade` to update, or download the new .deb from the releases page.",
+    "debUpToDate": "You are running the latest version. Updates for .deb installs are delivered through your system package manager (apt)."
   },
 
   "modal": {

src/main/lib/updater.test.ts

@@ -0,0 +1,128 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+let mockPlatform = 'linux'
+let mockAppImage: string | undefined
+let mockIsPackaged = true
+let mockExePath = '/opt/ComfyUI Desktop 2.0/comfyui-desktop-2'
+
+vi.mock('electron', () => ({
+  app: {
+    get isPackaged() {
+      return mockIsPackaged
+    },
+    getPath: (name: string) => {
+      if (name === 'exe') return mockExePath
+      return ''
+    },
+  },
+  ipcMain: {
+    handle: vi.fn(),
+  },
+  BrowserWindow: {
+    getAllWindows: () => [],
+  },
+}))
+
+vi.mock('@todesktop/runtime', () => ({
+  default: { autoUpdater: null },
+}))
+
+vi.mock('../settings', () => ({
+  get: vi.fn(),
+}))
+
+vi.mock('./quit-state', () => ({
+  clearQuitReason: vi.fn(),
+  setQuitReason: vi.fn(),
+}))
+
+const originalPlatform = Object.getOwnPropertyDescriptor(process, 'platform')!
+
+describe('isSystemPackageInstall (via get-update-capabilities)', () => {
+  let registeredHandlers: Record<string, (...args: unknown[]) => unknown>
+
+  beforeEach(async () => {
+    registeredHandlers = {}
+    const { ipcMain } = await import('electron')
+    vi.mocked(ipcMain.handle).mockImplementation(((channel: string, handler: (...args: unknown[]) => unknown) => {
+      registeredHandlers[channel] = handler
+    }) as typeof ipcMain.handle)
+
+    mockPlatform = 'linux'
+    mockAppImage = undefined
+    mockIsPackaged = true
+    mockExePath = '/opt/ComfyUI Desktop 2.0/comfyui-desktop-2'
+
+    delete process.env.APPIMAGE
+    Object.defineProperty(process, 'platform', { value: mockPlatform, configurable: true })
+
+    vi.resetModules()
+  })
+
+  afterEach(() => {
+    Object.defineProperty(process, 'platform', originalPlatform)
+  })
+
+  async function getCapabilities(): Promise<{ canAutoUpdate: boolean; systemManaged: boolean }> {
+    Object.defineProperty(process, 'platform', { value: mockPlatform, configurable: true })
+    if (mockAppImage) {
+      process.env.APPIMAGE = mockAppImage
+    } else {
+      delete process.env.APPIMAGE
+    }
+
+    vi.resetModules()
+    const updater = await import('./updater')
+    updater.register()
+    const handler = registeredHandlers['get-update-capabilities']!
+    return handler() as { canAutoUpdate: boolean; systemManaged: boolean }
+  }
+
+  it('detects .deb install under /opt/', async () => {
+    mockExePath = '/opt/ComfyUI Desktop 2.0/comfyui-desktop-2'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: false, systemManaged: true })
+  })
+
+  it('detects .deb install under /usr/', async () => {
+    mockExePath = '/usr/lib/comfyui-desktop-2/comfyui-desktop-2'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: false, systemManaged: true })
+  })
+
+  it('returns standard for AppImage (APPIMAGE env set)', async () => {
+    mockAppImage = '/home/user/ComfyUI-Desktop-2.0.AppImage'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: true, systemManaged: false })
+  })
+
+  it('returns standard for Windows', async () => {
+    mockPlatform = 'win32'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: true, systemManaged: false })
+  })
+
+  it('returns standard for macOS', async () => {
+    mockPlatform = 'darwin'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: true, systemManaged: false })
+  })
+
+  it('returns standard when not packaged (dev mode)', async () => {
+    mockIsPackaged = false
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: true, systemManaged: false })
+  })
+
+  it('returns standard for Linux exe under /home/ (manual extract)', async () => {
+    mockExePath = '/home/user/apps/comfyui-desktop-2'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: true, systemManaged: false })
+  })
+
+  it('returns standard for Linux exe under /tmp/ (temp location)', async () => {
+    mockExePath = '/tmp/.mount_comfyui/comfyui-desktop-2'
+    const caps = await getCapabilities()
+    expect(caps).toEqual({ canAutoUpdate: true, systemManaged: false })
+  })
+})

src/main/lib/updater.ts

@@ -1,4 +1,4 @@
-import { ipcMain, BrowserWindow } from 'electron'
+import { app, ipcMain, BrowserWindow } from 'electron'
 import todesktop from '@todesktop/runtime'
 import * as settings from '../settings'
 import { clearQuitReason, setQuitReason } from './quit-state'
@@ -13,6 +13,14 @@ let _listenersBound = false
 const NO_UPDATE_AVAILABLE_MESSAGE = 'No update available. Try checking for updates first.'
 const UPDATER_UNAVAILABLE_MESSAGE = 'ToDesktop auto-updater is unavailable.'
 
+function isSystemPackageInstall(): boolean {
+  if (process.platform !== 'linux' || !app.isPackaged) return false
+  if (process.env.APPIMAGE) return false
+  // .deb installs place the app under /opt/ or /usr/; check the executable path
+  const appPath = app.getPath('exe')
+  return appPath.startsWith('/opt/') || appPath.startsWith('/usr/')
+}
+
 function broadcast(channel: string, data: unknown): void {
   BrowserWindow.getAllWindows().forEach((win) => {
     try {
@@ -153,6 +161,11 @@ export function register(): void {
 
   ipcMain.handle('get-pending-update', () => _updateInfo)
 
+  ipcMain.handle('get-update-capabilities', () => {
+    const systemManaged = isSystemPackageInstall()
+    return { canAutoUpdate: !systemManaged, systemManaged }
+  })
+
   // Check on startup and periodically (respects autoUpdate setting at each check)
   const runIfEnabled = (): void => {
     if (settings.get('autoUpdate') !== false) runCheck('auto-check').catch(() => {})

src/preload/index.ts

@@ -108,6 +108,7 @@ const api: ElectronApi = {
   downloadUpdate: () => ipcRenderer.invoke('download-update'),
   installUpdate: () => ipcRenderer.invoke('install-update'),
   getPendingUpdate: () => ipcRenderer.invoke('get-pending-update'),
+  getUpdateCapabilities: () => ipcRenderer.invoke('get-update-capabilities'),
 
   // Event listeners (return unsubscribe functions)
   onInstallProgress: (callback) => {