electron builder.Interface.NsisWebOptions

URL like https://example.com/download/latest allows web installer to be version independent (installer will download latest application package). Please note — it is full URL.

Custom X-Arch http header is set to 32 or 64.

artifactName?¶

readonly optional artifactName: null | string

The artifact file name template. Defaults to ${productName} Web Setup ${version}.${ext}.

Overrides¶

NsisOptions.artifactName

createDesktopShortcut?¶

readonly optional createDesktopShortcut: boolean | "always"

Whether to create desktop shortcut. Set to always if to recreate also on reinstall (even if removed by user).

Default¶

true

Inherited from¶

NsisOptions.createDesktopShortcut

createStartMenuShortcut?¶

readonly optional createStartMenuShortcut: boolean

Whether to create start menu shortcut.

Default¶

true

Inherited from¶

NsisOptions.createStartMenuShortcut

customNsisBinary?¶

readonly optional customNsisBinary: null | CustomNsisBinary

Allows you to provide your own makensis, such as one with support for debug logging via LogSet and LogText. (Logging also requires option debugLogging = true)

Inherited from¶

NsisOptions.customNsisBinary

deleteAppDataOnUninstall?¶

readonly optional deleteAppDataOnUninstall: boolean

one-click installer only. Whether to delete app data on uninstall.

Default¶

false

Inherited from¶

NsisOptions.deleteAppDataOnUninstall

displayLanguageSelector?¶

readonly optional displayLanguageSelector: boolean

Whether to display a language selection dialog. Not recommended (by default will be detected using OS language).

Default¶

false

Inherited from¶

NsisOptions.displayLanguageSelector

guid?¶

readonly optional guid: null | string

See GUID vs Application Name.

Inherited from¶

NsisOptions.guid

include?¶

readonly optional include: null | string

The path to NSIS include script to customize installer. Defaults to build/installer.nsh. See Custom NSIS script.

Inherited from¶

NsisOptions.include

installerHeader?¶

readonly optional installerHeader: null | string

assisted installer only. MUI_HEADERIMAGE, relative to the build resources or to the project directory.

Default¶

build/installerHeader.bmp

Inherited from¶

NsisOptions.installerHeader

installerHeaderIcon?¶

readonly optional installerHeaderIcon: null | string

one-click installer only. The path to header icon (above the progress bar), relative to the build resources or to the project directory. Defaults to build/installerHeaderIcon.ico or application icon.

Inherited from¶

NsisOptions.installerHeaderIcon

installerIcon?¶

readonly optional installerIcon: null | string

The path to installer icon, relative to the build resources or to the project directory. Defaults to build/installerIcon.ico or application icon.

Inherited from¶

NsisOptions.installerIcon

installerLanguages?¶

readonly optional installerLanguages: null | string | string[]

The installer languages (e.g. en_US, de_DE). Change only if you understand what do you do and for what.

Inherited from¶

NsisOptions.installerLanguages

installerSidebar?¶

readonly optional installerSidebar: null | string

assisted installer only. MUI_WELCOMEFINISHPAGE_BITMAP, relative to the build resources or to the project directory. Defaults to build/installerSidebar.bmp or ${NSISDIR}\\Contrib\\Graphics\\Wizard\\nsis3-metro.bmp. Image size 164 × 314 pixels.

Inherited from¶

NsisOptions.installerSidebar

language?¶

readonly optional language: null | string

LCID Dec, defaults to 1033(English - United States).

Inherited from¶

NsisOptions.language

license?¶

readonly optional license: null | string

The path to EULA license file. Defaults to license.txt or eula.txt (or uppercase variants). In addition to txt, rtf and html supported (don’t forget to use target="_blank" for links).

Multiple license files in different languages are supported — use lang postfix (e.g. _de, _ru). For example, create files license_de.txt and license_en.txt in the build resources. If OS language is german, license_de.txt will be displayed. See map of language code to name.

Appropriate license file will be selected by user OS language.

Inherited from¶

NsisOptions.license

menuCategory?¶

readonly optional menuCategory: string | boolean

Whether to create submenu for start menu shortcut and program files directory. If true, company name will be used. Or string value.

Default¶

false

Inherited from¶

NsisOptions.menuCategory

multiLanguageInstaller?¶

readonly optional multiLanguageInstaller: boolean

Whether to create multi-language installer. Defaults to unicode option value.

Inherited from¶

NsisOptions.multiLanguageInstaller

oneClick?¶

readonly optional oneClick: boolean

Whether to create one-click installer or assisted.

Default¶

true

Inherited from¶

NsisOptions.oneClick

packElevateHelper?¶

readonly optional packElevateHelper: boolean

Whether to pack the elevate executable (required for electron-updater if per-machine installer used or can be used in the future). Ignored if perMachine is set to true.

Default¶

true

Inherited from¶

NsisOptions.packElevateHelper

perMachine?¶

readonly optional perMachine: boolean

Whether to show install mode installer page (choice per-machine or per-user) for assisted installer. Or whether installation always per all users (per-machine).

If oneClick is true (default): Whether to install per all users (per-machine).

If oneClick is false and perMachine is true: no install mode installer page, always install per-machine.

If oneClick is false and perMachine is false (default): install mode installer page.

Default¶

false

Inherited from¶

NsisOptions.perMachine

preCompressedFileExtensions?¶

readonly optional preCompressedFileExtensions: null | string | string[]

The file extension of files that will be not compressed. Applicable only for extraResources and extraFiles files.

Default¶

[".avi", ".mov", ".m4v", ".mp4", ".m4p", ".qt", ".mkv", ".webm", ".vmdk"]

Inherited from¶

NsisOptions.preCompressedFileExtensions

publish?¶

optional publish: Publish

Inherited from¶

NsisOptions.publish

removeDefaultUninstallWelcomePage?¶

readonly optional removeDefaultUninstallWelcomePage: boolean

assisted installer only. remove the default uninstall welcome page.

Default¶

false

Inherited from¶

NsisOptions.removeDefaultUninstallWelcomePage

runAfterFinish?¶

readonly optional runAfterFinish: boolean

Whether to run the installed application after finish. For assisted installer corresponding checkbox will be removed.

Default¶

true

Inherited from¶

NsisOptions.runAfterFinish

script?¶

readonly optional script: null | string

The path to NSIS script to customize installer. Defaults to build/installer.nsi. See Custom NSIS script.

Inherited from¶

NsisOptions.script

selectPerMachineByDefault?¶

readonly optional selectPerMachineByDefault: boolean

Whether to set per-machine or per-user installation as default selection on the install mode installer page.

Default¶

false

Inherited from¶

NsisOptions.selectPerMachineByDefault

shortcutName?¶

readonly optional shortcutName: null | string

The name that will be used for all shortcuts. Defaults to the application name.

Inherited from¶

NsisOptions.shortcutName

unicode?¶

readonly optional unicode: boolean

Whether to create Unicode installer.

Default¶

true

Inherited from¶

NsisOptions.unicode

uninstallDisplayName?¶

readonly optional uninstallDisplayName: string

The uninstaller display name in the control panel.

Default¶

${productName} ${version}

Inherited from¶

NsisOptions.uninstallDisplayName

uninstallerIcon?¶

readonly optional uninstallerIcon: null | string

The path to uninstaller icon, relative to the build resources or to the project directory. Defaults to build/uninstallerIcon.ico or application icon.

Inherited from¶

NsisOptions.uninstallerIcon

uninstallerSidebar?¶

readonly optional uninstallerSidebar: null | string

assisted installer only. MUI_UNWELCOMEFINISHPAGE_BITMAP, relative to the build resources or to the project directory. Defaults to installerSidebar option or build/uninstallerSidebar.bmp or build/installerSidebar.bmp or ${NSISDIR}\\Contrib\\Graphics\\Wizard\\nsis3-metro.bmp

Inherited from¶

NsisOptions.uninstallerSidebar

warningsAsErrors?¶

readonly optional warningsAsErrors: boolean

If warningsAsErrors is true (default): NSIS will treat warnings as errors. If warningsAsErrors is false: NSIS will allow warnings.

Default¶

true

Inherited from¶

NsisOptions.warningsAsErrors