- Developer Guide
Because this is not a mainstream installed build, it has to be installed manually. The installation is simple, and writes to one "palemoon" directory. Given a <destination directory> and a <palemoon tarball>, the steps for each new version are...
rm -rf <destination directory>/palemoon tar -C <destination directory> -xvjf <palemoon tarball>
The first time Pale Moon is installed, you need to create a symlink to the executable. Popular destinations for installation are /opt, /usr/local, and your own home directory. /opt and /usr/local are useful for global installs. They can be run by all user accounts on the system. The global install requires root/sudo permissions, to write to /opt or /usr/local. Installing in your home directory can be done as a regular user. The installed program is only accessable by the local user.
WARNING Be VERY careful with the "rm -rf" command. If you type in "rm /usr/local palemoon" instead of "rm /usr/local/palemoon", you will delete the entire "/usr/local/" directory as well as the local "palemoon" directory, which is not what you want to do.
Some install examples. They all assume
- you've run "./mach build" and "./mach install" successfully
- a "palemoon*.bz2" tarball exists in the "pmbuild/dist" subdirectory
- you're in the parent directory of pmbuild
- the destination directory you wish to install to exists
rm -rf $HOME/pm/palemoon tar -C $HOME/pm -xvjf pmbuild/dist/palemoon*.bz2 # (next step first time only) ln -s $HOME/pm/palemoon/palemoon $HOME/bin/palemoon
rm -rf /usr/local/palemoon tar -C /usr/local -xvjf pmbuild/dist/palemoon*.bz2 # (next step first time only) ln -s /usr/local/palemoon/palemoon /usr/bin/palemoon
rm -rf /opt/palemoon tar -C /opt -xvjf pmbuild/dist/palemoon*.bz2 # (next step first time only) ln -s /opt/palemoon/palemoon /usr/bin/palemoon
It is possible to install and run multiple versions/builds of Pale Moon simultaneously. This is useful for debugging and benchmarking different build options. The only restriction is that multiple instances cannot run against the same user profile simultaneously. In the multiple-version scenario, it is recommended to launch with the command "<path_to_palemoon> -no-remote -p" and select the appropriate profile
Uninstalling consists of
rm -rf <destination directory>/palemoon
If you have a dangling symlink to the deleted version, point it to another version. If you're uninstalling to replace with another (e.g. newer) version in the same directory, the symlink does not need to be touched.