Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,5 @@ export default defineConfig({
title: "Firefox administrator reference",
}),
],
site: "https://mozilla.github.io",
base: "/enterprise-admin-reference/",
site: "https://firefox-admin-docs.mozilla.org",
});
1 change: 1 addition & 0 deletions public/CNAME
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
firefox-admin-docs.mozilla.org
2 changes: 1 addition & 1 deletion src/content/docs/guides/firefox-channels.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,4 @@ This website provides a release calendar that describes upcoming releases for al
## See also

- [Firefox downloads](https://www.firefox.com/en-US/download/all/)
- [Enterprise group policies](/enterprise-admin-reference/reference/policies/)
- [Enterprise group policies](/reference/policies/)
20 changes: 10 additions & 10 deletions src/content/docs/guides/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ There are two recommended release channels for enterprise purposes:

If you prefer faster feature delivery, use the standard **Firefox** release.
If your organization needs stability, **Firefox ESR** is recommended.
See [Firefox and Firefox Extended Support Release (ESR)](/enterprise-admin-reference/guides/firefox-channels/) for more information.
See [Firefox and Firefox Extended Support Release (ESR)](/guides/firefox-channels/) for more information.

## Download Firefox for your platform

Expand Down Expand Up @@ -56,17 +56,17 @@ Enterprise policies do not need to be bundled with the Firefox installer, but ca
- **macOS configuration profiles** - deployed through Jamf or MDM
- **Linux JSON configuration files** - typically placed in `/etc/firefox/policies/policies.json`

For more information, see the [Configuring policies](/enterprise-admin-reference/guides/policies-configuration/) guide.
For more information, see the [Configuring policies](/guides/policies-configuration/) guide.
Common policies include:

- [`DisableAppUpdate`](/enterprise-admin-reference/reference/policies/disableappupdate) - lock Firefox to a known version
- [`Certificates`](/enterprise-admin-reference/reference/policies/certificates) - import or trust custom root CAs
- [`BlockAboutConfig`](/enterprise-admin-reference/reference/policies/blockaboutconfig) - prevent users from modifying advanced preferences
- [`Homepage`](/enterprise-admin-reference/reference/policies/homepage) - set a company homepage
- [`Extensions`](/enterprise-admin-reference/reference/policies/extensions) - force-install approved extensions
- [`Proxy`](/enterprise-admin-reference/reference/policies/proxy) - configure proxy settings or enforce a PAC file
- [`DisableAppUpdate`](/reference/policies/disableappupdate) - lock Firefox to a known version
- [`Certificates`](/reference/policies/certificates) - import or trust custom root CAs
- [`BlockAboutConfig`](/reference/policies/blockaboutconfig) - prevent users from modifying advanced preferences
- [`Homepage`](/reference/policies/homepage) - set a company homepage
- [`Extensions`](/reference/policies/extensions) - force-install approved extensions
- [`Proxy`](/reference/policies/proxy) - configure proxy settings or enforce a PAC file

For a list of available policies, see the [policy reference](/enterprise-admin-reference/reference/policies/).
For a list of available policies, see the [policy reference](/reference/policies/).
Additionally, policy templates are available for Windows, macOS, and Linux in the [github.com/mozilla/policy-templates](https://github.com/mozilla/policy-templates) repository.

### Policy example (Linux/macOS policy JSON)
Expand All @@ -87,5 +87,5 @@ This example `policies.json` file disables automatic Firefox updates and sets a

## See also

- [Enterprise policy reference](/enterprise-admin-reference/reference/policies/)
- [Enterprise policy reference](/reference/policies/)
- [whattrainisitnow.com](https://whattrainisitnow.com/): Firefox release trains and major milestones
2 changes: 1 addition & 1 deletion src/content/docs/guides/policies-configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ For example, `Authentication_Comment` is an internal value used for documentatio

## See also

- [Enterprise policy reference](/enterprise-admin-reference/reference/policies/)
- [Enterprise policy reference](/reference/policies/)
- [Windows Group Policy template](https://github.com/mozilla/policy-templates/tree/master/windows) on github.com/mozilla/policy-templates
- [macOS `org.mozilla.firefox.plist` template](https://github.com/mozilla/policy-templates/tree/master/mac) on github.com/mozilla/policy-templates
- [macOS / Linux `policies.json` template](https://github.com/mozilla/policy-templates/blob/master/linux/policies.json) on github.com/mozilla/policy-templates
Expand Down
8 changes: 4 additions & 4 deletions src/content/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ hero:
file: ../../assets/fx-logo.svg
actions:
- text: Get started
link: /enterprise-admin-reference/guides/getting-started/
link: /guides/getting-started/
icon: right-arrow
lastUpdated: false
---
Expand All @@ -17,18 +17,18 @@ import { Card, CardGrid } from "@astrojs/starlight/components";

## Configuring Firefox as an enterprise browser

Organizations have fine-grained administrative and orchestration control of the browser's behavior by using enterprise policies in [Firefox and Firefox Extended Support Release (ESR)](/enterprise-admin-reference/guides/firefox-channels/).
Organizations have fine-grained administrative and orchestration control of the browser's behavior by using enterprise policies in [Firefox and Firefox Extended Support Release (ESR)](/guides/firefox-channels/).
Firefox can be deployed and managed with common enterprise configuration systems such as Microsoft Intune, JAMF, MDM, and other software-distribution platforms.

<CardGrid>
<Card title="Firefox policy reference">
Policies allow administrators control how managed versions of Firefox behave. See the full list
of available settings in the [Policy
reference](/enterprise-admin-reference/reference/policies/).
reference](/reference/policies/).
</Card>
<Card title="Documentation">
Learn how to apply policies, manage downloads, and use deployment software to configure and
maintain Firefox in your organization. Explore step-by-step instructions in the [Getting
started](/enterprise-admin-reference/guides/getting-started/) guide.
started](/guides/getting-started/) guide.
</Card>
</CardGrid>
4 changes: 2 additions & 2 deletions src/content/docs/reference/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ The following page lists reference documentation relevant for Firefox administra
Policies (also called "enterprise policies" or "group policies") can be used to apply browser configuration to Firefox for enterprise use cases.
The policy reference contains documentation for each policy, its intended function, the settings you can adjust, examples of valid configurations, and any platform limitations that may apply.

<LinkCard title="Firefox policy reference" href="/enterprise-admin-reference/reference/policies/" />
<LinkCard title="Firefox policy reference" href="/reference/policies/" />

## See also

- [Configuring policies](/enterprise-admin-reference/guides/policies-configuration/) guide
- [Configuring policies](/guides/policies-configuration/) guide
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -84,4 +84,4 @@ import CategoryList from "../../../components/CategoryList.astro";

## See also

- [Configuring policies](/enterprise-admin-reference/guides/policies-configuration/) guide
- [Configuring policies](/guides/policies-configuration/) guide
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/AppAutoUpdate.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ If set to `true`, application updates are installed without user approval within

If set to `false`, application updates are downloaded but the user can choose when to install the update.

If you have disabled updates via [`DisableAppUpdate`](/enterprise-admin-reference/reference/policies/disableappupdate), this policy has no effect.
If you have disabled updates via [`DisableAppUpdate`](/reference/policies/disableappupdate), this policy has no effect.

**Compatibility:** Firefox 75, Firefox ESR 68.7\
**CCK2 Equivalent:** N/A\
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ If set to `false`, the application will not try to install updates when the appl
If you are having trouble getting the background task to run, verify your configuration with the ["Requirements to run" section in this support document](https://support.mozilla.org/en-US/kb/enable-background-updates-firefox-windows).

> [!NOTE]
> The `BackgroundAppUpdate` policy has no effect if you have disabled updates via the [`DisableAppUpdate`](/enterprise-admin-reference/reference/policies/disableappupdate) policy or disabled automatic updates via the [`AppAutoUpdate`](/enterprise-admin-reference/reference/policies/appautoupdate) policy.
> The `BackgroundAppUpdate` policy has no effect if you have disabled updates via the [`DisableAppUpdate`](/reference/policies/disableappupdate) policy or disabled automatic updates via the [`AppAutoUpdate`](/reference/policies/appautoupdate) policy.

**Compatibility:** Firefox 90 (Windows only)\
**CCK2 Equivalent:** N/A\
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/Bookmarks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ category: "Bookmarks"
---

> [!WARNING]
> The [`ManagedBookmarks`](/enterprise-admin-reference/reference/policies/managedbookmarks) policy is the recommended way to add bookmarks.
> The [`ManagedBookmarks`](/reference/policies/managedbookmarks) policy is the recommended way to add bookmarks.
> The `Bookmarks` policy will continue to be supported for backwards-compatibility purposes.

Add bookmarks in either the bookmarks toolbar or menu. Only `Title` and `URL` are required. If `Placement` is not specified, the bookmark will be placed on the toolbar. If `Folder` is specified, it is automatically created and bookmarks with the same folder name are grouped together.
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/reference/policies/Certificates.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@ category: "Certificate management"

The following policies allow for configuring certificates in Firefox:

- **[Install](/enterprise-admin-reference/reference/policies/certificates_install/):** Install certificates into the Firefox certificate store
- **[ImportEnterpriseRoots](/enterprise-admin-reference/reference/policies/certificates_importenterpriseroots/):** Trust certificates that have been added to the operating system certificate store by a user or administrator.
- **[Install](/reference/policies/certificates_install/):** Install certificates into the Firefox certificate store
- **[ImportEnterpriseRoots](/reference/policies/certificates_importenterpriseroots/):** Trust certificates that have been added to the operating system certificate store by a user or administrator.
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/Cookies.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Configure cookie preferences.
- `Default`: determines whether cookies are accepted at all. (_Deprecated_. Use `Behavior` instead)
- `AcceptThirdParty` determines how third-party cookies are handled. (_Deprecated_. Use `Behavior` instead)
- `RejectTracker` only rejects cookies for trackers. (_Deprecated_. Use `Behavior` instead)
- `ExpireAtSessionEnd` determines when cookies expire. (_Deprecated_. Use [`SanitizeOnShutdown`](/enterprise-admin-reference/reference/policies/sanitizeonshutdown_selective_) instead)
- `ExpireAtSessionEnd` determines when cookies expire. (_Deprecated_. Use [`SanitizeOnShutdown`](/reference/policies/sanitizeonshutdown_selective_) instead)

## Windows (GPO)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Disable the built in PDF viewer. PDF files are downloaded and sent externally.

> [!NOTE] As of Firefox 140, this policy no longer completely disables PDF.js; it changes the handler to send PDF files to the operating system.
> Embedded PDF files are shown in the browser.
> If you need to completely disable PDF.js, you can use the [`PDFjs`](/enterprise-admin-reference/reference/policies/pdfjs) policy.
> If you need to completely disable PDF.js, you can use the [`PDFjs`](/reference/policies/pdfjs) policy.

**Compatibility:** Firefox 60, Firefox ESR 60\
**CCK2 Equivalent:** `disablePDFjs`\
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ category: "Password manager"

Remove the master password functionality.

If this value is `true`, it works the same as setting [`PrimaryPassword`](/enterprise-admin-reference/reference/policies/primarypassword) to `false` and removes the primary password functionality.
If this value is `true`, it works the same as setting [`PrimaryPassword`](/reference/policies/primarypassword) to `false` and removes the primary password functionality.

If both `DisableMasterPasswordCreation` and [`PrimaryPassword`](/enterprise-admin-reference/reference/policies/primarypassword) are used, `DisableMasterPasswordCreation` takes precedence.
If both `DisableMasterPasswordCreation` and [`PrimaryPassword`](/reference/policies/primarypassword) are used, `DisableMasterPasswordCreation` takes precedence.

**Compatibility:** Firefox 60, Firefox ESR 60\
**CCK2 Equivalent:** `noMasterPassword`\
Expand Down Expand Up @@ -55,4 +55,4 @@ Value (string):

## See also

- [`PrimaryPassword`](/enterprise-admin-reference/reference/policies/primarypassword) policy
- [`PrimaryPassword`](/reference/policies/primarypassword) policy
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ category: "Browsing restrictions"

Remove access to private browsing.

This policy is superseded by the [`PrivateBrowsingModeAvailability`](/enterprise-admin-reference/reference/policies/privatebrowsingmodeavailability) policy.
This policy is superseded by the [`PrivateBrowsingModeAvailability`](/reference/policies/privatebrowsingmodeavailability) policy.

**Compatibility:** Firefox 60, Firefox ESR 60\
**CCK2 Equivalent:** `disablePrivateBrowsing`\
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/Extensions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ category: "Extensions"
Control the installation, uninstallation and locking of extensions.

> [!WARNING]
> The **[`ExtensionSettings`](/enterprise-admin-reference/reference/policies/extensionsettings)** policy was added in Firefox 69.
> The **[`ExtensionSettings`](/reference/policies/extensionsettings)** policy was added in Firefox 69.
> It provides additional functionality to `Extensions` and is closer in compatibility to Chrome and Edge.
> It does not support native paths, so you'll have to use `file://` URLs.
> Before using `Extensions`, it's recommended to use `ExtensionSettings` as all future improvements will be applied to that policy instead.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ If this policy is enabled:

1. The user will never be prompted to install updates
2. Firefox will not check for updates in the background, though it will check automatically when an update UI is displayed (such as the one in the About dialog). This check will be used to show "Update to version X" in the UI, but will not automatically download the update or prompt the user to update in any other way.
3. The update UI will work as expected, unlike when using the [`DisableAppUpdate`](/enterprise-admin-reference/reference/policies/disableappupdate) policy.
3. The update UI will work as expected, unlike when using the [`DisableAppUpdate`](/reference/policies/disableappupdate) policy.

This policy is primarily intended for advanced end users, not for enterprises, but it is available via GPO.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/PrimaryPassword.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ category: "Password manager"
Require or prevent using a primary (formerly master) password.

If this value is true, a primary password is required.
If this value is false, it works the same as if [`DisableMasterPasswordCreation`](/enterprise-admin-reference/reference/policies/disablemasterpasswordcreation) was true and removes the primary password functionality.
If this value is false, it works the same as if [`DisableMasterPasswordCreation`](/reference/policies/disablemasterpasswordcreation) was true and removes the primary password functionality.

If both `DisableMasterPasswordCreation` and `PrimaryPassword` are used, `DisableMasterPasswordCreation` takes precedence.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ category: "Browsing restrictions"

Set availability of private browsing mode.

This policy supersedes [`DisablePrivateBrowsing`](/enterprise-admin-reference/reference/policies/disableprivatebrowsing)
This policy supersedes [`DisablePrivateBrowsing`](/reference/policies/disableprivatebrowsing)

> [!NOTE] This policy missed Firefox ESR 128.2, but it will be in Firefox ESR 128.3.

Expand Down
8 changes: 4 additions & 4 deletions src/content/docs/reference/policies/SearchEngines.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ category: "Search"
The following policies allow for configuring search engines in Firefox.
As of Firefox 139, these policies are available in all Firefox release channels:

- **[Add](/enterprise-admin-reference/reference/policies/searchengines_add/):** Add new search engines.
- **[Default](/enterprise-admin-reference/reference/policies/searchengines_default/):** Set the default search engine.
- **[PreventInstalls](/enterprise-admin-reference/reference/policies/searchengines_preventinstalls/):** Prevent installing search engines from webpages.
- **[Remove](/enterprise-admin-reference/reference/policies/searchengines_remove/):** Hide built-in search engines.
- **[Add](/reference/policies/searchengines_add/):** Add new search engines.
- **[Default](/reference/policies/searchengines_default/):** Set the default search engine.
- **[PreventInstalls](/reference/policies/searchengines_preventinstalls/):** Prevent installing search engines from webpages.
- **[Remove](/reference/policies/searchengines_remove/):** Hide built-in search engines.
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/TranslateEnabled.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Enable or disable webpage translation.

> [!NOTE] Web page translation is performed entirely client-side, so there is no data or privacy risk transmitting content to a translation service over the network.

If you only want to disable the popup, you can set the `browser.translations.automaticallyPopup` preference to `false` using the [Preferences](/enterprise-admin-reference/reference/policies/preferences) policy.
If you only want to disable the popup, you can set the `browser.translations.automaticallyPopup` preference to `false` using the [Preferences](/reference/policies/preferences) policy.

**Compatibility:** Firefox 126\
**CCK2 Equivalent:** N/A\
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/reference/policies/WindowsSSO.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,4 @@ Value (string):

## See also

- [Configuring policies](/enterprise-admin-reference/guides/policies-configuration/) guide
- [Configuring policies](/guides/policies-configuration/) guide