# Komodo Installation Guide

- Windows
  - Prerequisites
  - Upgrading from a Previous Komodo Version
  - Installing Komodo on Windows
  - Command Line Installation Options
  - Starting Komodo on Windows
  - Uninstalling Komodo on Windows
- Mac OS X
  - Prerequisites
  - Upgrading from a Previous Komodo Version
  - Installing Komodo on OS X
  - Starting Komodo on OS X
  - Uninstalling Komodo on OS X
- Linux
  - Prerequisites
  - Upgrading from a Previous Komodo Version
  - Installing Komodo on Linux
  - Starting Komodo on Linux
  - Uninstalling Komodo on Linux

## Windows

### Prerequisites

#### Hardware Requirements

- 1GHz (or faster) x86 or x86_64 processor
- 1 GB RAM
- 200 MB hard disk space
- 340 MB of temporary hard disk space during installation

#### Operating System Requirements

The following platforms are officially supported. Current Critical Updates, Windows Updates, and Service Packs must be installed (see http://windowsupdate.microsoft.com).

- Windows 7
- Windows Vista
- Windows XP
- Windows Server 2003

To install on Windows XP, you may need to upgrade your version of Windows Installer.

#### Software Prerequisites on Windows

### Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions. For major release upgrades (e.g. 3.5 to 4.0) the installer will automatically put Komodo in a new directory.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version before installing the new one, or manually specify a different install directory during the installation process. Your Komodo preferences will be preserved as they are installed in a different directory.

### Installing Komodo on Windows

Before you start:

- If you intend to run the installation from a shared network drive, your system must have `SYSTEM` rights (or greater) to the directory from which the installation is run. Alternatively, run the installation from a local drive.

To install Komodo on Windows:

1. Ensure you have the prerequisite hardware and software.
2. Download the Komodo installer file.
3. Double-click the installer file and follow the instructions.

When installation is complete, you will see an ActiveState Komodo icon on your desktop.

### Command Line Installation Options

Komodo can also be installed from the command line. For example:

    c:\> msiexec.exe /i Komodo-<version>.msi

Komodo's installer uses Windows Installer technology, which allows you to partially control the install from the command line. For example:

#### Installing the MSI in Silent Mode

You can have the Komodo installer run with a reduced user interface. For example, the following will install silently and only open a dialog when the installation is complete.

    c:\> msiexec.exe /i Komodo-<version>.msi /qn+

The following will install with no dialog at all.

    c:\> msiexec.exe /i Komodo-<version>.msi /q

#### Turning on Logging

You can generate a log of the Komodo installation with the following command:

    c:\> msiexec.exe /i Komodo-<version>.msi /L*v install.log

#### Controlling the Install Directory

Command line options can be used to configure Komodo installation properties. The following will install Komodo to "E:\myapps\Komodo", instead of the default location:

    c:\> msiexec.exe /i Komodo-<version>.msi INSTALLDIR=D:\myapps\Komodo

#### Controlling Which Features Get Installed

Komodo is divided into a number of distinct features. In the "Customize Setup" dialog you can select which features to install. You can also do this on the command line with the ADDLOCAL property. For example, the following command will install just the core Komodo functionality (i.e. not the PyWin32 extensions or the documentation.

    c:\> msiexec.exe /i Komodo-<version>.msi ADDLOCAL=core

The current set of Komodo features are:

    core             Komodo core
    env              Windows environment settings
        desktop      Desktop shortcut
        quicklaunch  Quick launch shortcut
        register     Register this as the default Komodo
    docs             Documentation

The hierarchy denotes dependencies (i.e. to install `quicklaunch` you must install the `env`.

The register option puts the Komodo location in the registry so 'start komodo' works, and adds bindings for .kpz and .kpf Komodo project files.

### Starting Komodo on Windows

To start Komodo on Windows, use one of the following methods:

- Double-click the desktop icon.
- Select Start|Programs|ActiveState Komodo|Komodo.
- Add the Komodo install directory to your `PATH` environment variable, then from the command line prompt, enter `komodo`.

### Uninstalling Komodo on Windows

To uninstall Komodo, select Start|Programs|ActiveState Komodo|Modify or Uninstall Komodo.

Alternatively, use the Add/Remove Programs menu (accessible from the Windows Control Panel).

## Mac OS X

### Prerequisites

#### Hardware Requirements

- Intel processor
- 1 GB RAM
- 200 MB hard disk space
- 340 MB of temporary hard disk space during installation

#### Operating System Requirements

- Mac OS X 10.4 (Tiger) or later

### Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version or rename the .app before installing the new one. Your Komodo preferences will be preserved as they are installed in a different directory.

### Installing Komodo on Mac OS X

To install Komodo:

- Download the Komodo disk image (`Komodo-<version>-macosx-<x86>.dmg`).
- If the browser does not automatically mount the disk image and open the mounted folder in Finder, double-click the `.dmg` file to do so.
- Open a new Finder window. Drag the Komodo icon from the mounted folder to the Applications folder.
- If desired, drag the Komodo icon into the Dock.

### Starting Komodo on OS X

Click the Komodo icon in the Dock or the Applications folder.

### Uninstalling Komodo on OS X

Drag the Komodo icon into the Trash.

## Linux

### Prerequisites

#### Hardware Requirements

- 1GHz (or faster) x86 or x86_64 processor
- 1 GB RAM
- 200 MB hard disk space
- 340 MB of temporary hard disk space during installation

#### Operating System Requirements

Supported operating systems:

The following platforms are officially supported.

- Red Hat Enterprise Linux 5 or later
- CentOS 5.0 or later
- Fedora Core 8 or later
- OpenSUSE 10.2 or later
- Ubuntu 7.04 or later

Other operating systems:

Komodo can also be run on the following platforms. This version of Komodo has not necessarily been tested on these platforms; platform-specific bugs may or may not be fixed.

- Debian GNU/Linux 4.0 ("etch")
- Mandriva
- FreeBSD (with Linux binary compatibility)
- Gentoo

#### Software Prerequisites on Linux

Installation Prerequisites:

- glibc 2.4 (or higher) and libjpeg.so.62 (or higher): These libraries are included in standard Linux distributions.
- libstdc++6 (or higher)
- GTK+ 2.10 (or higher)

Non-ASCII Input Requirements (IME):

- SuSE: scim, scim-bridge-gtk and scim-bridge-qt packages.
- Ubuntu: scim, scim-gtk2-immodule, scim-qtimm, and scim-tables-additional packages (if not already installed).
- Fedora Core / RHEL / CentOS: scim, scim-gtk and scim-qtimm packages.

#### Adding Perl or Python to the `PATH` Environment Variable

To add Perl or Python to the `PATH` environment variable, do one of the following:

- Modify your `PATH` environment variable. For example, if you use the Bash shell, add the following line to your ~/.bashrc file:

      export PATH=<installdir>/bin:$PATH

  ...where <installdir> points to the directory where you installed ActivePerl or ActivePython.
- Create a symbolic link to the Perl or Python executable. For example, for ActivePerl, enter:

      ln -s <installdir>/bin/perl /usr/local/bin/perl

  For ActivePython, enter:

      ln -s <installdir>/bin/python /usr/local/bin/python

  ...where <installdir> points to the directory where you installed ActivePerl or ActivePython.

### Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions. For major release upgrades (e.g. 3.5 to 4.0) the installer will automatically put Komodo in a new directory.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version before installing the new one, or manually specify a different install directory during the installation process. Your Komodo preferences will be preserved as they are installed in a different directory.

### Installing Komodo on Linux

This version of Komodo allows non-root installation on Linux. Note, however, that the user who executes the license file will be the user who is licensed to use the software.

To install Komodo on Linux:

1. Download the Komodo installer (.tar.gz file) into a convenient directory.
2. Unpack the tarball:

       tar -xvzf Komodo-<version>-<platform>.tar.gz

3. Change to the new directory:

       cd Komodo-<version>-<platform>

4. Run the install script ("install.sh"):

       ./install.sh

5. Answer the installer prompts:
6. - Specify where you want Komodo installed, or press 'Enter' to accept the default location (`/home/<username>/Komodo-<IDE|Edit>-x.y`).The `-I` option can be used to specify the install directory. For example:

         ./install.sh -I ~/opt/Komodo-IDE-4.2

     If multiple users are sharing the system and will be using the same installation, install Komodo in a location every user can access (e.g. `/opt/Komodo-x.x/` or `/usr/local/Komodo-x.x/`).

     Note:

     - Each Komodo user requires their own license key.
     - Do not install Komodo in a path that contains spaces or non-alphanumeric characters.
     - Be sure to install Komodo into its own directory (i.e. not directly in an existing directory containing shared files and directories such as `/usr/local`).

7. Once the installer has finished, add Komodo to your PATH with one of the following:
   - Add Komodo/bin to your PATH directly:

         export PATH=<installdir>/bin:$PATH

   - Add a symlink to Komodo/bin/komodo from another directory in your PATH:

         ln -s <installdir>/bin/komodo /usr/local/bin/komodo

     Note: Creating symlinks in system directories such as `/usr/bin` requires root access.

After completing the installation, you can delete the temporary directory where the Komodo tarball was unpacked.

### Starting Komodo on Linux

To start Komodo on Linux enter ``komodo`` at the command line or create a shortcut on your desktop or in your toolbar using the full path to the `komodo` executable.

### Uninstalling Komodo on Linux

To uninstall Komodo on Linux:

1. Delete the directory that Komodo created during installation.
2. If you wish to delete your Komodo preferences, delete the `~/.komodo` directory. If you do not delete this directory, subsequent installations of Komodo will use the same preferences.

Note: You cannot relocate an existing Komodo installation to a new directory by simply moving it. You must uninstall Komodo from the existing location and reinstall it in the new location.