From 83eb065e26177a17865b2be9c5de9097825c9b1c Mon Sep 17 00:00:00 2001 From: Wesley Dawson Date: Wed, 14 Jan 2026 16:28:31 -0800 Subject: [PATCH] chore: move to custom domain --- astro.config.mjs | 3 +-- public/CNAME | 1 + src/content/docs/guides/firefox-channels.md | 2 +- src/content/docs/guides/getting-started.md | 20 +++++++++---------- .../docs/guides/policies-configuration.mdx | 2 +- src/content/docs/index.mdx | 8 ++++---- src/content/docs/reference/index.mdx | 4 ++-- src/content/docs/reference/policies.mdx | 2 +- .../docs/reference/policies/AppAutoUpdate.mdx | 2 +- .../policies/BackgroundAppUpdate.mdx | 2 +- .../docs/reference/policies/Bookmarks.mdx | 2 +- .../docs/reference/policies/Certificates.mdx | 4 ++-- .../docs/reference/policies/Cookies.mdx | 2 +- .../policies/DisableBuiltinPDFViewer.mdx | 2 +- .../DisableMasterPasswordCreation.mdx | 6 +++--- .../policies/DisablePrivateBrowsing.mdx | 2 +- .../docs/reference/policies/Extensions.mdx | 2 +- .../policies/ManualAppUpdateOnly.mdx | 2 +- .../reference/policies/PrimaryPassword.mdx | 2 +- .../PrivateBrowsingModeAvailability.mdx | 2 +- .../docs/reference/policies/SearchEngines.mdx | 8 ++++---- .../reference/policies/TranslateEnabled.mdx | 2 +- .../docs/reference/policies/WindowsSSO.mdx | 2 +- 23 files changed, 42 insertions(+), 42 deletions(-) create mode 100644 public/CNAME diff --git a/astro.config.mjs b/astro.config.mjs index 8d19a40..5ebfa2c 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -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", }); diff --git a/public/CNAME b/public/CNAME new file mode 100644 index 0000000..d1e09be --- /dev/null +++ b/public/CNAME @@ -0,0 +1 @@ +firefox-admin-docs.mozilla.org diff --git a/src/content/docs/guides/firefox-channels.md b/src/content/docs/guides/firefox-channels.md index b2feead..abab208 100644 --- a/src/content/docs/guides/firefox-channels.md +++ b/src/content/docs/guides/firefox-channels.md @@ -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/) diff --git a/src/content/docs/guides/getting-started.md b/src/content/docs/guides/getting-started.md index 1e61a8f..b039767 100644 --- a/src/content/docs/guides/getting-started.md +++ b/src/content/docs/guides/getting-started.md @@ -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 @@ -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) @@ -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 diff --git a/src/content/docs/guides/policies-configuration.mdx b/src/content/docs/guides/policies-configuration.mdx index 9ab693a..dfa8289 100644 --- a/src/content/docs/guides/policies-configuration.mdx +++ b/src/content/docs/guides/policies-configuration.mdx @@ -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 diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 47d09e3..f611447 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -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 --- @@ -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. 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/). 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. diff --git a/src/content/docs/reference/index.mdx b/src/content/docs/reference/index.mdx index 16ebb60..c95977f 100644 --- a/src/content/docs/reference/index.mdx +++ b/src/content/docs/reference/index.mdx @@ -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. - + ## See also -- [Configuring policies](/enterprise-admin-reference/guides/policies-configuration/) guide +- [Configuring policies](/guides/policies-configuration/) guide diff --git a/src/content/docs/reference/policies.mdx b/src/content/docs/reference/policies.mdx index 5d64342..978c0f5 100644 --- a/src/content/docs/reference/policies.mdx +++ b/src/content/docs/reference/policies.mdx @@ -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 diff --git a/src/content/docs/reference/policies/AppAutoUpdate.mdx b/src/content/docs/reference/policies/AppAutoUpdate.mdx index daabe7c..4ef972b 100644 --- a/src/content/docs/reference/policies/AppAutoUpdate.mdx +++ b/src/content/docs/reference/policies/AppAutoUpdate.mdx @@ -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\ diff --git a/src/content/docs/reference/policies/BackgroundAppUpdate.mdx b/src/content/docs/reference/policies/BackgroundAppUpdate.mdx index 8c16386..f86dc7c 100644 --- a/src/content/docs/reference/policies/BackgroundAppUpdate.mdx +++ b/src/content/docs/reference/policies/BackgroundAppUpdate.mdx @@ -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\ diff --git a/src/content/docs/reference/policies/Bookmarks.mdx b/src/content/docs/reference/policies/Bookmarks.mdx index aec290c..2b33a28 100644 --- a/src/content/docs/reference/policies/Bookmarks.mdx +++ b/src/content/docs/reference/policies/Bookmarks.mdx @@ -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. diff --git a/src/content/docs/reference/policies/Certificates.mdx b/src/content/docs/reference/policies/Certificates.mdx index 642c584..75aa005 100644 --- a/src/content/docs/reference/policies/Certificates.mdx +++ b/src/content/docs/reference/policies/Certificates.mdx @@ -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. diff --git a/src/content/docs/reference/policies/Cookies.mdx b/src/content/docs/reference/policies/Cookies.mdx index e826caf..13506a2 100644 --- a/src/content/docs/reference/policies/Cookies.mdx +++ b/src/content/docs/reference/policies/Cookies.mdx @@ -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) diff --git a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx index f652639..36e8e0b 100644 --- a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx +++ b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx @@ -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`\ diff --git a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx index 63ffb7b..fe013a7 100644 --- a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx +++ b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx @@ -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`\ @@ -55,4 +55,4 @@ Value (string): ## See also -- [`PrimaryPassword`](/enterprise-admin-reference/reference/policies/primarypassword) policy +- [`PrimaryPassword`](/reference/policies/primarypassword) policy diff --git a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx index 5c7c4aa..262bd25 100644 --- a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx +++ b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx @@ -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`\ diff --git a/src/content/docs/reference/policies/Extensions.mdx b/src/content/docs/reference/policies/Extensions.mdx index 450400b..ad1b16a 100644 --- a/src/content/docs/reference/policies/Extensions.mdx +++ b/src/content/docs/reference/policies/Extensions.mdx @@ -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. diff --git a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx index f786d8d..2c9db33 100644 --- a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx +++ b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx @@ -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. diff --git a/src/content/docs/reference/policies/PrimaryPassword.mdx b/src/content/docs/reference/policies/PrimaryPassword.mdx index 3706753..c4990b8 100644 --- a/src/content/docs/reference/policies/PrimaryPassword.mdx +++ b/src/content/docs/reference/policies/PrimaryPassword.mdx @@ -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. diff --git a/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx b/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx index 54cfbaf..b284eff 100644 --- a/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx +++ b/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx @@ -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. diff --git a/src/content/docs/reference/policies/SearchEngines.mdx b/src/content/docs/reference/policies/SearchEngines.mdx index 8312666..b08b4a3 100644 --- a/src/content/docs/reference/policies/SearchEngines.mdx +++ b/src/content/docs/reference/policies/SearchEngines.mdx @@ -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. diff --git a/src/content/docs/reference/policies/TranslateEnabled.mdx b/src/content/docs/reference/policies/TranslateEnabled.mdx index 44ccd04..d68df1c 100644 --- a/src/content/docs/reference/policies/TranslateEnabled.mdx +++ b/src/content/docs/reference/policies/TranslateEnabled.mdx @@ -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\ diff --git a/src/content/docs/reference/policies/WindowsSSO.mdx b/src/content/docs/reference/policies/WindowsSSO.mdx index 8d17fd6..926f73f 100644 --- a/src/content/docs/reference/policies/WindowsSSO.mdx +++ b/src/content/docs/reference/policies/WindowsSSO.mdx @@ -44,4 +44,4 @@ Value (string): ## See also -- [Configuring policies](/enterprise-admin-reference/guides/policies-configuration/) guide +- [Configuring policies](/guides/policies-configuration/) guide