DMG

October 16, 2025 ยท View on GitHub

The DMG target builds Apple Disk Image (.dmg) files, which are the standard format for sharing macOS apps. The DMG acts like a ZIP file, but provides an easy way for users to take the app and put it in the /Applications directory.

{% include "../../.gitbook/includes/static-file-auto-updates-wi....md" %}

Requirements

You can only build the DMG target on macOS machines.

Installation

npm install --save-dev @electron-forge/maker-dmg

Usage

To use @electron-forge/maker-dmg, add it to the makers array in your Forge configuration:

{% code title="forge.config.js" %}

module.exports = {
  makers: [
    {
      name: '@electron-forge/maker-dmg',
      config: {
        background: './assets/dmg-background.png',
        format: 'ULFO'
      }
    }
  ]
};

{% endcode %}

Configuration options are documented in MakerDMGConfig.

Debugging

For advanced debug logging for this maker, add the DEBUG=electron-installer-dmg* environment variable.