Skip to content

electron builder.Interface.NsisWebOptions

Electron-Builder / electron-builder / NsisWebOptions

Web Installer options.

Extends

Properties

allowElevation?

readonly optional allowElevation: boolean

assisted installer only. Allow requesting for elevation. If false, user will have to restart installer with elevated permissions.

Default

true

Inherited from

NsisOptions.allowElevation


allowToChangeInstallationDirectory?

readonly optional allowToChangeInstallationDirectory: boolean

assisted installer only. Whether to allow user to change installation directory.

Default

false

Inherited from

NsisOptions.allowToChangeInstallationDirectory


appPackageUrl?

readonly optional appPackageUrl: null | string

The application package download URL. Optional — by default computed using publish configuration.

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


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