Installation Instructions for SeaMonkey 1.1.19

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.19

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

Installation Instructions

Note: It is recommended that you uninstall previous versions of SeaMonkey before installing SeaMonkey 1.1.19. 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.19 (mkdir seamonkey1.1.19) and change to that directory (cd seamonkey1.1.19).
  2. Click the link to download the installer file (called seamonkey-1.1.19.en-US.linux-i686.installer.tar.gz).
  3. Change to the SeaMonkey directory (cd seamonkey1.1.19) 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.19" (mkdir seamonkey1.1.19) and change to that directory (cd seamonkey1.1.19).
  2. Click the link to download the non-installer seamonkey*.tar.gz file into the seamonkey1.1.19 directory.
  3. Change to the seamonkey directory (cd seamonkey1.1.19) and decompress the file with the following command:
    gunzip -dc sea*.tar.gz | tar -xvf - (This creates a "seamonkey" subdirectory under your seamonkey1.1.19 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

Macintosh

System Requirements

Installation Instructions (Mac OS X)

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

  1. Click the seamonkey-1.1.19.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

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.19.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.19.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.19 .
  4. To start SeaMonkey, navigate to the directory you extracted SeaMonkey to and double click the SeaMonkey.exe icon.

Uninstallation Instructions

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.