Installation and Uninstallation

It is not necessary to install Pale Moon to use it. It is distributed as an xz-compressed tarball which can be extracted anywhere and then launched by executing the "palemoon" file inside it. If for any reason you prefer to manually "install" Pale Moon, you can use the instructions below.

Manual method

These instructions below will extract Pale Moon to your home folder. You can extract Pale Moon to any other location by substituting you home folder with the path for the directory you want to extarct to. Please note that it is required that you extract to a user writable location in order for the internal updater to work!


  • Uninstall all previous versions of Pale Moon, if any.
  • Download the appropriate archive.
  • Extract the archive.
tar -xvf  -C ~/
  • Create a symbolic link /usr/bin/palemoon that points to ~/palemoon/palemoon:
ln -s ~/palemoon/palemoon /usr/bin/palemoon
  • Create symbolic links for the icons in /usr/share/icons/hicolor:
ln -s ~/palemoon/browser/chrome/icons/default/default16.png /usr/share/icons/hicolor/16x16/apps/palemoon.png
ln -s ~/palemoon/browser/chrome/icons/default/default32.png /usr/share/icons/hicolor/32x32/apps/palemoon.png
ln -s ~/palemoon/browser/chrome/icons/default/default48.png /usr/share/icons/hicolor/48x48/apps/palemoon.png
ln -s ~/palemoon/browser/icons/mozicon128.png /usr/share/icons/hicolor/128x128/apps/palemoon.png
  • If you are using a Debian-based distro, you might want to inform update-alternatives about the presence of Pale Moon (and make it available as x-www-browser and gnome-www-browser). An arbitrary score of 100 has been used here, but you can adjust it according to your needs:
update-alternatives --install /usr/bin/gnome-www-browser gnome-www-browser /usr/bin/palemoon 100
update-alternatives --install /usr/bin/x-www-browser x-www-browser /usr/bin/palemoon 100
  • If you want Pale Moon to use the dictionaries from hunspell, run the following:
rm -r ~/palemoon/dictionaries
ln -s /usr/share/hunspell ~/palemoon/dictionaries
  • Make a menu entry by creating /usr/share/applications/palemoon.desktop in a text editor with the following contents:
[Desktop Entry]
Name=Pale Moon Web Browser
Comment=Browse the World Wide Web
Exec=palemoon %u

After creating the menu entry, you may need to run the following command to get the icon to appear:

gtk-update-icon-cache -f /usr/share/icons/hicolor


Updates are handled automatically by Pale Moon's own internal updater provided that Pale Moon was extracted to your home folder or any other location writable by your user account. If for some reason you want to update manually:

  • Delete the directory ~/palemoon:
rm -rf ~/palemoon
  • Extract the contents of a newer Pale Moon archive to ~/:
tar -xvf  -C ~/

If you want hunspell/hyphen integration, you need to rerun the commands stated in the "Installation" section at this point.


  • Remove the file associations from each user account:
rm /home/*/.local/share/applications/userapp-Pale\ Moon-*.desktop /home/*/.local/share/applications/mimeinfo.cache
  • If you used a Debian-based distro and registered Pale Moon with update-alternatives, then remove it from the list of browsers maintained by it:
update-alternatives --remove gnome-www-browser /usr/bin/palemoon
update-alternatives --remove x-www-browser /usr/bin/palemoon
  • Remove all other Pale Moon related files:
rm -rf /usr/bin/palemoon ~/palemoon /usr/share/applications/palemoon.desktop /usr/share/icons/hicolor/*/apps/palemoon.png

Site design and Branding © 2024 Moonchild Productions - All rights reserved
Any other content, brand names or logos are copyright or trademark to their respective owners.
Policies: Cookies - User Content - Privacy.

The Pale Moon for Linux Site is powered by Project Artemis 1.5.0.