Installing Firefox Portable

To install Firefox Portable, just download the portable package at the top of the Firefox Portable page and then double-click it. Select the location you wish to install to and click OK. A FirefoxPortable directory will be created there and all the necessary files installed. That's all there is to it. Using Firefox Portable To start up Firefox Portable, just double-click FirefoxPortable.exe file where you installed Portable Firefox on your portable drive. Then, use it just like you would a local copy of Firefox. There are a couple of things to keep in mind: Stay Safe - When using portable apps, it's always a good idea to practice Safe Portable App-ing. Removing Your Drive - When you're done, exit Firefox and then wait for the activity light on your removable drive to stop flashing. This may take a minute or more on slow drives or computers. Then select the 'Safely remove [device]' option from the icon in the system tray. If you remove the drive while it is writing, you may lose data. Upgrading Firefox Portable To upgrade to a newer version of Firefox Portable, just install a new copy of Firefox Portable right over your old one. All your data will be preserved. You can use the built in updater as well, but some non-personal files or directories may be left behind. This will be addressed in an upcoming release. If you're upgrading from Portable Firefox (older name and directories), make a copy of your existing profile folder within the PortableFirefox\Data\profile directory on your portable drive. Then download the new version of Firefox Portable and copy your profile from the old version into the new version within FirefoxPortable\Data\profile. If you added any plugins or searchplugins, you should copy those directories as well (PortableFirefox\plugins to FirefoxPortable\Data\plugins and PortableFirefox\firefox\searchplugins to FirefoxPortable\App\firefox\searchplugins). Copying Your Local Firefox Settings If you're using a local copy of Firefox, you may wish to just copy your local Firefox settings right into Firefox Portable. Your local Firefox profile is usually installed in C:\Documents and Settings\[user]\Application Data\Mozilla\Firefox\Profiles\default.???\ After running Firefox Portable once to let it setup its data directories, just copy the contents of that folder (except the cache directories) to the FirefoxPortable\Data\profile directory. Then, and this is important, delete the file FirefoxPortableSettings.ini within the FirefoxPortable\Data\settings directory, if there is one. When you start Firefox Portable for the first time, it's recommended that you turn off disk cache, password saving and history if you're using a flash-based portable device. You can set all of these within the Privacy tab of the Firefox Options window. Sometimes, certain profiles will cause the launcher to fail or hang. It's best to give

it a few minutes to see if it's just checking compatibility and adjusting the locations of the extensions before giving up on it. If it fails, it is usually due to an incompatible extension. Using a Second (or Third) Profile with Firefox Portable A second profile can allows you to setup another set of settings (bookmarks, extensions, preferences, etc) for Firefox Portable that you can use independent of your main settings. This is useful for sharing a flash drive with someone, testing extensions and configuration options or separating our work from personal details. To use a second profile, install the Firefox Portable 2nd Profile 1.2 app in the same PortableApps directory that FirefoxPortable is in (so, if Firefox Portable is installed to X:\PortableApps\FirefoxPortable, you'd install this to X:\PortableApps\FirefoxPortable2ndProfile). In the PortableApps.com Menu, it will show up as "Mozilla Firefox, Portable Edition 2nd Profile". You can easily rename it to something more useful by right-clicking and selecting rename. When you run it, it will start Firefox Portable up with your second profile without affecting your main profile. You can even install a 3rd or 4th profile by installing the 2nd Profile app again to another location (like X:\PortableApps\FirefoxPortable3rdProfile) and then renaming it in the PortableApps.com Menu. Installing Plugins (Java, Flash, Shockwave, etc.) With Firefox Portable, plugins work a bit differently than they do in regular Firefox. Here's how to do some of the most common plugins: Java Runtime Environment - To use Java apps with Mozilla Firefox, Portable Edition, just install jPortable alongside. If Firefox Portable is in X:\PortableApps\FirefoxPortable, jPortable should install to X:\PortableApps\CommonFiles\Java. The Firefox Portable launcher will automatically detect and configure the Java plugin for use. Flash Plugin - To install Flash, you can either try our easy to use Flash installer for Firefox Portable, or follow these steps: Flash is available as an extension. Just click the link. You'll probably see a yellow bar across the top of the browser (if not, skip to Step 5), on that bar, click Edit Options In the popup window, click Allow to add PortableApps.com to your whitelist and then click close Now try the link again You'll see a popup asking if you would like to install, click OK after the countdown and follow along the prompts Shockwave Plugin - To install Shockwave, follow these steps: Download the free Shockwave Player from the Macromedia website

Run the installation routine and, instead of letting it install to a local browser, select to choose your browser Browse to X:\FirefoxPortable\App\firefox (where X is your device's driver letter) and continue with the installation You may need to restart Firefox Portable for the changes to take effect Other Plugins - Other plugin directions are coming soon... If the above fails, try the alternate (and more geeky) method: Install the plugin in a local copy of Firefox (on your hard drive) Locate your plugins directory (usually C:\Program Files\Mozilla Firefox\plugins\) Copy the plugin you need from there to your FirefoxPortable\Data\plugins directory (Some Exmaples: For Flash, copy NPSWF32.dll... for Shockwave, copy np32dsw.dll) Notes: It should be noted that Adobe Flash does *not* officially support running in any portable configuration. And, as it is a closed source application, we can neither modify it nor package it into a more portable-friendly installer. It should also be noted that it is illegal to redistribute either flash or shockwave without the full installer. Configuring Helper Apps (PDF reader, document viewers, etc) Firefox Portable supports the ability to set other portable apps as helper apps to handle additional document types even as you move between PCs. So, you can set Sumatra PDF Portable as your PDF viewer, OpenOffice.org Portable as your DOC opener and VLC Media Player Portable as your AVI handler and it will all work as you move to other PCs. The setting to do this in Firefox Portable works just like it does in a regular install of Firefox: Click Tools and then Options from the menu Select the Content tab Within the File Types section, click the Manage button In the list of types, select the one you wish to edit and click the Change Action button (if you don't see the type you want, see the note below) Select the "Open them with this application" radio button and then click Browse Select the portable app you'd like to open this file type with (example: SumatraPortable.exe) Click Ok. Click Close. And click OK to close all the windows.

Now, when you click on a file of that type in Firefox, it will open it in the portable app you selected. The PortabableApps.com Launcher takes care of any needed changes as you move between PCs. Note: If you don't see the file type you'd like in the list of file types, that means Firefox doesn't know about it yet. Just search for a file of that type in Firefox and click on it. It'll either ask you what you'd like to open it with (in which case, just select the portable app you'd like to use) or it will automatically associate it with an application or plugin installed on the local PC. At that point, you can then follow the instructions above to tell Firefox to use a portable app to open that type of file. Mailto Note: Mailto links are not controlled by Firefox's mimetypes setup, so this has no effect on being able to click on an email link and launching Thunderbird. Firefox simply passes mailto links to Windows and has it open the default mail client. Privacy Note: When Firefox hands off a file to another application, it will usually store that file in the local PC's TEMP directory. This file may be left behind if you close Firefox Portable before closing the application launched to view the file and that application locks the file (for example, Microsoft Word locks .doc files while it has them open). Just close the helper app before closing Firefox Portable to ensure any opened files are deleted. (This issue will affect any portable software that passes a document to another via the TEMP directory, not just Firefox Portable and not just applications on the PortableApps.com Platform.) Improving Firefox Portable's Performance Firefox Portable runs quite well from faster flash drives (and portable hard drives or iPods) when connected to a USB 2.0 port. But what if your flash drive is a bit below average speed-wise (and just because it says "USB 2.0" on it, doesn't mean it's fast)? Or what if you're stuck connecting to USB 1.1 ports at work or school? Well, there are a few ways to improve performance. First off, it helps to realize why things are slow. Firefox Portable has to read and write bits of data to and from your portable device while it's running. On most flash drives, every time something is written, all reads stop. When this happens, Firefox Portable can appear to "freeze" or "hesitate" momentarily. Add to this the fact that most flash drives aren't as fast as they promise. They all say "USB 2.0 high speed" on them, but they're actually limited by the speed of the memory chips inside them and the controller chip that handles communication between those chips and a PC. There's about a 40x speed difference between a slow drive and a fast drive when dealing with writing small amounts of data. And, even if a drive can write a 5mb MP3 file quickly, it may be slow with writing lots of tiny files. Here's a list of different things you can do to speed things up: Disable Cache - Cache is disabled by default because on most drives, cache will actually slow Firefox Portable down. If you've copied in a local profile or enabled it, you can disable it within the Options window.

Disable Session Restore / Undo Close Tab - Firefox 2.0 introduced a new feature called session restore. It keeps track of all your open windows and tabs and can restore your session if Firefox should crash. While a handy feature, it does have the unfortunate side effect of writing to disk on every page load, which slows down Firefox Portable. In Firefox 3.0, this feature was enhanced to provide more features but at the cost of more disk writes (which is why Firefox Portable asks on first run if you'd like to disable it). There's no option to disable it in the usual Tools - Options windows, but you can disable it manually. For Firefox 2 or Firefox 3, disable it this way: In Firefox's address bar, type in about:config and then hit enter Right-click on any entry and select New - Boolean For the name, enter browser.sessionstore.enabled and click OK Select false and then click OK In Firefox 3.5 and later, this was changed so that now session restore is disabled this way: In Firefox's address bar, type in about:config and then hit enter Into the Filter text box, enter browser.sessionstore.max_tabs_undo Double click on the value which appears in the list below Enter the value 0 into the popup window and click OK Into the Filter text box, enter browser.sessionstore.max_windows_undo Double click on the value which appears in the list below Enter the value 0 into the popup window and click OK When you restart Firefox, session restore (and undo close tab) will be disabled and you should notice an improvement in browsing speed. Disable Anti-Phishing - Firefox comes bundled with an anti-phishing filter that warns you of fake sites pretending to be things like ebay and bank login pages. As with the ression restore, though, it results in additional writes to the drive. This is especially noticable in the first several minutes of using Firefox Portable as it has to download the anti-phishing database and store it within your profile (a 3mb+ file on Firefox 2 and a 50mb+ file on Firefox 3). You can disable this feature by clicking Tools - Options and then selecting the Security tab. Uncheck the box next to "Tell me if the site I'm visiting is a suspected forgery" and then click OK. The anti-phishing filter is now off. If you'd like to get back the space taken up by the database of forged sites, exit Firefox Portable and then head to the FirefoxPortable\Data\profile directory on your drive. Delete the urlclassifier*.sqlite file.

Disable History - Disabling history will prevent Firefox from writing a small bit of data to your drive for every page you visit. Configuring Proxies As you move between different computers, you may encounter systems on networks that use proxies and don't allow direct access to the internet. You'll need to update Firefox Portable' connection settings to use in the new environment. You can find these settings within Tools - Options - General - Connection Settings. If you routinely use PCs with different proxy settings (for example, work and home or work and school), you can set up the options for both and easily switch between them with the SwitchProxy extension. If you need to determine the connection settings of the PC you are on to add to Firefox Portable, just run our Proxy Get Utility and it will let you know what they are. Running From a CD (Firefox Portable Live) This option is no longer actively tested or supported Firefox Portable supports running from a CD right out of the box, and it's a snap. Start off by downloading and installing Firefox Portable to your hard drive... it doesn't matter where. Run it at least once to generate the default settings. Then, customize it as needed, being sure not to move FirefoxPortable.exe or any of the other critical files. Next, download FirefoxPortable.ini and save it to the same directory as FirefoxPortable.exe. Then, burn the whole FirefoxPortable directory to a CD and you're ready to go. Note that Firefox doesn't actually support running directly from read-only media, so the portable app and the profile are copied to the local PC's temp directory and run from there. If you use Firefox Portable from a USB flash drive with a write-protect switch, you're covered, too. The Firefox Portable Launcher will automatically detect when you protect the drive and offer to run your files locally for you. Additional information about the options in the INI is provided in the readme.txt file within the FirefoxPortable\Other\FirefoxPortableSource directory. Please note that you must follow Mozilla's Trademark Distribution Guidelines if you are distributing your customized version to anyone else. Known Issues The following are known issues with this package: Renaming FirefoxPortable.exe - Once on your portable device, the launcher can be renamed to anything you'd like except for firefox.exe. It tries to detect an existing instance of Firefox so it doesn't just launch a new local one and if it is named firefox.exe, it will detect itself. Themes and Extensions - Most themes and extensions will work with Firefox Portable -- including those that make use of the component registry. A handful will still fail, though. Read/Write Required - Both the Firefox directory and the Profile directory must be writeable on the USB drive. Drives with a writable switch can not be in read-only mode. The launcher will attempt to detect this and switch

to read-only mode allowing you to copy it to your local PC's TEMP directory and run from there. Modifications I made some modifications to the default version of Firefox to make it more USB key friendly (decreasing the number of writes to the drive, which will increase drive life). These changes are listed here so you'll know what they are, and so you can recreate the process, if so desired. Obviously, you can change many of these settings (ex cache) by changing the options in Firefox, but you will increase the number of writes to your flash drive, thus decreasing its life. PortableApps.com Launcher - Firefox Portable Launcher is included. It performs a number of functions including: adjustment of paths to external programs (mime types), adjusting extenion paths, adjustment of paths to local homepages, intelligent recreation of the component registry as you move drives, backup/restore of certain registry keys in certain instances, cleaning of folders and directories in certain instances, adjustment of some extension setting paths making non-portable extensions portable. Default Profile - A default profile exists within the firefox directory with setting to improve portability. No Default Browser Check - Firefox won't check to see if it is the default browser on startup. Download Prompt - Firefox will ask where to save downloads. No Disk Cache - The browser disk cache has been disabled to decrease disk size and the number of writes to the disk, increasing disk life. Update Prompt - As updating the browser on a flash drive can be very slow, Firefox Portable asks you if you'd like to update rather than doing it automatically. PortableApps.com Format - Firefox Portable is packaged in PortableApps.com Format with a PortableApps.com Installer. It allows for easy installation to a portable device, detection of existing installs of the PortableApps.com Platform, in-place upgrades allowing you to install a new version right over your existing one, automatic upgrades with the PortableApps.com Platform and tight integration with the PortableApps.com Menu.