Skip to content

ben-ihelputech/FirefoxConfigInstaller

Repository files navigation

Deploying a Pre-configured Firefox

How to deploy a copy of Firefox with a custom "about:config" This tool lets you set several Firefox preferences in advance by setting a "firefox.cfg" file.

Prerequisites

I recommend uninstalling or quarantining all other installations of Firefox if you are planning to use this guide for a kiosk or as the main browser in an enterprise environment.

Installing

Debian/Ubuntu

Run the installer from the command line:

./debianInstaller.sh

Mac

Run the installer from the command line:

./macInstaller.sh

Things to note:

Homebrew and wget are used in this script. If you are having issues, try to install them beforehand by going to the terminal and running:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" && brew update && brew install wget

The first option the installer will ask is where your ".cfg" file is located. This is your firefox.cfg file where all of the preferences are set. You have two options when installing this:

  1. Provide a web link where the script can download a hosted file. *The script currently uses wget as the main way of downloading files
  2. Provide a path to a local .cfg file on your computer. The easiest way is to drap and drop the file into the terminal and it should interpret the path.

A few demo .cfg files are included for your connivence. Feel free to modify them to your needs!

Error Codes

Error 201

Must specify whether the config files are web-hosted.

Error 202

The install folders where pre-existing and not overwritten. The current version of the script does not support keeping the pre-existing file/folders.

Error 203

Homebrew was not installed. Homebrew is currently necessary for this script.

Error 204

The script was run on an unsupported operating system. Currently, macOS and linux are supported. If you think this is a bug, please contact us with the output of 'uname -s'

Future Plans

  • Update the debian script to have all user input towards the beginning.
  • Add flags for easier use in scripts
  • Make an update script to more easily update
  • Create Windows version.

Suggestions and bug report

Please let me know if you have any feature suggestions or find any bugs. You can reply to my GitHub repository or email me at [email protected] Please make sure to have "Firefox Script" as your subject. Thanks for using the script and I hope it saves you some time!

Acknowledgments

Credit to the following articles:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published