/**************************************************************************** * Securefox * * "Natura non contristatur" * * priority: provide sensible security and privacy * * version: 130 * * url: https://github.com/yokoffing/Betterfox * * credit: Most prefs are reproduced and adapted from the arkenfox project * * credit urL: https://github.com/arkenfox/user.js * ****************************************************************************/ /**************************************************************************** * SECTION: TRACKING PROTECTION * ****************************************************************************/ // PREF: Enhanced Tracking Protection (ETP) // Tracking Content blocking will strip cookies and block all resource requests to domains listed in Disconnect.me. // Firefox deletes all stored site data (incl. cookies, browser storage) if the site is a known tracker and hasn’t // been interacted with in the last 30 days. // [ALLOWLIST] https://disconnect.me/trackerprotection/unblocked // [NOTE] FF86: "Strict" tracking protection enables dFPI. // [1] https://support.mozilla.org/en-US/kb/enhanced-tracking-protection-firefox-desktop // [2] https://www.reddit.com/r/firefox/comments/l7xetb/network_priority_for_firefoxs_enhanced_tracking/gle2mqn/?web2x&context=3 //user_pref("privacy.trackingprotection.enabled", true); // enabled with "Strict" //user_pref("privacy.trackingprotection.pbmode.enabled", true); // DEFAULT //user_pref("browser.contentblocking.customBlockList.preferences.ui.enabled", false); // DEFAULT user_pref("browser.contentblocking.category", "strict"); //user_pref("privacy.trackingprotection.socialtracking.enabled", true); // enabled with "Strict" //user_pref("privacy.socialtracking.block_cookies.enabled", true); // DEFAULT //user_pref("privacy.trackingprotection.cryptomining.enabled", true); // DEFAULT //user_pref("privacy.trackingprotection.fingerprinting.enabled", true); // DEFAULT //user_pref("privacy.trackingprotection.emailtracking.enabled", true); // enabled with "Strict" //user_pref("network.http.referer.disallowCrossSiteRelaxingDefault", true); // DEFAULT //user_pref("network.http.referer.disallowCrossSiteRelaxingDefault.pbmode", true); // DEFAULT //user_pref("network.http.referer.disallowCrossSiteRelaxingDefault.pbmode.top_navigation", true); // DEFAULT //user_pref("network.http.referer.disallowCrossSiteRelaxingDefault.top_navigation", true); // enabled with "Strict" //user_pref("privacy.annotate_channels.strict_list.enabled", true); // enabled with "Strict" //user_pref("privacy.annotate_channels.strict_list.pbmode.enabled", true); // DEFAULT //user_pref("privacy.fingerprintingProtection", true); // [FF114+] [ETP FF119+] enabled with "Strict" //user_pref("privacy.fingerprintingProtection.pbmode", true); // DEFAULT // PREF: query stripping // Currently uses a small list [1] // We set the same query stripping list that Brave and LibreWolf uses [2] // If using uBlock Origin or AdGuard, use filter lists as well [3] // Query parameters stripped [5] // [1] https://www.eyerys.com/articles/news/how-mozilla-firefox-improves-privacy-using-query-parameter-stripping-feature // [2] https://github.com/brave/brave-core/blob/f337a47cf84211807035581a9f609853752a32fb/browser/net/brave_site_hacks_network_delegate_helper.cc // [3] https://github.com/yokoffing/filterlists#url-tracking-parameters // [4] https://bugzilla.mozilla.org/show_bug.cgi?id=1706607 // [5] https://firefox.settings.services.mozilla.com/v1/buckets/main/collections/query-stripping/records //user_pref("privacy.query_stripping.enabled", true); // enabled with "Strict" //user_pref("privacy.query_stripping.enabled.pbmode", true); // enabled with "Strict" //user_pref("privacy.query_stripping.strip_list", ""); // DEFAULT //user_pref("privacy.query_stripping.strip_on_share.enabled", true); // PREF: allow embedded tweets, Instagram and Reddit posts, and TikTok embeds // [TEST - reddit embed] https://www.pcgamer.com/amazing-halo-infinite-bugs-are-already-rolling-in/ // [TEST - instagram embed] https://www.ndtv.com/entertainment/bharti-singh-and-husband-haarsh-limbachiyaa-announce-pregnancy-see-trending-post-2646359 // [TEST - tweet embed] https://www.newsweek.com/cryptic-tweet-britney-spears-shows-elton-john-collab-may-date-back-2015-1728036 // [TEST - tiktok embed] https://www.vulture.com/article/snl-adds-four-new-cast-members-for-season-48.html // [1] https://www.reddit.com/r/firefox/comments/l79nxy/firefox_dev_is_ignoring_social_tracking_preference/gl84ukk // [2] https://www.reddit.com/r/firefox/comments/pvds9m/reddit_embeds_not_loading/ user_pref("urlclassifier.trackingSkipURLs", "*.reddit.com, *.twitter.com, *.twimg.com, *.tiktok.com"); // MANUAL user_pref("urlclassifier.features.socialtracking.skipURLs", "*.instagram.com, *.twitter.com, *.twimg.com"); // MANUAL // PREF: lower the priority of network loads for resources on the tracking protection list [NIGHTLY] // [1] https://github.com/arkenfox/user.js/issues/102#issuecomment-298413904 //user_pref("privacy.trackingprotection.lower_network_priority", true); // PREF: Site Isolation (sandboxing) [FF100+] // [ABOUT] View in about:processes. // Site Isolation (Fission) builds upon a new security architecture that extends current // protection mechanisms by separating web content and loading each site // in its own operating system process. This new security architecture allows // Firefox to completely separate code originating from different sites and, in turn, // defend against malicious sites trying to access sensitive information from other sites you are visiting. // [1] https://hacks.mozilla.org/2021/05/introducing-firefox-new-site-isolation-security-architecture/ // [2] https://hacks.mozilla.org/2022/05/improved-process-isolation-in-firefox-100/ // [3] https://hacks.mozilla.org/2021/12/webassembly-and-back-again-fine-grained-sandboxing-in-firefox-95/ // [4] https://www.reddit.com/r/firefox/comments/r69j52/firefox_content_process_limit_is_gone/ // [5] https://hg.mozilla.org/mozilla-central/file/tip/dom/ipc/ProcessIsolation.cpp#l53 //user_pref("fission.autostart", true); // DEFAULT [DO NOT TOUCH] //user_pref("fission.webContentIsolationStrategy", 1); // DEFAULT // PREF: GPU sandboxing [FF110+] [WINDOWS] // [1] https://www.ghacks.net/2023/01/17/firefox-110-will-launch-with-gpu-sandboxing-on-windows/ // [2] https://techdows.com/2023/02/disable-gpu-sandboxing-firefox.html // 0=disabled, 1=enabled (default) //user_pref("security.sandbox.gpu.level", 1); // DEFAULT WINDOWS // PREF: State Partitioning [Dynamic First-Party Isolation (dFPI), Total Cookie Protection (TCP)] // Firefox manages client-side state (i.e., data stored in the browser) to mitigate the ability of websites to abuse state // for cross-site tracking. This effort aims to achieve that by providing what is effectively a "different", isolated storage // location to every website a user visits. // dFPI is a more web-compatible version of FPI, which double keys all third-party state by the origin of the top-level // context. dFPI isolates user's browsing data for each top-level eTLD+1, but is flexible enough to apply web // compatibility heuristics to address resulting breakage by dynamically modifying a frame's storage principal. // dFPI isolates most sites while applying heuristics to allow sites through the isolation in certain circumstances for usability. // [NOTE] dFPI partitions all of the following caches by the top-level site being visited: HTTP cache, image cache, // favicon cache, HSTS cache, OCSP cache, style sheet cache, font cache, DNS cache, HTTP Authentication cache, // Alt-Svc cache, and TLS certificate cache. // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1549587 // [2] https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Privacy/State_Partitioning // [3] https://blog.mozilla.org/security/2021/02/23/total-cookie-protection/ // [4] https://blog.mozilla.org/en/mozilla/firefox-rolls-out-total-cookie-protection-by-default-to-all-users-worldwide/ // [5] https://hacks.mozilla.org/2021/02/introducing-state-partitioning/ // [6] https://github.com/arkenfox/user.js/issues/1281 // [7] https://hacks.mozilla.org/2022/02/improving-the-storage-access-api-in-firefox/ //user_pref("network.cookie.cookieBehavior", 5); // DEFAULT FF103+ //user_pref("browser.contentblocking.reject-and-isolate-cookies.preferences.ui.enabled", true); // DEFAULT // PREF: Network Partitioning // Networking-related APIs are not intended to be used for websites to store data, but they can be abused for // cross-site tracking. Network APIs and caches are permanently partitioned by the top-level site. // Network Partitioning (isolation) will allow Firefox to associate resources on a per-website basis rather than together // in the same pool. This includes cache, favicons, CSS files, images, and even speculative connections. // [1] https://www.zdnet.com/article/firefox-to-ship-network-partitioning-as-a-new-anti-tracking-defense/ // [2] https://developer.mozilla.org/en-US/docs/Web/Privacy/State_Partitioning#network_partitioning // [3] https://blog.mozilla.org/security/2021/01/26/supercookie-protections/ //user_pref("privacy.partition.network_state", true); // DEFAULT //user_pref("privacy.partition.serviceWorkers", true); // [DEFAULT: true FF105+] //user_pref("privacy.partition.network_state.ocsp_cache", true); // enabled with "Strict" [DEFAULT: true FF123+] //user_pref("privacy.partition.bloburl_per_partition_key", true); // [FF118+] // enable APS (Always Partitioning Storage) [FF104+] //user_pref("privacy.partition.always_partition_third_party_non_cookie_storage", true); // [DEFAULT: true FF109+] //user_pref("privacy.partition.always_partition_third_party_non_cookie_storage.exempt_sessionstorage", false); // [DEFAULT: false FF109+] // PREF: Smartblock // [1] https://support.mozilla.org/en-US/kb/smartblock-enhanced-tracking-protection // [2] https://www.youtube.com/watch?v=VE8SrClOTgw // [3] https://searchfox.org/mozilla-central/source/browser/extensions/webcompat/data/shims.js //user_pref("extensions.webcompat.enable_shims", true); // enabled with "Strict" // PREF: Redirect Tracking Prevention / Cookie Purging // All storage is cleared (more or less) daily from origins that are known trackers and that // haven’t received a top-level user interaction (including scroll) within the last 45 days. // [1] https://www.ghacks.net/2020/08/06/how-to-enable-redirect-tracking-in-firefox/ // [2] https://www.cookiestatus.com/firefox/#other-first-party-storage // [3] https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Privacy/Redirect_tracking_protection // [4] https://www.ghacks.net/2020/03/04/firefox-75-will-purge-site-data-if-associated-with-tracking-cookies/ // [5] https://github.com/arkenfox/user.js/issues/1089 // [6] https://firefox-source-docs.mozilla.org/toolkit/components/antitracking/anti-tracking/cookie-purging/index.html //user_pref("privacy.purge_trackers.enabled", true); // DEFAULT // PREF: Bounce Tracking Protection [FF127+] // A new standardised variant of Cookie Purging that uses heuristics to detect bounce trackers, // rather than relying on tracker lists. // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1895222 // [2] https://groups.google.com/a/mozilla.org/g/dev-platform/c/M6erM0SjPTM //user_pref("privacy.bounceTrackingProtection.enabled", true); //user_pref("privacy.bounceTrackingProtection.enableDryRunMode", false); // false enables tracker data purging // PREF: SameSite Cookies // Currently, the absence of the SameSite attribute implies that cookies will be // attached to any request for a given origin, no matter who initiated that request. // This behavior is equivalent to setting SameSite=None. // So the pref allows the lack of attribution, or SameSite=None, only on HTTPS sites // to prevent CSFRs on plaintext sites. // [1] https://hacks.mozilla.org/2020/08/changes-to-samesite-cookie-behavior/ // [2] https://caniuse.com/?search=samesite // [3] https://github.com/arkenfox/user.js/issues/1640#issuecomment-1464093950 // [4] https://support.mozilla.org/en-US/questions/1364032 // [5] https://blog.mozilla.org/security/2018/04/24/same-site-cookies-in-firefox-60/ // [6] https://web.dev/samesite-cookies-explained/ // [7] https://portswigger.net/web-security/csrf/bypassing-samesite-restrictions // [8] https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies // [TEST] https://samesite-sandbox.glitch.me/ //user_pref("network.cookie.sameSite.laxByDefault", true); user_pref("network.cookie.sameSite.noneRequiresSecure", true); //user_pref("network.cookie.sameSite.schemeful", true); // PREF: Hyperlink Auditing (click tracking) //user_pref("browser.send_pings", false); // DEFAULT // PREF: Beacon API // Allows websites to asynchronously transmit small amounts of data to servers // without impacting page load performance. This allows things like activity tracking // to be done reliably in the background. Other tracking methods like form submissions // and XHR requests already allow similar capabilities but hurt performance. // Disabling the Beacon API wouldn't make the data unavailable - sites could still // collect it synchronously instead. // [NOTE] Disabling this API sometimes causes site breakage. // [TEST] https://vercel.com/ // [1] https://developer.mozilla.org/docs/Web/API/Navigator/sendBeacon // [2] https://github.com/arkenfox/user.js/issues/1586 //user_pref("beacon.enabled", false); // PREF: battery status tracking // [NOTE] Pref remains, but API is depreciated. // [1] https://developer.mozilla.org/en-US/docs/Web/API/Battery_Status_API#browser_compatibility //user_pref("dom.battery.enabled", false); // PREF: remove temp files opened from non-PB windows with an external application // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=302433,1738574 // [2] https://github.com/arkenfox/user.js/issues/1732 user_pref("browser.download.start_downloads_in_tmp_dir", true); // [FF102+] user_pref("browser.helperApps.deleteTempFileOnExit", true); // PREF: disable UITour backend // This way, there is no chance that a remote page can use it. user_pref("browser.uitour.enabled", false); //user_pref("browser.uitour.url", ""); // PREF: disable remote debugging // [1] https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/16222 //user_pref("devtools.debugger.remote-enabled", false); // DEFAULT // PREF: Global Privacy Control (GPC) [FF118+] // A privacy signal that tells the websites that the user // doesn’t want to be tracked and doesn’t want their data to be sold. // Honored by many highly ranked sites [3]. // [SETTING] Privacy & Security > Website Privacy Preferences > Tell websites not to sell or share my data // [TEST] https://global-privacy-control.glitch.me/ // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1830623 // [2] https://globalprivacycontrol.org/press-release/20201007.html // [3] https://github.com/arkenfox/user.js/issues/1542#issuecomment-1279823954 // [4] https://blog.mozilla.org/netpolicy/2021/10/28/implementing-global-privacy-control/ // [5] https://help.duckduckgo.com/duckduckgo-help-pages/privacy/gpc/ // [6] https://brave.com/web-standards-at-brave/4-global-privacy-control/ // [7] https://www.eff.org/gpc-privacy-badger // [8] https://www.eff.org/issues/do-not-track user_pref("privacy.globalprivacycontrol.enabled", true); //user_pref("privacy.globalprivacycontrol.functionality.enabled", true); // [FF120+] //user_pref("privacy.globalprivacycontrol.pbmode.enabled", true); // [FF120+] /**************************************************************************** * SECTION: OSCP & CERTS / HPKP (HTTP Public Key Pinning) * ****************************************************************************/ // Online Certificate Status Protocol (OCSP) // OCSP leaks your IP and domains you visit to the CA when OCSP Stapling is not available on visited host. // OCSP is vulnerable to replay attacks when nonce is not configured on the OCSP responder. // Short-lived certificates are not checked for revocation (security.pki.cert_short_lifetime_in_days, default:10). // Firefox falls back on plain OCSP when must-staple is not configured on the host certificate. // [1] https://scotthelme.co.uk/revocation-is-broken/ // [2] https://blog.mozilla.org/security/2013/07/29/ocsp-stapling-in-firefox/ // [3] https://github.com/arkenfox/user.js/issues/1576#issuecomment-1304590235 // PREF: disable OCSP fetching to confirm current validity of certificates // OCSP (non-stapled) leaks information about the sites you visit to the CA (cert authority). // It's a trade-off between security (checking) and privacy (leaking info to the CA). // Unlike Chrome, Firefox’s default settings also query OCSP responders to confirm the validity // of SSL/TLS certificates. However, because OCSP query failures are so common, Firefox // (like other browsers) implements a “soft-fail” policy. // [NOTE] This pref only controls OCSP fetching and does not affect OCSP stapling // [SETTING] Privacy & Security>Security>Certificates>Query OCSP responder servers... // [1] https://en.wikipedia.org/wiki/Ocsp // [2] https://www.ssl.com/blogs/how-do-browsers-handle-revoked-ssl-tls-certificates/#ftoc-heading-3 // 0=disabled, 1=enabled (default), 2=enabled for EV certificates only user_pref("security.OCSP.enabled", 0); // PREF: set OCSP fetch failures to hard-fail // When a CA cannot be reached to validate a cert, Firefox just continues the connection (=soft-fail) // Setting this pref to true tells Firefox to instead terminate the connection (=hard-fail) // It is pointless to soft-fail when an OCSP fetch fails: you cannot confirm a cert is still valid (it // could have been revoked) and/or you could be under attack (e.g. malicious blocking of OCSP servers) // [WARNING] Expect breakage: // security.OCSP.require will make the connection fail when the OCSP responder is unavailable // security.OCSP.require is known to break browsing on some captive portals // [1] https://blog.mozilla.org/security/2013/07/29/ocsp-stapling-in-firefox/ // [2] https://www.imperialviolet.org/2014/04/19/revchecking.html // [3] https://www.ssl.com/blogs/how-do-browsers-handle-revoked-ssl-tls-certificates/#ftoc-heading-3 //user_pref("security.OCSP.require", true); // PREF: CRLite // CRLite covers valid certs, and it doesn't fall back to OCSP in mode 2 [FF84+]. // CRLite is faster and more private than OCSP [2]. // 0 = disabled // 1 = consult CRLite but only collect telemetry // 2 = consult CRLite and enforce both "Revoked" and "Not Revoked" results // 3 = consult CRLite and enforce "Not Revoked" results, but defer to OCSP for "Revoked" [FF99+, default FF100+] // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1429800,1670985,1753071 // [2] https://blog.mozilla.org/security/tag/crlite/ user_pref("security.remote_settings.crlite_filters.enabled", true); user_pref("security.pki.crlite_mode", 2); // PREF: HTTP Public Key Pinning (HPKP) // HPKP enhances the security of SSL certificates by associating // a host with their expected public key. It prevents attackers // from impersonating the host using fraudulent certificates, // even if they hold a valid certificate from a trusted certification authority. // HPKP ensures that the client maintains a secure connection with // the correct server, thereby reducing the risk of man-in-the-middle (MITM) attacks. // [NOTE] If you rely on an antivirus to protect your web browsing // by inspecting ALL your web traffic, then leave at 1. // [ERROR] MOZILLA_PKIX_ERROR_KEY_PINNING_FAILURE // By default, pinning enforcement is not applied if a user-installed // certificate authority (CA) is present. However, this allows user-installed // CAs to override pins for any site, negating the security benefits of HPKP. // 0=disabled, 1=allow user MiTM (such as your antivirus) (default), 2=strict // [1] https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/16206 // [2] https://bugzilla.mozilla.org/show_bug.cgi?id=1168603 // [3] https://github.com/yokoffing/Betterfox/issues/53#issuecomment-1035554783 //user_pref("security.cert_pinning.enforcement_level", 2); // PREF: do not trust installed third-party root certificates [FF120+] // Disable Enterprise Root Certificates of the operating system. // For users trying to get intranet sites on managed networks, // or who have security software configured to analyze web traffic. // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1848815 //user_pref("security.enterprise_roots.enabled", false); //user_pref("security.certerrors.mitm.auto_enable_enterprise_roots", false); // PREF: disable content analysis by Data Loss Prevention (DLP) agents [FF124+] // DLP agents are background processes on managed computers that // allow enterprises to monitor locally running applications for // data exfiltration events, which they can allow/block based on // customer-defined DLP policies. // [1] https://github.com/chromium/content_analysis_sdk // [2] https://bugzilla.mozilla.org/show_bug.cgi?id=1880314 //user_pref("browser.contentanalysis.enabled", false); // [FF121+] [DEFAULT] //user_pref("browser.contentanalysis.default_result", 0; // [FF127+] [DEFAULT] /**************************************************************************** * SECTION: SSL (Secure Sockets Layer) / TLS (Transport Layer Security) * ****************************************************************************/ // PREF: display warning on the padlock for "broken security" // [NOTE] Warning padlock not indicated for subresources on a secure page! [2] // [1] https://wiki.mozilla.org/Security:Renegotiation // [2] https://bugzilla.mozilla.org/1353705 user_pref("security.ssl.treat_unsafe_negotiation_as_broken", true); // PREF: require safe negotiation // [ERROR] SSL_ERROR_UNSAFE_NEGOTIATION // [WARNING] Breaks ea.com login (Sep 2023). // Blocks connections to servers that don't support RFC 5746 [2] // as they're potentially vulnerable to a MiTM attack [3]. // A server without RFC 5746 can be safe from the attack if it // disables renegotiations but the problem is that the browser can't // know that. Setting this pref to true is the only way for the // browser to ensure there will be no unsafe renegotiations on // the channel between the browser and the server. // [STATS] SSL Labs > Renegotiation Support (May 2024) reports over 99.7% of top sites have secure renegotiation [4]. // [1] https://wiki.mozilla.org/Security:Renegotiation // [2] https://datatracker.ietf.org/doc/html/rfc5746 // [3] https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2009-3555 // [4] https://www.ssllabs.com/ssl-pulse/ //user_pref("security.ssl.require_safe_negotiation", true); // PREF: display advanced information on Insecure Connection warning pages // [TEST] https://expired.badssl.com/ user_pref("browser.xul.error_pages.expert_bad_cert", true); // PREF: disable 0-RTT (round-trip time) to improve TLS 1.3 security [FF51+] // This data is not forward secret, as it is encrypted solely under keys derived using // the offered PSK. There are no guarantees of non-replay between connections. // [1] https://github.com/tlswg/tls13-spec/issues/1001 // [2] https://www.rfc-editor.org/rfc/rfc9001.html#name-replay-attacks-with-0-rtt // [3] https://blog.cloudflare.com/tls-1-3-overview-and-q-and-a/ user_pref("security.tls.enable_0rtt_data", false); /**************************************************************************** * SECTION: FINGERPRINT PROTECTION (FPP) * ****************************************************************************/ // PREF: enable FingerPrint Protection (FPP) [WiP] // [1] https://github.com/arkenfox/user.js/issues/1661 // [2] https://bugzilla.mozilla.org/show_bug.cgi?id=1816064 //user_pref("privacy.resistFingerprinting.randomization.daily_reset.enabled", true); //user_pref("privacy.resistFingerprinting.randomization.daily_reset.private.enabled", true); /**************************************************************************** * SECTION: RESIST FINGERPRINTING (RFP) * ****************************************************************************/ // PREF: enable advanced fingerprinting protection (RFP) // [WARNING] Leave disabled unless you're okay with all the drawbacks // [1] https://librewolf.net/docs/faq/#what-are-the-most-common-downsides-of-rfp-resist-fingerprinting // [2] https://www.reddit.com/r/firefox/comments/wuqpgi/comment/ile3whx/?context=3 //user_pref("privacy.resistFingerprinting", true); // PREF: set new window size rounding max values [FF55+] // [SETUP-CHROME] sizes round down in hundreds: width to 200s and height to 100s, to fit your screen // [1] https://bugzilla.mozilla.org/1330882 //user_pref("privacy.window.maxInnerWidth", 1600); //user_pref("privacy.window.maxInnerHeight", 900); // PREF: disable showing about:blank as soon as possible during startup [FF60+] // [1] https://github.com/arkenfox/user.js/issues/1618 // [2] https://bugzilla.mozilla.org/1448423 //user_pref("browser.startup.blankWindow", false); // PREF: disable ICC color management // Use a color calibrator for best results [WINDOWS] // Also may help improve font rendering on WINDOWS // [SETTING] General>Language and Appearance>Fonts and Colors>Colors>Use system colors // default=false NON-WINDOWS // [1] https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Releases/3.5/ICC_color_correction_in_Firefox //user_pref("browser.display.use_system_colors", false); /**************************************************************************** * SECTION: DISK AVOIDANCE * ****************************************************************************/ // PREF: prevent media cache from writing to disk in Private Browsing // [NOTE] MSE (Media Source Extensions) are already stored in-memory in PB user_pref("browser.privatebrowsing.forceMediaMemoryCache", true); // PREF: minimum interval (in ms) between session save operations // Firefox periodically saves the user's session so it can restore // their most recent tabs and windows if the browser crashes or restarts. // The value sets the minimum time between these session save operations. // Firefox only saves session data when the state has changed since the last save [2]. // Work has been done to mitigate potential performance drawbacks of frequent session saving [3]. // [1] https://kb.mozillazine.org/Browser.sessionstore.interval // [2] https://bugzilla.mozilla.org/show_bug.cgi?id=1304389#c64 // [3] https://bugzilla.mozilla.org/show_bug.cgi?id=1304389#c66 user_pref("browser.sessionstore.interval", 60000); // 1 minute; default=15000 (15s); 900000=15 min; 1800000=30 min // PREF: store extra session data when crashing or restarting to install updates // Dictates whether sites may save extra session data such as form content, // scrollbar positions, and POST data. // 0=everywhere (default), 1=unencrypted sites, 2=nowhere //user_pref("browser.sessionstore.privacy_level", 2); // PREF: disable automatic Firefox start and session restore after reboot [WINDOWS] // [1] https://bugzilla.mozilla.org/603903 //user_pref("toolkit.winRegisterApplicationRestart", false); // PREF: disable favicons in shortcuts [WINDOWS] // Fetches and stores favicons for Windows .URL shortcuts created by drag and drop // [NOTE] .URL shortcut files will be created with a generic icon. // Favicons are stored as .ico files in profile_dir\shortcutCache. //user_pref("browser.shell.shortcutFavicons", false); // PREF: remove temp files opened with an external application // [1] https://bugzilla.mozilla.org/302433 //user_pref("browser.helperApps.deleteTempFileOnExit", true); // DEFAULT [FF108] // PREF: disable page thumbnails capturing // Page thumbnails are only used in chrome/privileged contexts. //user_pref("browser.pagethumbnails.capturing_disabled", true); // [HIDDEN PREF] /****************************************************************************** * SECTION: SANITIZE HISTORY * ******************************************************************************/ // PREF: reset default 'Time range to clear' for "Clear Data" and "Clear History" // Firefox remembers your last choice. This will reset the value when you start Firefox. // 0=everything, 1=last hour, 2=last two hours, 3=last four hours, // 4=today, 5=last five minutes, 6=last twenty-four hours // The values 5 + 6 are not listed in the dropdown, which will display a // blank value if they are used, but they do work as advertised. //user_pref("privacy.sanitize.timeSpan", 0); // PREF: sanitize site data: set manual "Clear Data" items [FF128+] // Firefox remembers your last choices. This will reset them when you start Firefox // [SETTING] Privacy & Security>Browser Privacy>Cookies and Site Data>Clear Data //user_pref("privacy.clearSiteData.cache", true); //user_pref("privacy.clearSiteData.cookiesAndStorage", false); // keep false until it respects "allow" site exceptions //user_pref("privacy.clearSiteData.historyFormDataAndDownloads", true); //user_pref("privacy.clearSiteData.siteSettings", false); // PREF: sanitize history: set manual "Clear History" items, also via Ctrl-Shift-Del | clearHistory migration is FF128+ // Firefox remembers your last choices. This will reset them when you start Firefox. // [NOTE] Regardless of what you set "downloads" to, as soon as the dialog // for "Clear Recent History" is opened, it is synced to the same as "history". // [SETTING] Privacy & Security>History>Custom Settings>Clear History //user_pref("privacy.cpd.cache", true); // [DEFAULT] //user_pref("privacy.clearHistory.cache", true); //user_pref("privacy.cpd.formdata", true); // [DEFAULT] //user_pref("privacy.cpd.history", true); // [DEFAULT] //user_pref("privacy.cpd.downloads", true); // not used; see note above //user_pref("privacy.clearHistory.historyFormDataAndDownloads", true); //user_pref("privacy.cpd.cookies", false); //user_pref("privacy.cpd.sessions", true); // [DEFAULT] //user_pref("privacy.cpd.offlineApps", false); // [DEFAULT] //user_pref("privacy.clearHistory.cookiesAndStorage", false); //user_pref("privacy.cpd.openWindows", false); // Session Restore //user_pref("privacy.cpd.passwords", false); //user_pref("privacy.cpd.siteSettings", false); //user_pref("privacy.clearHistory.siteSettings", false); /****************************************************************************** * SECTION: SHUTDOWN & SANITIZING * ******************************************************************************/ // PREF: set History section to show all options // Settings>Privacy>History>Use custom settings for history // [INFOGRAPHIC] https://bugzilla.mozilla.org/show_bug.cgi?id=1765533#c1 user_pref("privacy.history.custom", true); // PREF: clear browsing data on shutdown, while respecting site exceptions // Set cookies, site data, cache, etc. to clear on shutdown. // [SETTING] Privacy & Security>History>Custom Settings>Clear history when Firefox closes>Settings // [NOTE] "sessions": Active Logins: refers to HTTP Basic Authentication [1], not logins via cookies // [NOTE] "offlineApps": Offline Website Data: localStorage, service worker cache, QuotaManager (IndexedDB, asm-cache) // Clearing "offlineApps" may affect login items after browser restart [2]. // [1] https://en.wikipedia.org/wiki/Basic_access_authentication // [2] https://github.com/arkenfox/user.js/issues/1291 // [3] https://github.com/yokoffing/Betterfox/issues/272 //user_pref("privacy.sanitize.sanitizeOnShutdown", true); // PREF: sanitize on shutdown: no site exceptions | v2 migration [FF128+] // [NOTE] If "history" is true, downloads will also be cleared. //user_pref("privacy.clearOnShutdown.cache", true); // [DEFAULT] //user_pref("privacy.clearOnShutdown_v2.cache", true); // [FF128+] [DEFAULT] //user_pref("privacy.clearOnShutdown.downloads", true); // [DEFAULT] //user_pref("privacy.clearOnShutdown.formdata", true); // [DEFAULT] //user_pref("privacy.clearOnShutdown.history", true); // [DEFAULT] //user_pref("privacy.clearOnShutdown_v2.historyFormDataAndDownloads", true); // [FF128+] [DEFAULT] //user_pref("privacy.clearOnShutdown.siteSettings", false); // [DEFAULT] //user_pref("privacy.clearOnShutdown_v2.siteSettings", false); // [FF128+] [DEFAULT] // PREF: set Session Restore to clear on shutdown [FF34+] // [NOTE] Not needed if Session Restore is not used or it is already cleared with history (2811) // [NOTE] However, if true, this pref prevents resuming from crashes. //user_pref("privacy.clearOnShutdown.openWindows", true); // PREF: sanitize on shutdown: respects allow site exceptions | v2 migration [FF128+] // Set cookies, site data, cache, etc. to clear on shutdown. // [SETTING] Privacy & Security>History>Custom Settings>Clear history when Firefox closes>Settings // [NOTE] "sessions": Active Logins (has no site exceptions): refers to HTTP Basic Authentication [1], not logins via cookies. // [NOTE] "offlineApps": Offline Website Data: localStorage, service worker cache, QuotaManager (IndexedDB, asm-cache). // Clearing "offlineApps" may affect login items after browser restart. // [1] https://en.wikipedia.org/wiki/Basic_access_authentication //user_pref("privacy.clearOnShutdown.cookies", true); // Cookies //user_pref("privacy.clearOnShutdown.offlineApps", true); // Site Data //user_pref("privacy.clearOnShutdown.sessions", true); // Active Logins [DEFAULT] //user_pref("privacy.clearOnShutdown_v2.cookiesAndStorage", true); // Cookies, Site Data, Active Logins [FF128+] // PREF: configure site exceptions // [NOTE] Currently, there is no way to add sites via about:config. // [SETTING] to add site exceptions: Ctrl+I>Permissions>Cookies>Allow (when on the website in question) // [SETTING] To manage site exceptions: Options>Privacy & Security>Cookies & Site Data>Manage Exceptions // [NOTE] Exceptions: A "cookie" permission also controls "offlineApps" (see note below). For cross-domain logins, // add exceptions for both sites e.g. https://www.youtube.com (site) + https://accounts.google.com (single sign on) // [WARNING] Be selective with what cookies you keep, as they also disable partitioning [1] // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1767271 /****************************************************************************** * SECTION: SEARCH / URL BAR * ******************************************************************************/ // PREF: darken certain parts of the URL [FF75+] // Makes the domain name more prominent by graying out other parts of the URL. // Also hidse https:// and www parts from the suggestion URL. // [1] https://udn.realityripple.com/docs/Mozilla/Preferences/Preference_reference/browser.urlbar.trimURLs // [2] https://winaero.com/firefox-75-strips-https-and-www-from-address-bar-results/ //user_pref("browser.urlbar.trimURLs", true); // DEFAULT // PREF: trim HTTPS from the URL bar [FF119+] // Firefox will hide https:// from the address bar, but not subdomains like www. // It saves some space. Betterfox already uses HTTPS-by-Default and insecure sites // get a padlock with a red stripe. Copying the URL still copies the scheme, // so it's not like we need to see https. It's not a privacy issue, so you can add to your overrides. // [TEST] http://www.http2demo.io/ // [1] https://www.ghacks.net/2023/09/19/firefox-119-will-launch-with-an-important-address-bar-change/ user_pref("browser.urlbar.trimHttps", true); user_pref("browser.urlbar.untrimOnUserInteraction.featureGate", true); // PREF: display "Not Secure" text on HTTP sites // Needed with HTTPS-First Policy; not needed with HTTPS-Only Mode. user_pref("security.insecure_connection_text.enabled", true); user_pref("security.insecure_connection_text.pbmode.enabled", true); // PREF: do not show search terms in URL bar [FF110+] // Show search query instead of URL on search results pages. // [SETTING] Search>Search Bar>Use the address bar for search and navigation>Show search terms instead of URL... //user_pref("browser.urlbar.showSearchTerms.enabled", false); //user_pref("browser.urlbar.showSearchTerms.featureGate", false); // DEFAULT // PREF: enable seperate search engine for Private Windows // [SETTINGS] Preferences>Search>Default Search Engine>"Use this search engine in Private Windows" user_pref("browser.search.separatePrivateDefault.ui.enabled", true); // [SETTINGS] "Choose a different default search engine for Private Windows only" //user_pref("browser.search.separatePrivateDefault", true); // DEFAULT // PREF: enable option to add custom search engine // [SETTINGS] Settings -> Search -> Search Shortcuts -> Add // [EXAMPLE] https://search.brave.com/search?q=%s // [EXAMPLE] https://lite.duckduckgo.com/lite/?q=%s // [1] https://reddit.com/r/firefox/comments/xkzswb/adding_firefox_search_engine_manually/ user_pref("browser.urlbar.update2.engineAliasRefresh", true); // HIDDEN // PREF: disable live search suggestions (Google, Bing, etc.) // [WARNING] Search engines keylog every character you type from the URL bar. // Override these if you trust and use a privacy respecting search engine. // [NOTE] Both prefs must be true for live search to work in the location bar. // [SETTING] Search>Provide search suggestions > Show search suggestions in address bar result user_pref("browser.search.suggest.enabled", false); //user_pref("browser.search.suggest.enabled.private", false); // DEFAULT // PREF: disable Show recent searches // [SETTING] Search > Search Suggestions > Show recent searches //user_pref("browser.urlbar.suggest.recentsearches", false); // PREF: disable Firefox Suggest // [1] https://github.com/arkenfox/user.js/issues/1257 user_pref("browser.urlbar.quicksuggest.enabled", false); // controls whether the UI is shown user_pref("browser.urlbar.suggest.quicksuggest.sponsored", false); // [FF92+] user_pref("browser.urlbar.suggest.quicksuggest.nonsponsored", false); // [FF95+] // hide Firefox Suggest label in URL dropdown box user_pref("browser.urlbar.groupLabels.enabled", false); // PREF: disable search and form history // Be aware that autocomplete form data can be read by third parties [1][2]. // Form data can easily be stolen by third parties. // [SETTING] Privacy & Security>History>Custom Settings>Remember search and form history // [1] https://blog.mindedsecurity.com/2011/10/autocompleteagain.html // [2] https://bugzilla.mozilla.org/381681 user_pref("browser.formfill.enable", false); // PREF: URL bar domain guessing // Domain guessing intercepts DNS "hostname not found errors" and resends a // request (e.g. by adding www or .com). This is inconsistent use (e.g. FQDNs), does not work // via Proxy Servers (different error), is a flawed use of DNS (TLDs: why treat .com // as the 411 for DNS errors?), privacy issues (why connect to sites you didn't // intend to), can leak sensitive data (e.g. query strings: e.g. Princeton attack), // and is a security risk (e.g. common typos & malicious sites set up to exploit this). //user_pref("browser.fixup.alternate.enabled", false); // [DEFAULT FF104+] // PREF: disable location bar autofill // https://support.mozilla.org/en-US/kb/address-bar-autocomplete-firefox#w_url-autocomplete //user_pref("browser.urlbar.autoFill", false); // PREF: enforce Punycode for Internationalized Domain Names to eliminate possible spoofing // Firefox has some protections, but it is better to be safe than sorry. // [!] Might be undesirable for non-latin alphabet users since legitimate IDN's are also punycoded. // [EXAMPLE] https://www.techspot.com/news/100555-malvertising-attack-uses-punycode-character-spread-malware-through.html // [TEST] https://www.xn--80ak6aa92e.com/ (www.apple.com) // [1] https://wiki.mozilla.org/IDN_Display_Algorithm // [2] https://en.wikipedia.org/wiki/IDN_homograph_attack // [3] CVE-2017-5383: https://www.mozilla.org/security/advisories/mfsa2017-02/ // [4] https://www.xudongz.com/blog/2017/idn-phishing/ user_pref("network.IDN_show_punycode", true); /****************************************************************************** * SECTION: HTTPS-FIRST POLICY * ******************************************************************************/ // PREF: HTTPS-First Policy // Firefox attempts to make all connections to websites secure, // and falls back to insecure connections only when a website // does not support it. Unlike HTTPS-Only Mode, Firefox // will NOT ask for your permission before connecting to a website // that doesn’t support secure connections. // As of August 2023, Google estimates that 5-10% of traffic // has remained on HTTP, allowing attackers to eavesdrop // on or change that data [6]. // [NOTE] HTTPS-Only Mode needs to be disabled for HTTPS First to work. // [TEST] http://example.com [upgrade] // [TEST] http://httpforever.com/ [no upgrade] // [1] https://blog.mozilla.org/security/2021/08/10/firefox-91-introduces-https-by-default-in-private-browsing/ // [2] https://brave.com/privacy-updates/22-https-by-default/ // [3] https://github.com/brave/adblock-lists/blob/master/brave-lists/https-upgrade-exceptions-list.txt // [4] https://web.dev/why-https-matters/ // [5] https://www.cloudflare.com/learning/ssl/why-use-https/ // [6] https://blog.chromium.org/2023/08/towards-https-by-default.html user_pref("dom.security.https_first", true); // [DEFAULT FF129+] //user_pref("dom.security.https_first_pbm", true); // [DEFAULT FF91+] //user_pref("dom.security.https_first_schemeless", true); // [FF120+] [DEFAULT FF129+] /****************************************************************************** * SECTION: HTTPS-ONLY MODE * ******************************************************************************/ // Firefox displays a warning page if HTTPS is not supported // by a server. Options to use HTTP are then provided. // [NOTE] When "https_only_mode" (all windows) is true, // "https_only_mode_pbm" (private windows only) is ignored. // As of August 2023, Google estimates that 5-10% of traffic // has remained on HTTP, allowing attackers to eavesdrop // on or change that data [5]. // [SETTING] to add site exceptions: Padlock>HTTPS-Only mode>On/Off/Off temporarily // [SETTING] Privacy & Security>HTTPS-Only Mode // [TEST] http://example.com [upgrade] // [TEST] http://httpforever.com/ [no upgrade] // [1] https://bugzilla.mozilla.org/1613063 // [2] https://blog.mozilla.org/security/2020/11/17/firefox-83-introduces-https-only-mode/ // [3] https://web.dev/why-https-matters/ // [4] https://www.cloudflare.com/learning/ssl/why-use-https/ // [5] https://blog.chromium.org/2023/08/towards-https-by-default.html // PREF: enable HTTPS-only Mode //user_pref("dom.security.https_only_mode_pbm", true); // Private Browsing windows only //user_pref("dom.security.https_only_mode", true); // Normal + Private Browsing windows // PREF: offer suggestion for HTTPS site when available // [1] https://x.com/leli_gibts_scho/status/1371463866606059528 //user_pref("dom.security.https_only_mode_error_page_user_suggestions", true); // PREF: HTTP background requests in HTTPS-only Mode // When attempting to upgrade, if the server doesn't respond within 3 seconds[=default time], // Firefox sends HTTP requests in order to check if the server supports HTTPS or not. // This is done to avoid waiting for a timeout which takes 90 seconds. // Firefox only sends top level domain when falling back to http. // [WARNING] Disabling causes long timeouts when no path to HTTPS is present. // [NOTE] Use "Manage Exceptions" for sites known for no HTTPS. // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1642387,1660945 // [2] https://blog.mozilla.org/attack-and-defense/2021/03/10/insights-into-https-only-mode/ //user_pref("dom.security.https_only_mode_send_http_background_request", true); // DEFAULT //user_pref("dom.security.https_only_fire_http_request_background_timer_ms", 3000); // DEFAULT // PREF: disable HTTPS-Only mode for local resources //user_pref("dom.security.https_only_mode.upgrade_local", false); // DEFAULT /****************************************************************************** * SECTION: DNS-over-HTTPS * ******************************************************************************/ // PREF: DNS-over-HTTPS (DoH) implementation // [NOTE] Mode 3 has site exceptions with a nice UI on the error page. // [SETTINGS] Privacy & Security > DNS over HTTPS > Enable secure DNS using: // [NOTE] Mode 3 has site-exceptions with a nice UI on the error page. // [1] https://hacks.mozilla.org/2018/05/a-cartoon-intro-to-dns-over-https/ // [2] https://wiki.mozilla.org/Security/DOH-resolver-policy // [3] https://support.mozilla.org/en-US/kb/dns-over-https#w_protection-levels-explained // 0= Default Protection: Firefox decides when to use secure DNS (default) // 2= Increased Protection: use DoH and fall back to native DNS if necessary // 3= Max Protection: only use DoH; do not fall back to native DNS // 5= Off: disable DoH //user_pref("network.trr.mode", 0); // DEFAULT // PREF: lower max attempts to use DoH // If DNS requests take too long, FF will fallback to your default DNS much quicker. //user_pref("network.trr.max-fails", 5); // default=15 // PREF: display fallback warning page [FF115+] // Show a warning checkbox UI in modes 0 or 2 above. //user_pref("network.trr_ui.show_fallback_warning_option", false); // DEFAULT //user_pref("network.trr.display_fallback_warning", false); // DEFAULT // PREF: DoH resolver // [1] https://github.com/uBlockOrigin/uBlock-issues/issues/1710 //user_pref("network.trr.uri", "https://xxxx/dns-query"); //user_pref("network.trr.custom_uri", "https://xxxx/dns-query"); // PREF: set DoH bootstrap address [FF89+] // Firefox uses the system DNS to initially resolve the IP address of your DoH server. // When set to a valid, working value that matches your "network.trr.uri" Firefox // won't use the system DNS. If the IP doesn't match then DoH won't work //user_pref("network.trr.bootstrapAddr", "10.0.0.1"); // [HIDDEN PREF] // PREF: adjust providers //user_pref("network.trr.resolvers", '[{ "name": "Cloudflare", "url": "https://mozilla.cloudflare-dns.com/dns-query" },{ "name": "SecureDNS", "url": "https://doh.securedns.eu/dns-query" },{ "name": "AppliedPrivacy", "url": "https://doh.appliedprivacy.net/query" },{ "name": "Digitale Gesellschaft (CH)", "url": "https://dns.digitale-gesellschaft.ch/dns-query" }, { "name": "Quad9", "url": "https://dns.quad9.net/dns-query" }]'); // PREF: EDNS Client Subnet (ECS) // [WARNING] In some circumstances, enabling ECS may result // in suboptimal routing between CDN origins and end users [2]. // [NOTE] You will also need to enable this with your // DoH provider most likely. // [1] https://en.wikipedia.org/wiki/EDNS_Client_Subnet // [2] https://www.quad9.net/support/faq/#edns // [3] https://datatracker.ietf.org/doc/html/rfc7871 //user_pref("network.trr.disable-ECS", true); // DEFAULT // PREF: DNS Rebind Protection // false=do not allow RFC 1918 private addresses in TRR responses (default) // true=allow RFC 1918 private addresses in TRR responses // [1] https://docs.controld.com/docs/dns-rebind-option //user_pref("network.trr.allow-rfc1918", false); // DEFAULT // PREF: assorted options //user_pref("network.trr.confirmationNS", "skip"); // skip undesired DOH test connection //user_pref("network.trr.skip-AAAA-when-not-supported", true); // [DEFAULT] If Firefox detects that your system does not have IPv6 connectivity, it will not request IPv6 addresses from the DoH server //user_pref("network.trr.clear-cache-on-pref-change", true); // [DEFAULT] DNS+TRR cache will be cleared when a relevant TRR pref changes //user_pref("network.trr.wait-for-portal", false); // [DEFAULT] set this to true to tell Firefox to wait for the captive portal detection before TRR is used // PREF: DOH exlcusions //user_pref("network.trr.excluded-domains", ""); // DEFAULT; comma-separated list of domain names to be resolved using the native resolver instead of TRR. This pref can be used to make /etc/hosts works with DNS over HTTPS in Firefox. //user_pref("network.trr.builtin-excluded-domains", "localhost,local"); // DEFAULT; comma-separated list of domain names to be resolved using the native resolver instead of TRR // PREF: Oblivious HTTP (OHTTP) (DoOH) // [Oct 2023] Cloudflare are the only ones running an OHTTP server and resolver, // but there needs to be a relay, and it's not the cheapest thing to run. // [1] https://blog.cloudflare.com/stronger-than-a-promise-proving-oblivious-http-privacy-properties/ // [2] https://www.ietf.org/archive/id/draft-thomson-http-oblivious-01.html // [3] https://old.reddit.com/r/dnscrypt/comments/11ukt43/what_is_dns_over_oblivious_http_targetrelay/ji1nl0m/?context=3 //user_pref("network.trr.mode", 2); //user_pref("network.trr.ohttp.config_uri", "https://dooh.cloudflare-dns.com/.well-known/doohconfig"); //user_pref("network.trr.ohttp.uri", "https://dooh.cloudflare-dns.com/dns-query"); //user_pref("network.trr.ohttp.relay_uri", ""); // custom //user_pref("network.trr.use_ohttp", true); // PREF: Encrypted Client Hello (ECH) [FF118] // [NOTE] HTTP is already isolated with network partitioning. // [TEST] https://www.cloudflare.com/ssl/encrypted-sni // [1] https://support.mozilla.org/en-US/kb/understand-encrypted-client-hello // [2] https://blog.mozilla.org/en/products/firefox/encrypted-hello/ // [3] https://support.mozilla.org/en-US/kb/faq-encrypted-client-hello#w_can-i-use-ech-alongside-other-security-tools-like-vpnsre // [4] https://wiki.mozilla.org/Security/Encrypted_Client_Hello#Preferences //user_pref("network.dns.echconfig.enabled", true); // use ECH for TLS Connections //user_pref("network.dns.http3_echconfig.enabled", true); // use ECH for QUIC connections //user_pref("network.dns.echconfig.fallback_to_origin_when_all_failed", false); // fallback to non-ECH without an authenticated downgrade signal /****************************************************************************** * SECTION: PROXY / SOCKS / IPv6 * ******************************************************************************/ // PREF: disable IPv6 // If you are not masking your IP, then this won't make much difference. // And some VPNs now cover IPv6. // [TEST] https://ipleak.org/ // [1] https://www.internetsociety.org/tag/ipv6-security/ (Myths 2,4,5,6) //user_pref("network.dns.disableIPv6", true); // PREF: set the proxy server to do any DNS lookups when using SOCKS // e.g. in Tor, this stops your local DNS server from knowing your Tor destination // as a remote Tor node will handle the DNS request. // [1] https://trac.torproject.org/projects/tor/wiki/doc/TorifyHOWTO/WebBrowsers // [SETTING] Settings>Network Settings>Proxy DNS when using SOCKS v5 //user_pref("network.proxy.socks_remote_dns", true); // PREF: disable using UNC (Uniform Naming Convention) paths [FF61+] // [SETUP-CHROME] Can break extensions for profiles on network shares. // [1] https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/26424 //user_pref("network.file.disable_unc_paths", true); // [HIDDEN PREF] // PREF: disable GIO as a potential proxy bypass vector // Gvfs/GIO has a set of supported protocols like obex, network, // archive, computer, dav, cdda, gphoto2, trash, etc. // From FF87-117, by default only sftp was accepted. // [1] https://bugzilla.mozilla.org/1433507 // [2] https://en.wikipedia.org/wiki/GVfs // [3] https://en.wikipedia.org/wiki/GIO_(software) //user_pref("network.gio.supported-protocols", ""); // [HIDDEN PREF] [DEFAULT FF118+] // PREF: disable check for proxies //user_pref("network.notify.checkForProxies", false); /****************************************************************************** * SECTION: PASSWORDS * ******************************************************************************/ // PREF: disable password manager // [NOTE] This does not clear any passwords already saved. // [SETTING] Privacy & Security>Logins and Passwords>Ask to save logins and passwords for websites //user_pref("signon.rememberSignons", false); //user_pref("signon.rememberSignons.visibilityToggle", true); // DEFAULT //user_pref("signon.schemeUpgrades", true); // DEFAULT //user_pref("signon.showAutoCompleteFooter", true); // DEFAULT //user_pref("signon.autologin.proxy", false); // DEFAULT // PREF: disable auto-filling username & password form fields // Can leak in cross-site forms and be spoofed. // [NOTE] Username and password is still available when you enter the field. // [SETTING] Privacy & Security>Logins and Passwords>Autofill logins and passwords //user_pref("signon.autofillForms", false); //user_pref("signon.autofillForms.autocompleteOff", true); // DEFAULT // PREF: disable formless login capture for Password Manager [FF51+] // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1166947 user_pref("signon.formlessCapture.enabled", false); // PREF: disable capturing credentials in private browsing user_pref("signon.privateBrowsingCapture.enabled", false); // PREF: disable autofilling saved passwords on HTTP pages // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1217152,1319119 //user_pref("signon.autofillForms.http", false); // DEFAULT // PREF: disable Firefox built-in password generator // Create passwords with random characters and numbers. // [NOTE] Doesn't work with Lockwise disabled! // [1] https://wiki.mozilla.org/Toolkit:Password_Manager/Password_Generation //user_pref("signon.generation.enabled", false); // PREF: disable Firefox Lockwise (about:logins) // [NOTE] No usernames or passwords are sent to third-party sites. // [1] https://lockwise.firefox.com/ // [2] https://support.mozilla.org/en-US/kb/firefox-lockwise-managing-account-data // user_pref("signon.management.page.breach-alerts.enabled", false); //user_pref("signon.management.page.breachAlertUrl", ""); //user_pref("browser.contentblocking.report.lockwise.enabled", false); //user_pref("browser.contentblocking.report.lockwise.how_it_works.url", ""); // PREF: disable Firefox Relay // Privacy & Security > Passwords > Suggest Firefox Relay email masks to protect your email address //user_pref("signon.firefoxRelay.feature", ""); // PREF: disable websites autocomplete // Don't let sites dictate use of saved logins and passwords. //user_pref("signon.storeWhenAutocompleteOff", false); // PREF: limit (or disable) HTTP authentication credentials dialogs triggered by sub-resources [FF41+] // Hardens against potential credentials phishing. // 0=don't allow sub-resources to open HTTP authentication credentials dialogs // 1=don't allow cross-origin sub-resources to open HTTP authentication credentials dialogs // 2=allow sub-resources to open HTTP authentication credentials dialogs (default) // [1] https://www.fxsitecompat.com/en-CA/docs/2015/http-auth-dialog-can-no-longer-be-triggered-by-cross-origin-resources/ user_pref("network.auth.subresource-http-auth-allow", 1); // PREF: prevent password truncation when submitting form data // [1] https://www.ghacks.net/2020/05/18/firefox-77-wont-truncate-text-exceeding-max-length-to-address-password-pasting-issues/ user_pref("editor.truncate_user_pastes", false); // PREF: reveal password icon //user_pref("layout.forms.reveal-password-context-menu.enabled", true); // right-click menu option; DEFAULT [FF112] // [DO NOT TOUCH] Icons will double-up if the website implements it natively. //user_pref("layout.forms.reveal-password-button.enabled", true); // always show icon in password fields /**************************************************************************** * SECTION: ADDRESS + CREDIT CARD MANAGER * ****************************************************************************/ // PREF: disable form autofill // [NOTE] stored data is not secure (uses a JSON file) // [1] https://wiki.mozilla.org/Firefox/Features/Form_Autofill // [2] https://www.ghacks.net/2017/05/24/firefoxs-new-form-autofill-is-awesome //user_pref("extensions.formautofill.addresses.enabled", false); //user_pref("extensions.formautofill.creditCards.enabled", false); /****************************************************************************** * SECTION: MIXED CONTENT + CROSS-SITE * ******************************************************************************/ // PREF: block insecure passive content (images) on HTTPS pages // [WARNING] This preference blocks all mixed content, including upgradable. // Firefox still attempts an HTTP connection if it can't find a secure one, // even with HTTPS First Policy. Although rare, this leaves a small risk of // a malicious image being served through a MITM attack. // Disable this pref if using HTTPS-Only Mode. // [NOTE] Enterprise users may need to enable this setting [1]. // [1] https://blog.mozilla.org/security/2024/06/05/firefox-will-upgrade-more-mixed-content-in-version-127/ user_pref("security.mixed_content.block_display_content", true); // PREF: allow PDFs to load javascript // https://www.reddit.com/r/uBlockOrigin/comments/mulc86/firefox_88_now_supports_javascript_in_pdf_files/ user_pref("pdfjs.enableScripting", false); // PREF: disable middle click on new tab button opening URLs or searches using clipboard [FF115+] // Enable if you're using LINUX. //user_pref("browser.tabs.searchclipboardfor.middleclick", false); // DEFAULT WINDOWS macOS // PREF: disable automatic authentication on Microsoft sites [WINDOWS] // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1695693,1719301 //user_pref("network.http.windows-sso.enabled", false); /**************************************************************************** * SECTION: EXTENSIONS * ****************************************************************************/ // PREF: limit allowed extension directories // 1=profile, 2=user, 4=application, 8=system, 16=temporary, 31=all // The pref value represents the sum: e.g. 5 would be profile and application directories. // [WARNING] Breaks usage of files which are installed outside allowed directories. // [1] https://archive.is/DYjAM user_pref("extensions.enabledScopes", 5); // [HIDDEN PREF] //user_pref("extensions.autoDisableScopes", 15); // [DEFAULT: 15] // PREF: skip 3rd party panel when installing recommended addons [FF82+] // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1659530,1681331 //user_pref("extensions.postDownloadThirdPartyPrompt", false); // PREF: disable mozAddonManager Web API [FF57+] // [NOTE] To allow extensions to work on AMO, you also need extensions.webextensions.restrictedDomains. // [1] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1384330,1406795,1415644,1453988 //user_pref("privacy.resistFingerprinting.block_mozAddonManager", true); // PREF: disable webextension restrictions on Mozilla domains [FF60+] // [1] https://www.reddit.com/r/firefox/comments/n1lpaf/make_addons_work_on_mozilla_sites/gwdy235/?context=3 // [2] https://bugzilla.mozilla.org/buglist.cgi?bug_id=1384330,1406795,1415644,1453988 //user_pref("extensions.webextensions.restrictedDomains", ""); // PREF: do not require signing for extensions [ESR/DEV/NIGHTLY ONLY] // [1] https://support.mozilla.org/en-US/kb/add-on-signing-in-firefox#w_what-are-my-options-if-i-want-to-use-an-unsigned-add-on-advanced-users //user_pref("xpinstall.signatures.required", false); // PREF: disable Quarantined Domains [FF115+] // Users may see a notification when running add-ons that are not monitored by Mozilla when they visit certain sites. // The notification informs them that “some extensions are not allowed” and were blocked from running on that site. // There's no details as to which sites are affected. // [1] https://support.mozilla.org/en-US/kb/quarantined-domains // [2] https://www.ghacks.net/2023/07/04/firefox-115-new-esr-base-and-some-add-ons-may-be-blocked-from-running-on-certain-sites/ //user_pref("extensions.quarantinedDomains.enabled", false); /****************************************************************************** * SECTION: HEADERS / REFERERS * ******************************************************************************/ // PREF: default referrer policy (used unless overriden by the site) // 0=no-referrer, 1=same-origin, 2=strict-origin-when-cross-origin (default), // 3=no-referrer-when-downgrade // [1] https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy#examples // [2] https://plausible.io/blog/referrer-policy //user_pref("network.http.referer.defaultPolicy", 2); // DEFAULT //user_pref("network.http.referer.defaultPolicy.pbmode", 2); // DEFAULT // PREF: default Referrer Policy for trackers (used unless overriden by the site) // Applied to third-party trackers when the default // cookie policy is set to reject third-party trackers. // 0=no-referrer, 1=same-origin, 2=strict-origin-when-cross-origin (default), // 3=no-referrer-when-downgrade // [1] https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy#examples //user_pref("network.http.referer.defaultPolicy.trackers", 1); //user_pref("network.http.referer.defaultPolicy.trackers.pbmode", 1); // PREF: HTTP Referrer Header // [NOTE] Only cross-origin referers need control. // See network.http.referer.XOriginPolicy. // This may cause breakage where third party images and videos // may not load, and with authentication on sites such as banks. // 0 = Never send // 1 = Send only when clicking on links and similar elements // 2 = Send on all requests (default) //user_pref("network.http.sendRefererHeader", 2); // DEFAULT // PREF: control when to send a cross-origin referer // Controls whether or not to send a referrer across different sites. // This includes images, links, and embedded social media on pages. // This may cause breakage where third party images and videos // may not load, and with authentication on sites such as banks. // [NOTE] Most navigational "tracking" is harmless (i.e., the same for everyone) // and effectively blocking cross-site referers just breaks a lot of sites. // 0=always send referrer (default) // 1=send across subdomains [from a.example.com to b.example.com] (breaks Instagram embeds, Bing login, MangaPill, and some streaming sites) // 2=full host name must match [from c.example.com to c.example.com] (breaks Vimeo, iCloud, Instagram, Amazon book previews, and more) // [TEST] https://www.jeffersonscher.com/res/jstest.php // [1] https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy#examples // [2] https://web.dev/referrer-best-practices/ //user_pref("network.http.referer.XOriginPolicy", 0); // DEFAULT // PREF: control the amount of cross-origin information to send // Controls how much referrer to send across origins (different domains). // 0=send full URI (default), 1=scheme+host+port+path, 2=scheme+host+port // [1] https://blog.mozilla.org/security/2021/03/22/firefox-87-trims-http-referrers-by-default-to-protect-user-privacy/ // [2] https://web.dev/referrer-best-practices/ // [3] https://www.reddit.com/r/waterfox/comments/16px8yq/comment/k29r6bu/?context=3 user_pref("network.http.referer.XOriginTrimmingPolicy", 2); /****************************************************************************** * SECTION: CONTAINERS * ******************************************************************************/ // PREF: enable Container Tabs and its UI setting [FF50+] // [NOTE] No longer a privacy benefit due to Firefox upgrades (see State Partitioning and Network Partitioning) // Useful if you want to login to the same site under different accounts // You also may want to download Multi-Account Containers for extra options (2) // [SETTING] General>Tabs>Enable Container Tabs // [1] https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers // [2] https://addons.mozilla.org/en-US/firefox/addon/multi-account-containers/ user_pref("privacy.userContext.ui.enabled", true); //user_pref("privacy.userContext.enabled", true); // PREF: set behavior on "+ Tab" button to display container menu on left click [FF74+] // [NOTE] The menu is always shown on long press and right click. // [SETTING] General>Tabs>Enable Container Tabs>Settings>Select a container for each new tab //user_pref("privacy.userContext.newTabContainerOnLeftClick.enabled", true); // PREF: set external links to open in site-specific containers [FF123+] // Depending on your container extension(s) and their settings: // true=Firefox will not choose a container (so your extension can) // false=Firefox will choose the container/no-container (default) // [1] https://bugzilla.mozilla.org/1874599 //user_pref("browser.link.force_default_user_context_id_for_external_opens", true); /****************************************************************************** * SECTION: WEBRTC * ******************************************************************************/ // PREF: disable WebRTC (Web Real-Time Communication) // Firefox desktop uses mDNS hostname obfuscation and the private IP is never exposed until // required in TRUSTED scenarios; i.e. after you grant device (microphone or camera) access. // [TEST] https://browserleaks.com/webrtc // [1] https://groups.google.com/g/discuss-webrtc/c/6stQXi72BEU/m/2FwZd24UAQAJ // [2] https://datatracker.ietf.org/doc/html/draft-ietf-mmusic-mdns-ice-candidates#section-3.1.1 //user_pref("media.peerconnection.enabled", false); // PREF: enable WebRTC Global Mute Toggles [NIGHTLY] //user_pref("privacy.webrtc.globalMuteToggles", true); // PREF: force WebRTC inside the proxy [FF70+] //user_pref("media.peerconnection.ice.proxy_only_if_behind_proxy", true); // PREF: force a single network interface for ICE candidates generation [FF42+] // When using a system-wide proxy, it uses the proxy interface. // [1] https://developer.mozilla.org/en-US/docs/Web/API/RTCIceCandidate // [2] https://wiki.mozilla.org/Media/WebRTC/Privacy // [3] https://github.com/zen-browser/desktop/issues/972 //user_pref("media.peerconnection.ice.default_address_only", true); // PREF: force exclusion of private IPs from ICE candidates [FF51+] // [SETUP-HARDEN] This will protect your private IP even in TRUSTED scenarios after you // grant device access, but often results in breakage on video-conferencing platforms. //user_pref("media.peerconnection.ice.no_host", true); /****************************************************************************** * SECTION: PLUGINS * ******************************************************************************/ // PREF: disable GMP (Gecko Media Plugins) // [1] https://wiki.mozilla.org/GeckoMediaPlugins //user_pref("media.gmp-provider.enabled", false); // PREF: disable widevine CDM (Content Decryption Module) // [NOTE] This is covered by the EME master switch. //user_pref("media.gmp-widevinecdm.enabled", false); // PREF: disable all DRM content (EME: Encryption Media Extension) // EME is a JavaScript API for playing DRMed (not free) video content in HTML. // A DRM component called a Content Decryption Module (CDM) decrypts, // decodes, and displays the video. // e.g. Netflix, Amazon Prime, Hulu, HBO, Disney+, Showtime, Starz, DirectTV // DRM is a propriety and closed source, but disabling is overkill. // [SETTING] General>DRM Content>Play DRM-controlled content // [TEST] https://bitmovin.com/demos/drm // [1] https://www.eff.org/deeplinks/2017/10/drms-dead-canary-how-we-just-lost-web-what-we-learned-it-and-what-we-need-do-next // [2] https://www.reddit.com/r/firefox/comments/10gvplf/comment/j55htc7 //user_pref("media.eme.enabled", false); // Optionally, hide the setting which also disables the DRM prompt: //user_pref("browser.eme.ui.enabled", false); /****************************************************************************** * SECTION: VARIOUS * ******************************************************************************/ // PREF: decode URLs in other languages // [WARNING] Causes unintended consequences when copy+paste links with underscores. // [1] https://bugzilla.mozilla.org/show_bug.cgi?id=1320061 //user_pref("browser.urlbar.decodeURLsOnCopy", false); // DEFAULT // PREF: number of usages of the web console // If this is less than 5, then pasting code into the web console is disabled. //user_pref("devtools.selfxss.count", 5); // PREF: disable asm.js [FF22+] // [WARNING] Disabling this pref may disrupt your browsing experience. // [1] http://asmjs.org/ // [2] https://cve.mitre.org/cgi-bin/cvekey.cgi?keyword=asm.js // [3] https://rh0dev.github.io/blog/2017/the-return-of-the-jit/ //user_pref("javascript.options.asmjs", false); // PREF: disable Ion and baseline JIT to harden against JS exploits // [NOTE] When both Ion and JIT are disabled, and trustedprincipals // is enabled, then Ion can still be used by extensions [4]. // [WARNING] Disabling these prefs will disrupt your browsing experience [6]. // Tor Browser doesn't even ship with these disabled by default. // [1] https://cve.mitre.org/cgi-bin/cvekey.cgi?keyword=firefox+jit // [2] https://microsoftedge.github.io/edgevr/posts/Super-Duper-Secure-Mode/ // [3] https://support.microsoft.com/en-us/microsoft-edge/enhance-your-security-on-the-web-with-microsoft-edge-b8199f13-b21b-4a08-a806-daed31a1929d // [4] https://bugzilla.mozilla.org/show_bug.cgi?id=1599226 // [5] https://wiki.mozilla.org/IonMonkey // [6] https://github.com/arkenfox/user.js/issues/1791#issuecomment-1891273681 //user_pref("javascript.options.ion", false); //user_pref("javascript.options.baselinejit", false); //user_pref("javascript.options.jit_trustedprincipals", true); // [FF75+] [HIDDEN PREF] // PREF: disable WebAssembly [FF52+] // [WARNING] Disabling this pref may disrupt your browsing experience. // Vulnerabilities [1] have increasingly been found, including those known and fixed // in native programs years ago [2]. WASM has powerful low-level access, making // certain attacks (brute-force) and vulnerabilities more possible. // [STATS] ~0.2% of websites, about half of which are for cryptomining / malvertising [2][3] // [1] https://cve.mitre.org/cgi-bin/cvekey.cgi?keyword=wasm // [2] https://spectrum.ieee.org/tech-talk/telecom/security/more-worries-over-the-security-of-web-assembly // [3] https://www.zdnet.com/article/half-of-the-websites-using-webassembly-use-it-for-malicious-purposes //user_pref("javascript.options.wasm", false); /****************************************************************************** * SECTION: SAFE BROWSING (SB) * ******************************************************************************/ // A full url is never sent to Google, only a part-hash of the prefix, // hidden with noise of other real part-hashes. Firefox takes measures such as // stripping out identifying parameters, and since SBv4 (FF57+), doesn't even use cookies. // (Turn on browser.safebrowsing.debug to monitor this activity) // [1] https://feeding.cloud.geek.nz/posts/how-safe-browsing-works-in-firefox/ // [2] https://wiki.mozilla.org/Security/Safe_Browsing // [3] https://support.mozilla.org/kb/how-does-phishing-and-malware-protection-work // [4] https://educatedguesswork.org/posts/safe-browsing-privacy/ // [5] https://www.google.com/chrome/privacy/whitepaper.html#malware // [6] https://security.googleblog.com/2022/08/how-hash-based-safe-browsing-works-in.html // PREF: Safe Browsing // [WARNING] Be sure to have alternate security measures if you disable SB! Adblockers do not count! // [SETTING] Privacy & Security>Security>... Block dangerous and deceptive content // [ALTERNATIVE] Enable local checks only: https://github.com/yokoffing/Betterfox/issues/87 // [1] https://support.mozilla.org/en-US/kb/how-does-phishing-and-malware-protection-work#w_what-information-is-sent-to-mozilla-or-its-partners-when-phishing-and-malware-protection-is-enabled // [2] https://wiki.mozilla.org/Security/Safe_Browsing // [3] https://developers.google.com/safe-browsing/v4 // [4] https://github.com/privacyguides/privacyguides.org/discussions/423#discussioncomment-1752006 // [5] https://github.com/privacyguides/privacyguides.org/discussions/423#discussioncomment-1767546 // [6] https://wiki.mozilla.org/Security/Safe_Browsing // [7] https://ashkansoltani.org/2012/02/25/cookies-from-nowhere (outdated) // [8] https://blog.cryptographyengineering.com/2019/10/13/dear-apple-safe-browsing-might-not-be-that-safe/ (outdated) // [9] https://the8-bit.com/apple-proxies-google-safe-browsing-privacy/ // [10] https://github.com/brave/brave-browser/wiki/Deviations-from-Chromium-(features-we-disable-or-remove)#services-we-proxy-through-brave-servers //user_pref("browser.safebrowsing.malware.enabled", false); // all checks happen locally //user_pref("browser.safebrowsing.phishing.enabled", false); // all checks happen locally //user_pref("browser.safebrowsing.blockedURIs.enabled", false); // all checks happen locally //user_pref("browser.safebrowsing.provider.google4.gethashURL", ""); //user_pref("browser.safebrowsing.provider.google4.updateURL", ""); //user_pref("browser.safebrowsing.provider.google.gethashURL", ""); //user_pref("browser.safebrowsing.provider.google.updateURL", ""); // PREF: disable SB checks for downloads // This is the master switch for the safebrowsing.downloads prefs (both local lookups + remote). // [NOTE] Still enable this for checks to happen locally. // [SETTING] Privacy & Security>Security>... "Block dangerous downloads" //user_pref("browser.safebrowsing.downloads.enabled", false); // all checks happen locally // PREF: disable SB checks for downloads (remote) // To verify the safety of certain executable files, Firefox may submit some information about the // file, including the name, origin, size and a cryptographic hash of the contents, to the Google // Safe Browsing service which helps Firefox determine whether or not the file should be blocked. // [NOTE] If you do not understand the consequences, override this. user_pref("browser.safebrowsing.downloads.remote.enabled", false); //user_pref("browser.safebrowsing.downloads.remote.url", ""); // disable SB checks for unwanted software // [SETTING] Privacy & Security>Security>... "Warn you about unwanted and uncommon software" //user_pref("browser.safebrowsing.downloads.remote.block_potentially_unwanted", false); //user_pref("browser.safebrowsing.downloads.remote.block_uncommon", false); // PREF: allow user to "ignore this warning" on SB warnings // If clicked, it bypasses the block for that session. This is a means for admins to enforce SB. // Report false positives to [2] // [TEST] see https://github.com/arkenfox/user.js/wiki/Appendix-A-Test-Sites#-mozilla // [1] https://bugzilla.mozilla.org/1226490 // [2] https://safebrowsing.google.com/safebrowsing/report_general/ //user_pref("browser.safebrowsing.allowOverride", true); // DEFAULT /****************************************************************************** * SECTION: MOZILLA * ******************************************************************************/ // PREF: prevent accessibility services from accessing your browser [RESTART] // Accessibility Service may negatively impact Firefox browsing performance. // Disable it if you’re not using any type of physical impairment assistive software. // [1] https://support.mozilla.org/kb/accessibility-services // [2] https://www.ghacks.net/2021/08/25/firefox-tip-turn-off-accessibility-services-to-improve-performance/ // [3] https://www.reddit.com/r/firefox/comments/p8g5zd/why_does_disabling_accessibility_services_improve // [4] https://winaero.com/firefox-has-accessibility-service-memory-leak-you-should-disable-it/ // [5] https://www.ghacks.net/2022/12/26/firefoxs-accessibility-performance-is-getting-a-huge-boost/ //user_pref("accessibility.force_disabled", 1); //user_pref("devtools.accessibility.enabled", false); // PREF: disable Firefox Sync // [ALTERNATIVE] Use xBrowserSync [1] // [1] https://addons.mozilla.org/en-US/firefox/addon/xbs // [2] https://github.com/arkenfox/user.js/issues/1175 //user_pref("identity.fxaccounts.enabled", false); //user_pref("identity.fxaccounts.autoconfig.uri", ""); // PREF: disable Firefox View [FF106+] // You can no longer disable Firefox View as of [FF127+]. // To hide the icon from view, see [2]. // [1] https://support.mozilla.org/en-US/kb/how-set-tab-pickup-firefox-view#w_what-is-firefox-view // [2] https://support.mozilla.org/en-US/kb/how-set-tab-pickup-firefox-view#w_how-do-i-remove-firefox-view-from-the-tabs-bar // PREF: disable the Firefox View tour from popping up //user_pref("browser.firefox-view.feature-tour", "{\"screen\":\"\",\"complete\":true}"); // PREF: disable Push Notifications API [FF44+] // [WHY] Website "push" requires subscription, and the API is required for CRLite. // Push is an API that allows websites to send you (subscribed) messages even when the site // isn't loaded, by pushing messages to your userAgentID through Mozilla's Push Server. // You shouldn't need to disable this. // [NOTE] To remove all subscriptions, reset "dom.push.userAgentID" // [1] https://support.mozilla.org/en-US/kb/push-notifications-firefox // [2] https://developer.mozilla.org/en-US/docs/Web/API/Push_API // [3] https://www.reddit.com/r/firefox/comments/fbyzd4/the_most_private_browser_isnot_firefox/ //user_pref("dom.push.enabled", false); //user_pref("dom.push.userAgentID", ""); // PREF: default permission for Web Notifications // To add site exceptions: Page Info>Permissions>Receive Notifications // To manage site exceptions: Options>Privacy & Security>Permissions>Notifications>Settings // 0=always ask (default), 1=allow, 2=block user_pref("permissions.default.desktop-notification", 2); // PREF: default permission for Location Requests // 0=always ask (default), 1=allow, 2=block user_pref("permissions.default.geo", 2); // PREF: use Mozilla geolocation service instead of Google when geolocation is enabled // [NOTE] Mozilla's geolocation service is discontinued 12 June 2024 [1]. // [1] https://github.com/mozilla/ichnaea/issues/2065 //user_pref("geo.provider.network.url", "https://location.services.mozilla.com/v1/geolocate?key=%MOZILLA_API_KEY%"); // PREF: disable using the OS's geolocation service //user_pref("geo.provider.ms-windows-location", false); // [WINDOWS] //user_pref("geo.provider.use_corelocation", false); // [MAC] //user_pref("geo.provider.use_geoclue", false); // [FF102+] [LINUX] // PREF: logging geolocation to the console //user_pref("geo.provider.network.logging.enabled", true); // PREF: disable region updates // [1] https://firefox-source-docs.mozilla.org/toolkit/modules/toolkit_modules/Region.html //user_pref("browser.region.update.enabled", false); //user_pref("browser.region.network.url", ""); // PREF: enforce Firefox blocklist for extensions + no hiding tabs // This includes updates for "revoked certificates". // [1] https://blog.mozilla.org/security/2015/03/03/revoking-intermediate-certificates-introducing-onecrl/ // [2] https://trac.torproject.org/projects/tor/ticket/16931 //user_pref("extensions.blocklist.enabled", true); // DEFAULT // PREF: disable auto-INSTALLING Firefox updates [NON-WINDOWS] // [NOTE] In FF65+ on Windows this SETTING (below) is now stored in a file and the pref was removed. // [SETTING] General>Firefox Updates>Check for updates but let you choose to install them //user_pref("app.update.auto", false); // PREF: disable automatic extension updates //user_pref("extensions.update.enabled", false); // PREF: disable search engine updates (e.g. OpenSearch) // [NOTE] This does not affect Mozilla's built-in or Web Extension search engines. //user_pref("browser.search.update", false); // PREF: remove special permissions for certain mozilla domains [FF35+] // default = resource://app/defaults/permissions //user_pref("permissions.manager.defaultsUrl", ""); // PREF: remove webchannel whitelist user_pref("webchannel.allowObject.urlWhitelist", ""); /****************************************************************************** * SECTION: TELEMETRY * ******************************************************************************/ // PREF: disable new data submission [FF41+] // If disabled, no policy is shown or upload takes place, ever. // [1] https://bugzilla.mozilla.org/1195552 user_pref("datareporting.policy.dataSubmissionEnabled", false); // PREF: disable Health Reports // [SETTING] Privacy & Security>Firefox Data Collection & Use>Allow Firefox to send technical data. user_pref("datareporting.healthreport.uploadEnabled", false); // PREF: disable telemetry // - If "unified" is false then "enabled" controls the telemetry module // - If "unified" is true then "enabled" only controls whether to record extended data // [NOTE] "toolkit.telemetry.enabled" is now LOCKED to reflect prerelease (true) or release builds (false) [2] // [1] https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/telemetry/internals/preferences.html // [2] https://medium.com/georg-fritzsche/data-preference-changes-in-firefox-58-2d5df9c428b5 user_pref("toolkit.telemetry.unified", false); user_pref("toolkit.telemetry.enabled", false); // see [NOTE] user_pref("toolkit.telemetry.server", "data:,"); user_pref("toolkit.telemetry.archive.enabled", false); user_pref("toolkit.telemetry.newProfilePing.enabled", false); user_pref("toolkit.telemetry.shutdownPingSender.enabled", false); user_pref("toolkit.telemetry.updatePing.enabled", false); user_pref("toolkit.telemetry.bhrPing.enabled", false); // [FF57+] Background Hang Reporter user_pref("toolkit.telemetry.firstShutdownPing.enabled", false); //user_pref("toolkit.telemetry.dap_enabled", false); // DEFAULT [FF108] // PREF: disable Telemetry Coverage // [1] https://blog.mozilla.org/data/2018/08/20/effectively-measuring-search-in-firefox/ user_pref("toolkit.telemetry.coverage.opt-out", true); // [HIDDEN PREF] user_pref("toolkit.coverage.opt-out", true); // [FF64+] [HIDDEN PREF] user_pref("toolkit.coverage.endpoint.base", ""); // PREF: disable Firefox Home (Activity Stream) telemetry user_pref("browser.newtabpage.activity-stream.feeds.telemetry", false); user_pref("browser.newtabpage.activity-stream.telemetry", false); /****************************************************************************** * SECTION: EXPERIMENTS * ******************************************************************************/ // PREF: disable Studies // [SETTING] Privacy & Security>Firefox Data Collection & Use>Allow Firefox to install and run studies user_pref("app.shield.optoutstudies.enabled", false); // PREF: disable Normandy/Shield [FF60+] // Shield is an telemetry system (including Heartbeat) that can also push and test "recipes". // [1] https://mozilla.github.io/normandy/ user_pref("app.normandy.enabled", false); user_pref("app.normandy.api_url", ""); /****************************************************************************** * SECTION: CRASH REPORTS * ******************************************************************************/ // PREF: disable crash reports user_pref("breakpad.reportURL", ""); user_pref("browser.tabs.crashReporting.sendReport", false); //user_pref("browser.crashReports.unsubmittedCheck.enabled", false); // DEFAULT // PREF: enforce no submission of backlogged crash reports // [SETTING] Privacy & Security>Firefox Data Collection & Use>Allow Firefox to send backlogged crash reports user_pref("browser.crashReports.unsubmittedCheck.autoSubmit2", false); /****************************************************************************** * SECTION: DETECTION * ******************************************************************************/ // PREF: disable Captive Portal detection // [1] https://www.eff.org/deeplinks/2017/08/how-captive-portals-interfere-wireless-security-and-privacy // [2] https://wiki.mozilla.org/Necko/CaptivePortal user_pref("captivedetect.canonicalURL", ""); user_pref("network.captive-portal-service.enabled", false); // PREF: disable Network Connectivity checks // [WARNING] Do NOT use for mobile devices. May NOT be able to use Firefox on public wifi (hotels, coffee shops, etc). // [1] https://bugzilla.mozilla.org/1460537 user_pref("network.connectivity-service.enabled", false); // PREF: disable Privacy-Preserving Attribution [FF128+] // [NOTE] PPA disabled if main telemetry switches are disabled. // [SETTING] Privacy & Security>Website Advertising Preferences>Allow websites to perform privacy-preserving ad measurement // [1] https://support.mozilla.org/kb/privacy-preserving-attribution // [2] https://searchfox.org/mozilla-central/rev/f3e4b33a6122ce63bf81ae8c30cc5ac37458864b/dom/privateattribution/PrivateAttributionService.sys.mjs#267 //user_pref("dom.private-attribution.submission.enabled", false); //user_pref("toolkit.telemetry.dap_helper", ""); // [OPTIONAL HARDENING] //user_pref("toolkit.telemetry.dap_leader", ""); // [OPTIONAL HARDENING] // PREF: software that continually reports what default browser you are using [WINDOWS] // [WARNING] Breaks "Make Default..." button in Preferences to set Firefox as the default browser [2]. // [1] https://techdows.com/2020/04/what-is-firefox-default-browser-agent-and-how-to-disable-it.html // [2] https://github.com/yokoffing/Betterfox/issues/166 //user_pref("default-browser-agent.enabled", false); // PREF: "report extensions for abuse" //user_pref("extensions.abuseReport.enabled", false); // PREF: SERP Telemetry [FF125+] // [1] https://blog.mozilla.org/en/products/firefox/firefox-search-update/ //user_pref("browser.search.serpEventTelemetryCategorization.enabled", false); // PREF: assorted telemetry // [NOTE] Shouldn't be needed for user.js, but browser forks may want to disable these prefs. //user_pref("doh-rollout.disable-heuristics", true); // ensure DoH doesn't get enabled automatically //user_pref("dom.security.unexpected_system_load_telemetry_enabled", false); //user_pref("messaging-system.rsexperimentloader.enabled", false); //user_pref("network.trr.confirmation_telemetry_enabled", false); //user_pref("security.app_menu.recordEventTelemetry", false); //user_pref("security.certerrors.mitm.priming.enabled", false); //user_pref("security.certerrors.recordEventTelemetry", false); //user_pref("security.protectionspopup.recordEventTelemetry", false); //user_pref("signon.recipes.remoteRecipes.enabled", false); //user_pref("privacy.trackingprotection.emailtracking.data_collection.enabled", false); //user_pref("messaging-system.askForFeedback", true); // DEFAULT [FF120+]