# Installing ColdFusion on Linux

Allaire is pleased to offer ColdFusion on the popular Linux platform. This section addresses the following topics about installing ColdFusion on Linux:

- "Installing ColdFusion"
- "Uninstalling ColdFusion"

## Installing ColdFusion

Before installing ColdFusion on Linux, please note the following considerations:

- The installation procedure assumes you are installing from a CD. If you purchased and downloaded ColdFusion from the Allaire Online Store, follow the download instructions found there and then follow the install procedure below, substituting the CD location for the directory in which you downloaded ColdFusion.
- You must log in as root.
- By default the installation script installs ColdFusion into the `/opt` directory. If you want to install ColdFusion into a different directory, you must create that directory before running the installation`` script. The installation script will create a symbolic link from `/opt/coldfusion` to wherever you installed ColdFusion.

| To install ColdFusion on Linux:

1. Log in as `root`.
2. Load the ColdFusion CD-ROM into your CD drive.
3. Mount the CD-ROM on `/mnt/cdrom` if necessary.
4. Change directories to the `cf/linux` directory on the CD.
5. Run the ColdFusion installation script by entering the following command:

   `./cfinstall`

   The ColdFusion installation script starts.

6. Enter your ColdFusion registration ID and press Enter.

   You can find the registration ID on the product box.

7. Enter the name of the directory in which you want to install ColdFusion or accept the default directory.

   `/opt` is the default installation directory.

   Note | If you specified a directory other than the default, the installation script will create a symbolic link from `/opt/coldfusion` to wherever you installed ColdFusion.

8. Enter the name of the Web server you are running and press Enter or just press Enter if you are running the default Web server (Apache).
9. Press Enter to let the installation script automatically configure your Web server for ColdFusion.

   The program loads the necessary plug-in for Netscape or module for Apache 1.3.x Web servers.

10. Enter the path of your Web server's document root directory and press Enter.

    The default document root directory is `home/httpd/html`.

11. Press enter to install the ColdFusion documentation below your Web server's document root directory.

    The documentation is installed in the /`cfdocs` directory, which resides under the Web root directory.

12. Enter the password you want to use to access the ColdFusion Administrator, which allows you to configure and modify settings for the ColdFusion Server.

    You'll be asked to re-enter the password for verification purposes.

13. Enter the password you want to use to connect to ColdFusion Server when developing applications with ColdFusion Studio.

    You'll be asked to re-enter the password for verification purposes.

14. Enter the user name under which ColdFusion will run or press Enter to run under the default user name (`nobody`).

    Note | This user account must be a valid, existing account.

15. If you want to install ClusterCATS at this time, press Enter. Otherwise, enter `n` and press Enter to continue.

    If you do not install ClusterCATS now, you can do so later by running the ClusterCATS installation script on its own. See "Installing ClusterCATS".

16. Press Enter to have the installation script begin copying program files to your server and making the configurations you specified.

Note | If you elected to install ClusterCATS, the ColdFusion installation script runs first, followed by the ClusterCATS installation script. The ClusterCATS installation script will prompt you with additional questions about your Web server configuration.

When the installation is complete, a shell script restarts the Web server and starts ColdFusion services.

## Uninstalling ColdFusion

Use the `remove` utility to delete an installed version of ColdFusion by doing the following:

1. Log in as root.
2. Change to the following directory on your server:

   `/opt/coldfusion/uninstall/cfremove`

   Note | Step 2 assumes you originally installed ColdFusion to the default installation directory (`/opt`). If you installed ColdFusion to a directory other than the default directory, substitute its name in step 2 accordingly.

3. Enter the following command at the prompt:

   `./cfremove`

   ColdFusion is deleted from your server.