From WPKG | Open Source Software Deployment and Distribution
Jump to: navigation, search

This page is for Mozilla Firefox, available from


Link to latest Firefox installer at:

Command-line options for the installer are documented here, which also describes how to use a config.ini file for basic configuration of the Firefox install.

See Firefox#Customization for details on customizing the installation, installing extensions, and setting and locking preferences.

The section below called firefox#Adding_the_settings_to_your_package_definition contains the extra lines you'll need to supply Firefox with a specific configuration.

Firefox ESR 68.8.0 x86 and x64 version (WPKG 1.3.1)

This package is for the Extended Support Release (ESR) x86 and x64 versions of Firefox provided with a .ini for installation and client configuration.

Put the x86 and x64 install in two sub folder named x86 and x64 in %SOFTWARE%/Mozilla/Firefox.

	name="Mozilla Firefox"
	<variable name="PKG_VERSION"		value="68.8.0" />
	<variable name="PKG_LOCALE"		value="ru" />
	<variable name="PKG_ARCHITECTURE"	value="x86" architecture="x86" />
	<variable name="PKG_ARCHITECTURE"	value="x64" architecture="x64" />
	<variable name="PKG_SOURCE"		value="%SOFTWARE%\Mozilla\Firefox" />
	<variable name="PKG_NAME"		value="Firefox Setup %PKG_VERSION%esr.exe" />
	<variable name="PKG_INSTALL_SWITCH"	value="-ms /INI=%PKG_SOURCE%\config.ini" />
	<variable name="PKG_REMOVE_SWITCH"	value="-ms" />
	<variable name="PKG_DESTINATION"	value="%ProgramFiles%\Mozilla Firefox" />
	<variable name="PKG_CONFIG1" 		value="%PKG_SOURCE%\settings\mozilla.cfg" />
	<variable name="PKG_CONFIG2" 		value="%PKG_SOURCE%\settings\policies.js" />
	<check type="uninstall" condition="exists" path="Mozilla Firefox %PKG_VERSION% ESR (%PKG_ARCHITECTURE% %PKG_LOCALE%)" />
	<install cmd="taskkill /F /IM Firefox.exe">
		<exit code="0" />
		<exit code="1" />
		<exit code="128" />

	<install cmd='%COMSPEC% /C copy /Y /V "%PKG_CONFIG1%" "%PKG_DESTINATION%\"' /> 
	<install cmd='%COMSPEC% /C copy /Y /V "%PKG_CONFIG2%" "%PKG_DESTINATION%\defaults\pref\"' />

	<upgrade cmd="taskkill /F /IM Firefox.exe">
		<exit code="0" />
		<exit code="128" />
		<exit code="1" />
	<upgrade cmd='"%PKG_SOURCE%\%PKG_ARCHITECTURE%\%PKG_NAME%" -ms' />
	<upgrade cmd='%COMSPEC% /C copy /Y /V "%PKG_CONFIG1%" "%PKG_DESTINATION%\"' />
	<upgrade cmd='%COMSPEC% /C copy /Y /V "%PKG_CONFIG2%" "%PKG_DESTINATION%\defaults\pref\"' />
 	<remove cmd="taskkill /F /IM Firefox.exe">
		<exit code="0" />
		<exit code="128" />
		<exit code="1" />
	<remove cmd='%COMSPEC% /C if exist "%PKG_DESTINATION%\uninstall\helper.exe" "%PKG_DESTINATION%\uninstall\helper.exe" %PKG_REMOVE_SWITCH%' />

Firefox 19 - 58 (For current versions of WPKG)

This package is for versions of Firefox 19 and higher but works the same for versions of Firefox 19 to 58.

This package works with 32-bit and 64-bit architectures but requires you alter the 'architecture' value for 64-bit systems.

	name="Mozilla Firefox"
	<variable name="version" value="58.0.2" />
	<variable name="architecture" value="x86" />
	<variable name="locale" value="en-GB" />
	<!--  <variable name="locale" value="fr" /> -->

	<check type="uninstall" condition="exists" path="Mozilla Firefox %version% (%architecture% %locale%)" />
	<install cmd="taskkill /F /IM Firefox.exe">
		<exit code="0" />
		<exit code="-1073741515" />
		<exit code="128" />
	<install cmd='"%SOFTWARE%\firefox\Firefox Setup %version%.exe" -ms' />
	<upgrade include="install" />
	<remove cmd="taskkill /F /IM Firefox.exe">
		<exit code="0" />
		<exit code="128" />
		<exit code="-1073741515" />
	<!-- for 32bit and 64bit System -->
	<remove cmd='%COMSPEC% /C if exist "%PROGRAMFILES%\Mozilla Firefox\uninstall\helper.exe" "%PROGRAMFILES%\Mozilla Firefox\uninstall\helper.exe" -ms' />
	<remove cmd='%COMSPEC% /C if exist "%PROGRAMFILES(x86)%\Mozilla Firefox\uninstall\helper.exe" "%PROGRAMFILES(x86)%\Mozilla Firefox\uninstall\helper.exe" -ms' />


Initial extension automatic checking and disabling

When upgrading to a new version, Firefox does an initial check for extensions compatibility and shows a dialog box disabiling all them automatically.

To prevent this, configure mozilla.cfg:

pref("extensions.shownSelectionUI", true);
pref("extensions.autoDisableScopes", 0);

In this way, no extension is disabled.

Firefox 4 Series Extensions

Firefox 4 handles extensions the same as 3.6 with two differences. First, not all extensions need to be extracted first. This depends on the extension, so you'll have to test each one to find out or just extract them all anyways. Second, globally installed extensions (under Program Files rather than the user profile) need a registry key added.


  <variable name="version" value="1.3.7" />
  <variable name="extid" value="{d10d0bf8-f5b5-c8b4-a8b2-2b9879e08c5d}" />

    path="%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%\chrome.manifest" />

  <install cmd='%COMSPEC% /C xcopy /E /Y "%SOFTWARE%\apps\firefox\adblock\%version%" "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%\"' />
  <install cmd='%COMSPEC% /C reg add "HKLM\Software\Mozilla\Firefox\Extensions" /v %extid% /d "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%" /f' />
  <upgrade cmd="taskkill /F /IM Firefox.exe">
    <exit code="0" />
    <exit code="128" />
  <upgrade cmd='%COMSPEC% /C if exist "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%" rmdir /q /s "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%"' />
  <upgrade cmd='%COMSPEC% /C xcopy /E /Y "%SOFTWARE%\apps\firefox\adblock\%version%" "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%\"' />
  <upgrade cmd='%COMSPEC% /C reg add "HKLM\Software\Mozilla\Firefox\Extensions" /v %extid% /d "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%" /f' />
  <remove cmd="taskkill /F /IM Firefox.exe">
    <exit code="0" />
    <exit code="128" />
  <remove cmd='%COMSPEC% /C if exist "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%" rmdir /q /s "%PROGRAMFILES%\Mozilla Firefox\extensions\%extid%"' />
  <remove cmd='%COMSPEC% /C reg delete "HKLM\Software\Mozilla\Firefox\Extensions" /v %extid% /f' />


Make Firefox the Default Browser

Option 1

Use the uninstall helper to set Firefox as the default browser. Add these lines to your package definition after the lines that install or upgrade Firefox.

        <install architecture="x86" cmd='%ComSpec% /c "%PROGRAMFILES%\Mozilla Firefox\uninstall\helper.exe" /SetAsDefaultAppGlobal' >
		<exit code="2" />
	<install architecture="x64" cmd='%ComSpec% /c "%PROGRAMFILES(x86)%\Mozilla Firefox\uninstall\helper.exe" /SetAsDefaultAppGlobal' >
		<exit code="2" />

        <upgrade include="install" />

Option 2

This one will set Firefox as the default browser for all users - it will try to start Firefox in the background, which will set itself as the default browser. After 10 seconds, we kill the Firefox process, as it's no longer needed, and repeat the process again to make sure we really did set the default browser to Firefox (it's needed to do it like this in some circumstances). Note the "taskkill" command exists in Windows XP Pro (and probably Windows Server 2003) but not Windows 2000 or XP Home.

     name="Make Firefox the default browser"
  <install timeout="10" cmd='"%PROGRAMFILES%\Mozilla Firefox\firefox.exe" -silent -nosplash -setDefaultBrowser' >
   <exit code="-1" />
   <exit code="0" />
  <install cmd='ping -n 10>NUL' />
  <install cmd='taskkill /F /IM Firefox.exe' >
   <exit code="0" />
   <exit code="128" />

See also Mozillazine on Default Browser.

Setting and Locking Preferences

Firefox supports the ability to both set and lock user preferences. This feature is useful for forcing all users to use a specific proxy server, setting or forcing a homepage, disabling automatic updates, and so on.

Create a file called policies.js with the following contents:

pref("general.config.obscure_value", 0);
pref("general.config.filename", "mozilla.cfg");

You may choose to use obscured values in mozilla.cfg by changing the obscure_value above to 13 (for byteshift 13), but beware you will need to go through an additional step to convert the plain-text config to an obscured version every time you make a change. Also note that the method used to obscure the config file is easily reversible. For example:

pref("general.config.obscure_value", 13);
pref("general.config.filename", "mozilla.cfg");

Next, create your mozilla.cfg file. Open Firefox and enter about:config in the address bar to see all of the available configuration options. Note that the first line must be a comment, any options configured in the first line will be ignored.

If using an obscured config, this should be saved as mozilla.txt instead and converted to an obscured mozilla.cfg. Normaly you can do a online conversion at: Unfortunately this web site is out of order for now.

If any issues you may alternatively run available here - The perl interpreter is required -


// Don't show the Firefox has been upgraded page
lockPref("browser.startup.homepage_override.mstone", "ignore");

// Don't check for the default browser
lockPref("", false);

// Disable automatic updates
lockPref("app.update.enabled", false);

// Set the homepage
lockPref("browser.startup.homepage", "");
lockPref("", 1);

// Proxy configuration
lockPref("network.proxy.backup.ftp", "your.proxy");
lockPref("network.proxy.backup.ftp_port", 3128);
lockPref("network.proxy.backup.gopher", "your.proxy");
lockPref("network.proxy.backup.gopher_port", 3128);
lockPref("network.proxy.backup.socks", "your.proxy");
lockPref("network.proxy.backup.socks_port", 3128);
lockPref("network.proxy.backup.ssl", "your.proxy");
lockPref("network.proxy.backup.ssl_port", 3128);
lockPref("network.proxy.ftp", "your.proxy");
lockPref("network.proxy.ftp_port", 3128);
lockPref("network.proxy.gopher", "your.proxy");
lockPref("network.proxy.gopher_port", 3128);
lockPref("network.proxy.http", "your.proxy");
lockPref("network.proxy.http_port", 3128);

lockPref("network.proxy.no_proxies_on", "192.168.*,localhost,, glpi, glpi.your.domain");

lockPref("network.proxy.share_proxy_settings", true);
lockPref("network.proxy.socks", "your.proxy");
lockPref("network.proxy.socks_port", 3128);
lockPref("network.proxy.ssl", "your.proxy");
lockPref("network.proxy.ssl_port", 3128);
lockPref("network.proxy.type", 1);

You can find more details on locking preferences here:

Note that you can use pref() instead of lockPref() if you only want to set the default and allow users to change the setting later.

policies.js should be located in %PROGRAMFILES%\Mozilla Firefox\defaults\pref\ and mozilla.cfg should be located in %PROGRAMFILES%\Mozilla Firefox\.

For Firefox 10 (maybe previous version, not tested), to stop the prompt to 'send my usage stats and data to some server somewhere in the world', add to mozilla.cfg

lockPref("toolkit.telemetry.enabled", false);
lockPref("toolkit.telemetry.rejected", true);
lockPref("toolkit.telemetry.prompted", 2);

To set the startup web page for all new and current users when they press the button 'Restore to Default':

- In notepad, create a new file with the contents:


(change the URL to something more personal)

Save the file as

- Add this file to the archive file C:\program files (x86)\Mozilla Firefox\omni.ja by using 7-zip

7z.exe a "C:\program files (x86)\Mozilla Firefox\omni.ja" [path to]

To turn on the bookmark toolbar and display the menu bar, either

1. Copy the following into a file called C:\program files (x86)\Mozilla Firefox\defaults\profile\localstore.rdf (the dir \profile may not exist, if it doesn't, create it).

<?xml version="1.0"?>
<RDF:RDF xmlns:NC=""
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#PersonalToolbar"
                   currentset="personal-bookmarks" />
  <RDF:Description RDF:about="chrome://browser/content/browser.xul">
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#main-window"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#PersonalToolbar"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#navigator-toolbox"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#toolbar-menubar"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#nav-bar"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#TabsToolbar"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#addon-bar"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#sidebar-box"/>
    <NC:persist RDF:resource="chrome://browser/content/browser.xul#sidebar-title"/>
  <RDF:Description RDF:about="chrome://global/content/customizeToolbar.xul#CustomizeToolbarWindow"
                   height="470" />
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#TabsToolbar"
                   currentset="tabbrowser-tabs,new-tab-button,alltabs-button,tabs-closebutton" />
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#sidebar-title"
                   value="" />
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#addon-bar"
                   currentset="addonbar-closebutton,spring,status-bar" />
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#nav-bar"
                   currentset="unified-back-forward-button,reload-button,stop-button,home-button,urlbar-container,search-container,bookmarks-menu-button-container,fullscreenflex,window-controls" />
  <RDF:Description RDF:about="chrome://browser/content/preferences/preferences.xul#BrowserPreferences"
                   lastSelected="paneMain" />
  <RDF:Description RDF:about="chrome://browser/content/preferences/preferences.xul">
    <NC:persist RDF:resource="chrome://browser/content/preferences/preferences.xul#BrowserPreferences"/>
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#navigator-toolbox"
                   tabsontop="false" />
  <RDF:Description RDF:about="chrome://global/content/customizeToolbar.xul">
    <NC:persist RDF:resource="chrome://global/content/customizeToolbar.xul#CustomizeToolbarWindow"/>
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#sidebar-box"
                   src="" />
  <RDF:Description RDF:about="chrome://browser/content/browser.xul#toolbar-menubar"
                   currentset="menubar-items" />


2. To manually create localstore.rdf, create a new firefox profile, customise the toolbars and quit firefox. Copy the file localstore.rdf is the profile just created to C:\program files (x86)\Mozilla Firefox\defaults\profile\localstore.rdf (the dir \profile may not exist, if it doesn't, create it).

Adding the settings to your package definition

Add the following to your package definition in the appropriate places:

   <check type="file" condition="exists" architecture="x86" path="%PROGRAMFILES%\Mozilla Firefox\defaults\pref\policies.js" />
   <check type="file" condition="exists" architecture="x64" path="%PROGRAMFILES(x86)%\Mozilla Firefox\defaults\pref\policies.js" />
   <check type="file" condition="exists" architecture="x86" path="%PROGRAMFILES%\Mozilla Firefox\mozilla.cfg" />
   <check type="file" condition="exists" architecture="x64" path="%PROGRAMFILES(x86)%\Mozilla Firefox\mozilla.cfg" />

   <install architecture="x86" cmd='%COMSPEC% /c copy /y "%SOFTWARE%\firefox\policies.js" "%PROGRAMFILES%\Mozilla Firefox\defaults\pref\"' />
   <install architecture="x64" cmd='%COMSPEC% /c copy /y "%SOFTWARE%\firefox\policies.js" "%PROGRAMFILES(x86)%\Mozilla Firefox\defaults\pref\"' />
   <install architecture="x86" cmd='%COMSPEC% /c copy /y "%SOFTWARE%\firefox\mozilla.cfg" "%PROGRAMFILES%\Mozilla Firefox\"' />
   <install architecture="x64" cmd='%COMSPEC% /c copy /y "%SOFTWARE%\firefox\mozilla.cfg" "%PROGRAMFILES(x86)%\Mozilla Firefox\"' />

Disable Automatic Updates

If Firefox is started by a user without administrative powers, automatic Firefox update will fail - which is harmless, but can confuse some users. To disable Firefox automatic updates, read the section on setting and locking preferences above first, and then add this line to your mozilla.cfg file:

lockPref("app.update.enabled", false);

Disable Profile Migrator

To prevent users being asked if they want to migrate their settings from Internet Explorer during first run create a file called 'override.ini' and add the following lines:


Copy this file to %PROGRAMFILES%\Mozilla Firefox\browser\ or %PROGRAMFILES(x86)%\Mozilla Firefox\browser\ during installation.

Firefox Client Customization Kit

The Firefox Client Customization Kit makes it easy for administrators to customize Firefox with home page settings, proxies, extensions, etc. Also, you can lock preferences so that you users cannot change them. Version 1.2 has introduced support for Firefox 3.x, version 1.2.5 has dropped support for Firefox 2.x and only works for Firefox 3.x and later.

Use Windows Cert-Store

Firefox has for every user a own certificat-store. With this Option enabled, firefox will also use the windows-certificat-store - which can be filled via SSL_CA_Install. This works with Firefox 49 and later:

defaultPref("security.enterprise_roots.enabled", true);

External Links