# Installation Instructions for SeaMonkey 1.1.3

To avoid incompatibility problem with previous versions, the SeaMonkey installer will prompt you to delete the install directory if it is not empty. Answer NO if you put your profile or other personal files in the install directory, otherwise the files will be deleted. Users who put profiles in the default location are not affected.

See the profile FAQ for help on backing up your profiles.

This document outlines the system requirements, compatibility information and installation instructions for SeaMonkey 1.1.3.

- Linux
  - Requirements
  - Installation Instructions
    - Using the SeaMonkey Installer
    - Using the .tar.gz archive
    - Multi-User Installation
    - Adding SeaMonkey to the GNOME Panel
    - Installing RPM Binaries
  - Uninstallation
- Macintosh (Mac OS X)
  - Requirements
  - Installation Instructions
  - Uninstallation
- Windows
  - Requirements
  - Installation Instructions
    - Using the SeaMonkey Installer
    - Manually with the .zip file
  - Uninstallation
- Ports (Other Operating Systems)
  - No ports are available at this time.
- Files Created or Used
  - Profile Locations
- Installation of Java, Plug-ins, and Extras

# Linux

## System Requirements

- The following library versions (or compatible) are required for the GTK1 build: glibc 2.2.5, XFree86 3.3.x, GTK 1.2.x, Glib 1.2.x. Red Hat Linux 7.0, Debian 3.0, and SuSE 7.3 (or later) installations should work. The recommended build (GTK2) requires glibc 2.3.2, XFree86 4.3.x, GTK 2.x, glib 2.x, libstdc++-3.3.
- Intel pentium class processor (233 MHz or faster recommended)
- 64 MB of RAM
- 100 MB of free hard disk space (significantly less space is required if you reduce the cache size)

## Installation Instructions

Note: It is recommended that you uninstall previous versions of SeaMonkey before installing SeaMonkey 1.1.3. This will not delete your bookmarks, history, cookies and other information which is stored in your profile directory.

Note: You must run SeaMonkey at least once to complete autoregistration and for the `compreg.dat` file to be written to the installation directory. If a different user (other than the person who installed the product) runs the program first, a core dump will occur. (Bug 49345)

Note: These instructions use the bash shell. If you're not using bash, either use the bash shell or adjust the commands accordingly.

### Installation with the SeaMonkey Installer

To install SeaMonkey by downloading the SeaMonkey installer, follow these steps:

1. Create a directory named seamonkey1.1.3 (`mkdir seamonkey1.1.3`) and change to that directory (`cd seamonkey1.1.3`).
2. Click the link to download the installer file (called `seamonkey-1.1.3.en-US.linux-i686.installer.tar.gz`).
3. Change to the SeaMonkey directory (`cd seamonkey1.1.3`) and decompress the archive with the following command:
   `gunzip -dc sea*.tar.gz | tar -xvf -`
   (This places the installer in a subdirectory of SeaMonkey named `seamonkey-installer`.)
4. Change to the `seamonkey-installer` directory (`cd seamonkey-installer`) and run the installer with the `./seamonkey-installer` command.
5. Follow the instructions in the install wizard for installing SeaMonkey.
6. To start SeaMonkey, change to the directory where you installed it and run the `./seamonkey` command.

### Manual Installation With the tar.gz Archive

To install SeaMonkey by downloading the .tar.gz archive file:

1. Create a directory named "seamonkey1.1.3" (`mkdir seamonkey1.1.3`) and change to that directory (`cd seamonkey1.1.3`).
2. Click the link to download the non-installer seamonkey*.tar.gz file into the `seamonkey1.1.3` directory.
3. Change to the seamonkey directory (`cd seamonkey1.1.3`) and decompress the file with the following command:
   `gunzip -dc sea*.tar.gz | tar -xvf -` (This creates a "seamonkey" subdirectory under your seamonkey1.1.3 directory.)
4. Change to the seamonkey directory (`cd seamonkey`).
5. Run SeaMonkey with the ./seamonkey run script.

### Multi-User Linux Installations

To install SeaMonkey for multiple users on Unix, install as normal, then create the following script in your SeaMonkey directory, make it executable (`chmod u+x <scriptname>`), and run it as a user with write privileges to the mozilla directory (e.g. root). Do not run this program as su[do] root. (Bug 52653)

    #!/bin/sh
    dist_bin=`dirname $0`
    MOZILLA_FIVE_HOME=$dist_bin
    LD_LIBRARY_PATH=$dist_bin
    export MOZILLA_FIVE_HOME LD_LIBRARY_PATH
    $dist_bin/regxpcom
    $dist_bin/regchrome
    touch $dist_bin/chrome/user-skins.rdf $dist_bin/chrome/user-locales.rdf

You should then be able to run that installation of SeaMonkey as any user who has permissions to access it.

### Adding SeaMonkey to the GNOME Panel

1. Click the GNOME Main Menu button, open the Panel menu, and then open the Add to Panel sub-menu and choose Launcher.
2. Right click the icon for SeaMonkey on the Panel and enter the following command:
   `directory_name/seamonkey`
   where directory_name is the name of the directory you downloaded SeaMonkey to.For example, the default directory that SeaMonkey suggests is `/usr/local/seamonkey`.
3. Type in a name for the icon, and type in a comment if you wish.
4. Click the icon button and type in the following as the icon's location:
   `directory_name/icons/mozicon50.xpm`
   where directory_name is the directory where you installed SeaMonkey. For example, the default directory is `/usr/local/seamonkey/icons/mozicon50.xpm`.

### Installing RPM Builds

This may not apply to SeaMonkey yet.

The Red Hat RPM builds are created to work with the default Red Hat 7.x and Red Hat 8.x installations. Using these RPMs on SuSE requires installation of the gdk-pixbuf package. (Bug 85218)

## Uninstallation

- Remove the `seamonkey1.1.3` directory where you installed SeaMonkey
- Remove the `~/.mozilla` directory, which contains profile information

# Macintosh

## System Requirements

- Mac OS X 10.2 or later
- PowerPC processor (266 MHz or faster recommended)
- 64 MB RAM (256 MB recommended)
- 100 MB of free hard disk space (significantly less space is required if you reduce the cache size)

## Installation Instructions (Mac OS X)

To install SeaMonkey by downloading the SeaMonkey disk image, follow these steps:

1. Click the `seamonkey-1.1.3.en-US.mac.dmg` link to download it to your machine. By default, the file is downloaded to your desktop.
2. Double-click on the .dmg file, and drag the SeaMonkey icon onto your hard disk.
3. We recommend that you copy it to the Applications folder.
4. Now eject the disk image.
5. If you like, you can drag SeaMonkey to your dock to have it easily accessible at all times.

## Uninstallation Instructions

1. Remove the application files in `/Users/<yourusername>/Library/Mozilla` (but leave the `Profiles` sub-folder).
2. Remove the file "`Mozilla Registry`" from `/Users/yourusername/Library/Preferences`.
3. Remove `SeaMonkey` from the installed location. (i.e. `/Applications`).

# Windows

## System Requirements

- Windows 95*, 98, 98SE, Windows Me, Windows NT 3.51, Windows NT 4.0, Windows 2000, Windows XP or Windows 2003
  *with DCOM for Windows 95
- Intel pentium class processor (233 MHz or faster recommended)
- 64 MB RAM
- 100 MB of free hard disk space (significantly less space is required if you reduce the cache size)

Certain ATI video drivers are not compatible with SeaMonkey and may lead to crashes. If you are experiencing crashes try upgrading to the latest ATI driver. (Bug 101055)

## Installation Instructions

Note: It is strongly recommended that you exit all programs before running the setup program. Also, you should temporarily disable virus detection software.

### Installation with the SeaMonkey Installer

To install SeaMonkey by downloading the SeaMonkey installer, follow these steps:

1. Click the `seamonkey-1.1.3.en-US.win32.installer.exe` link to download the file to your machine.
2. Navigate to where you downloaded the file and double click the SeaMonkey program icon on your machine to begin the Setup program.
3. Follow the on-screen instructions in the setup program. The program starts automatically the first time.

### Manual Installation With the .zip File

To install SeaMonkey by downloading the .zip file and installing manually, follow these steps:

1. Click the `seamonkey-1.1.3.en-US.win32.zip` link to download the .zip file to your machine.
2. Navigate to where you downloaded the file and double click the compressed file. Note: This step assumes you already have a recent version of WinZip installed, and that you know how to use it. If not, you can get WinZip and information about the program at www.winzip.com.
3. Extract the .zip file to a directory such as `C:\Program Files\SeaMonkey1.1.3` .
4. To start SeaMonkey, navigate to the directory you extracted SeaMonkey to and double click the SeaMonkey.exe icon.

### Uninstallation Instructions

- If the SeaMonkey installer was used, simply go to Settings/Control Panel/Add Remove Programs and choose SeaMonkey 1.1.3.
- If the zip build was used then simply remove the SeaMonkey1.1.3 directory where you installed SeaMonkey and remove the profile directory

# Files Created or Used

SeaMonkey stores data associated with you in a place called a profile. Profiles contain your preferences, mail folders, history, cookies, address books and other important data. Here is a list of these files.

| Directories
`Cache` | Cache files (temporary internet files). Enter `about:cache` in the URL bar for more information.
`chrome` | User defined styles and installed themes and applications
`ImapMail` | IMAP mail
`Mail` | Local Folders and POP3 mail
`News` | Usenet Newsgroups
| Files
`somenumber.s` | Password data
`somenumber.w` | Fill Form data
`.autoreg` | XPCOM Auto Registration clue. Tells SeaMonkey to check for newly installed components the next time it launches.
`appreg` `registry.dat` `registry` | Application Registry. Files where SeaMonkey keeps track of your profiles.
`abook.mab` | Personal addressbook
`bookmarks.html` | Bookmarks
`cert7.db` | Client Certificate database
`compreg.dat` | SeaMonkey XPCOM registry. Files where SeaMonkey keeps track of its components.
`cookies.txt` | Cookies
`hostperm.1` | Cookie, Image and Popup permissions. Information stored in cookperm.txt in earlier versions.
`history.dat` | URL history
`history.mab` | Collected Address book
`key3.db` | Key database
`localstore.rdf` | Defines default windows settings. Saved persistent values. Info about toolbars, sizes, positions, etc
`downloads.rdf` | Download history
`training.dat` | Junk Mail filter training data
`mimeTypes.rdf` | Defines recognized file mime types for the Helper App
`panacea.dat` | Mail folder cache. Summary of certain fields in all the mail/news databases, mostly used to display the folder pane
`panels.rdf` | Information about which panels that will be displayed in the sidebar
`prefs.js` | All your settings. Enter `about:config` in the URL bar for more information.
`pluginreg.dat` | All your registered plugins. Enter `about:plugins` in the URL bar for more information.
`search.rdf` | Information about your search plugins in the sidebar
`secmod.db` | Security module database
`URL.tbl` | Excluded Fill Form data sites
`user.js` | User settings which will be written into prefs.js after SeaMonkey is started
`xpti.dat` | XPCOM typelib information catalog
`XUL.mfl` `XUL FastLoad File` `XUL.mfasl` | XUL fast load file. Contains precompiled chrome and JavaScript.
`Invalid.mfasl` `Aborted.mfasl` | At some time SeaMonkey invalidated your XUL fast load file. These are the previous files. You can just delete them if you don't want to debug them.
`mozver.dat` | (Windows) Stores component version
`SeaMonkeyUninstall.exe` | (Windows) Uninstaller executable file
| Other Files
`*.msf` | Mail Summary Files. Contains summary of the mail folder. Located in the ImapMail and Mail directories.
`msgFilterRules.dat` | Contains the Mail Filters for the current server. Located in the ImapMail and Mail directories.
`*.rc` | Contains subscribe newsgroups for the current server. Located in the News directory.
`hostinfo.dat` | Contains all the newsgroups available for the current server. Located in the News directory.

## Profile Locations

The following lists typical profile locations:

Windows

  On Windows 95, Windows 98, or Windows ME (without log-in), the profile directory is typically
  `C:\Windows\Application Data\Mozilla\Profiles\[Profile Name]\[random string].slt\`

  On Windows 95, Windows 98 or Windows ME with log-in, the profile directory is typically
  `C:\Windows\Profiles\[Log-in Name]\Application Data\Mozilla\Profiles\[Profile Name]\[random string].slt\`

  On Windows 2000 or Windows XP, the profile directory is typically
  `C:\Documents and Settings\[Log-in Name]\Application Data\Mozilla\Profiles\[Profile Name]\[random string].slt\`

  Note: on Windows 2000 or Windows XP, the `Document and Settings` directory is hidden twice. To access the directory, enable Windows Explorer to view System and Hidden directories and files.

Mac OS X

  The profile location is typically:
  `~/Library/Mozilla/Profiles/[Profile Name]/[random string].slt/`

Linux

  The profile location is typically:
  `~/.mozilla/[Profile Name]/[random string].slt/`