Skip to content
How we lock down Firefox
JavaScript CSS HTML Makefile
Latest commit d17811d @kaihendry kaihendry Merge pull request #68 from Webconverger/proper_chrome_blocking
Use a chrome blacklist so we're particular about what we allow
Failed to load latest commit information.
components Use a chrome blacklist so we're particular about what we allow
content
modules Add code to disable the reset Firefox button
src Add init function to avoid console error
LICENSE MIT license
Makefile Makefile tweak
README.md Update URLs
chrome.manifest Remove the need to override neterror
install.rdf Update URLs

README.md

Webconverger addon for Firefox

Curated by Mike Kaply @mikekaply

The common idea is to limit the Firefox browser to functions for kiosk style (non-personal) browsing. Limit most Firefox features to convey simplicity, familiarity and principle of least astonishment.

Used in "Enterprise" deployments, schools, libraries, signs, shops and banks!

https://webconverger.org/kiosk/ shows how it is used in the Webconverger Linux distribution.

Security

Found a way to circumvent the extension? Please let us know!

Many thanks to security researcher and "kiosk hacker" Paul Craig for his review.

Mozilla addons listing

https://addons.mozilla.org/en-US/firefox/addon/webconverger/

Testing on Archlinux

Copy preferences to /usr/lib/firefox/browser/defaults/preferences/webc.js.

Webconverger preferences

Basic Proxy authentication

When used together:

  • extensions.webconverger.proxyusername
  • extensions.webconverger.proxypassword

Neon bg.png when network lost

Ensure the symlink is present:

/etc/webc/extensions/neon/content/bg.png -> /home/webc/bg.png

Debug tips

Add to your /usr/lib/firefox/browser/defaults/preferences/webc.js:

pref("browser.dom.window.dump.enabled", true);

Then in your JS, use dump() to print to stderr after running firefox http://example.com upon a terminal.

Telemetry

The annoying Choose What I Share dialog is disabled in https://github.com/Webconverger/webc/blob/master/opt/firefox/browser/defaults/preferences/webconverger.js

Something went wrong with that request. Please try again.