[%- mypath = "${template.name}"|replace('[^\/]*$','') -%] [%- PROCESS "${mypath}/relnote.var" -%]

# Installation Instructions for [% rnote.name %]

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 [% rnote.name %]

## Before you install

You can safely install SeaMonkey with other Internet client software, such as Mozilla suite, Firefox, Google Chrome, Netscape, Firefox, Microsoft Internet Explorer, Safari, Microsoft Outlook or OutLook Express, Eudora, and Opera. SeaMonkey can import user data from many other Internet clients; however, import may not work if you uninstalled the client first. If you wish to migrate from another Internet client to SeaMonkey, we recommend that you uninstall the client after you have both installed SeaMonkey and have migrated your user data. For more details, read Migrating from another Internet client.

Note: 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.

### If you have a previous version of SeaMonkey installed

Before installing a new version of SeaMonkey, you should uninstall your previous version first. If you have a third-party extension installed, particularly the spell checker, you should also completely delete your SeaMonkey install directory before making a new install. Do not install over an old SeaMonkey version.

Following the uninstall instructions in this document should not affect your profile data (unless your profile files are in a custom location).

### If you have Mozilla suite, Netscape 6 or 7 installed

Do NOT share profiles between SeaMonkey and Mozilla suite, Netscape 6 or 7. SeaMonkey, Mozilla and Netscape 6 or 7 share the same profile registry and directory. However, a profile created by one may be incompatible with another. Mozilla automatically uses your Mozilla, Netscape 6 or 7 profile unless you have multiple profiles, in which case SeaMonkey prompts you to choose a profile.

To avoid accidentally opening SeaMonkey with your Mozuilla or Netscape profile, create a new, extra profile using your Mozilla’s or Netscape’s Profile Manager before installing SeaMonkey.

## 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 [% rnote.name %]. 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 seamonkey[% rnote.version %] (`mkdir seamonkey[% rnote.version %]`) and change to that directory (`cd seamonkey[% rnote.version %]`).
2. Click the link to download the installer file (called `seamonkey-[% rnote.version %].en-US.linux-i686.installer.tar.gz`).
3. Change to the SeaMonkey directory (`cd seamonkey[% rnote.version %]`) 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 "seamonkey[% rnote.version %]" (`mkdir seamonkey[% rnote.version %]`) and change to that directory (`cd seamonkey[% rnote.version %]`).
2. Click the link to download the non-installer seamonkey*.tar.gz file into the `seamonkey[% rnote.version %]` directory.
3. Change to the seamonkey directory (`cd seamonkey[% rnote.version %]`) and decompress the file with the following command:
   `gunzip -dc sea*.tar.gz | tar -xvf -` (This creates a "seamonkey" subdirectory under your seamonkey[% rnote.version %] 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 `seamonkey[% rnote.version %]` 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-[% rnote.version %].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-[% rnote.version %].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-[% rnote.version %].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\SeaMonkey[% rnote.version %]` .
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 [% rnote.name %].
- If the zip build was used then simply remove the SeaMonkey[% rnote.version %] 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/`

## Migrating from other Internet client software

SeaMonkey can import data directly from other popular Internet clients such as Netscape Communicator, Microsoft Internet Explorer, Microsoft Outlook or Outlook Express, and Eudora. SeaMonkey can also import data in several standard file formats, so migrating from other client software is also possible.

SeaMonkey co-exists well with other Internet programs, so uninstalling them is unnecessary.

### Migrating from Netscape Communicator

If you have Netscape Communicator 4.5 or later installed, SeaMonkey automatically converts the default profile (but except for address books) for use with SeaMonkey.

Note: converting Communicator profiles requires that Communicator is still installed on your computer. If you have already uninstalled Communicator, reinstall it again so you can convert your old profiles. After you have converted your old profiles, you can uninstall Communicator.

#### Importing address book

To import your address book from your Communicator profile, first export it in the LDIF format. To do this:

1. Open Address Book in Communicator.

2. In Address Book, open the File menu and choose Export.

3. In the Export dialog, choose type `LDIF (*.ldif)` .

   Type in an identifiable filename that will be used as the address book’s name upon import.

   Save the file.

4. Close Netscape Communicator.

To import the LDIF file to SeaMonkey, follow these steps:

1. In SeaMonkey, open the Windows menu and choose Address Book

2. In Address Book, open the Tools menu and choose Import... .

3. In the Import dialog, select Address Books and click Next.

4. Select `Text file (LDIF, .tab, .csv, .txt)` and click Next.

5. In the file picker dialog, choose the LDIF file you just exported.

6. You should now see the Address successfully imported from Text file message.

#### Converting additional profiles

To convert an additional Communicator profile for use with SeaMonkey, first open the Profile Manager. If SeaMonkey is already running, open the Tools menu and choose Switch Profiles...; otherwise:

- On Windows, open the Start Menu, select Programs, select SeaMonkey, and choose Profile Manager.
- On Mac OS, hold down the Option key and open SeaMonkey from the Finder or the Dock.
- On Linux, run the `./seamonkey -profilemanager` command.

In the Profile Manager dialog, select the profile you want to convert and click Use Profile. A dialog will walk you through the conversion process.

To convert your address books, follow the instructions described in the previous section.

#### Deleting old profiles

Netscape Communicator’s uninstaller does not remove your old profiles. On Windows and Linux, to remove your old profiles, delete the `users` sub-directory in Communicator’s original install directory.

### Migrating from Mozilla suite, Netscape 6 or 7

Your Mozilla suite, Netscape 6 or 7 profiles will be available to SeaMonkey. However, sharing profiles between Mozilla suite, Netscape 6 or 7 and SeaMonkey can cause problems.

SeaMonkey automatically uses your Mozilla or Netscape profile unless you have multiple profiles, in which case SeaMonkey prompts you to choose a profile. To avoid accidentally opening SeaMonkey with your Mozilla or Netscape profile, create a new, extra profile using your Mozilla’s or Netscape’s Profile Manager before installing SeaMonkey.

It is worth repeating that you should not share profiles between SeaMonkey and Mozilla suite or Netscape 6 or 7.

#### AOL Mail and Netscape WebMail

You can use SeaMonkey's mail client to access AOL Mail. To set up your AOL account on SeaMonkey Mail & Newsgroups, create a IMAP mail account, set the incoming server to `imap.aol.com`, and set the outgoing server to `smtp.aol.com`. For accounts with AOL outside of U.S. and CompuServe 2000, see `http://members.aol.com/adamkb/aol/mailfaq/imap/#foreign` for server addresses. For instructions on how to set up an IMAP account, consult SeaMonkey's on-screen Help.

Netscape 6 and 7 has Netscape WebMail integrated into its mail client. SeaMonkey does not have such integration, but you can access Netscape WebMail via the Web at `http://webmail.netscape.com`.

### Importing user data from AOL

SeaMonkey cannot import data from AOL directly. To import mail saved on your computer (Filing Cabinet) and addresses from AOL, you must use third-party utilities to export your data in formats SeaMonkey can import. You may try the utilities listed in:

> `http://www.emailman.com/conversion/`

(The SeaMonkey Project does not recommend or support any software listed on the Web page.)

For general instructions on importing mail and addresses, read Migrating from another mail client.

### Migrating from Microsoft Internet Explorer

Migrating from Microsoft Internet Explorer is easy. SeaMonkey automatically imports your Internet Explorer Favorites. To access them, open the Bookmarks menu and select Imported IE Favorites.

#### Synchronizing your favorites and bookmarks manually

SeaMonkey automatically imports your favorites only once. If you have changed your favorites, you can re-import your favorites manually.

First, you need to export your favorites in HTML format. On Mac OS,

1. Open Internet Explorer.

2. Open the Favorites menu and select Organize Favorites.

3. Open the File menu and select Export Favorites.

4. In the dialog that appears, save the file.

On Windows, to export your favorites,

1. Open Internet Explorer.

2. Open the File menu and select Import and Export.

3. Follow the instructions in the wizard that appears to save your favorites to a file.

To import your favorites to SeaMonkey,

1. Open SeaMonkey. In SeaMonkey Navigator, open the Bookmarks menu and choose Manage Bookmarks.

2. In the Bookmarks Manager, open the Tools menu and choose Import.

3. Open the HTML file you just saved in the file picker.

### Migrating from Microsoft Outlook or Outlook Express

To import your old mail settings, mail, and addresses:

1. Open SeaMonkey Mail & Newsgroups: open the Window menu and choose Mail & Newsgroups.

2. In SeaMonkey Mail & Newsgroups, open the Tools menu and choose Import.

3. Following the instruction of the Import dialog.

Note: importing settings, mail, and addresses from Microsoft Outlook or Outlook Express requires that the program is still installed on your computer. You may uninstall Outlook or Outlook Express afterwards.

Note: SeaMonkey does not support special characters (e.g. / and #) in mail folders. If you receive the following error: Unable to import mailboxes, cannot create proxy object for destination mailboxes, then open Outlook (or Outlook Express) and rename your folders. Then try importing again.

#### Hotmail

SeaMonkey is not integrated with Hotmail, but you can access your Hotmail account via the Web: `http://www.hotmail.com`

### Migrating from Eudora

To import your old mail settings, mail, and addresses:

1. Open SeaMonkey Mail & Newsgroups: open the Window menu and choose Mail & Newsgroups.

2. In SeaMonkey Mail & Newsgroups, open the Tools menu and choose Import.

3. Following the instruction of the Import dialog.

Note: SeaMonkey does not support special character (e.g. / and #) in mail folders. If you receive Unable to import mailboxes, cannot create proxy object for destination mailboxes error, open Eudora and rename your folders. Then try importing again.

### Migrating from another browser

To import saved Internet links to SeaMonkey from a browser other than those mentioned above:

1. From your old browser, export the links as an `HTML` file

2. In SeaMonkey Navigator, open the Bookmarks menu and choose Manage Bookmarks.

3. In the Bookmarks Manager, open the Tools menu and choose Import.

4. Open the HTML file you just saved in the file picker.

You can now access the links from the Bookmarks menu.

### Migrating from another mail client

To import mail from a mail client other than those mentioned above:

1. From your old mail client, export your mail in standard Unix mail box (`.mbx`) format. After the file is saved, remove the file extension if there is any; for example, if the filename is `oldmail.mbx`, change it to `oldmail`.

   The filename of the exported file must not have any special character such as / or #.

2. Close SeaMonkey if you have it running.

3. Copy the mail box file to the `mail/Local Folders` directory in your profile directory (see XXX).

Your old mail should now be accessible from your Local Folders account in SeaMonkey Mail & Newsgroups.

To import mail addresses:

1. From your old mail client, export your address in `LDIF` format.

2. Open SeaMonkey.

   Open the Windows menu and choose Address Book

3. In SeaMonkey Address Book, open the Tools menu and choose Import... .

4. In the Import dialog, select Address Books and click Next.

5. Select `Text file (LDIF, .tab, .csv, .txt)` and click Next.

6. In the file picker dialog, choose the LDIF file you just exported.

7. You should now see the Address successfully imported from Text file message.