Installing on a Windows Server (IIS)
Prev | Chapter 1. Gallery 1.x Installation Guide | Next

## Installing on a Windows Server (IIS)

### Note

This guide is being rewritten. The information here now might be volatile and out-of-date. Sorry for the inconvenience while we upgrade our documentation.

### Note

If you are upgrading from a previous version of Gallery, please see the Upgrading Guide.

### Note

IIS is not officially supported by the Gallery Team. These instructions are provided as a guide to help you with setting up Gallery on IIS, but because of major problems with PHP and IIS integration, IIS is not considered a supported platform.

These instructions are a slightly modified and expanded version of the steps previously found in the Wiki web, gathered from various forum users' experiences.

1. Install PHP by running the installer program found at the PHP downloads page

2. Find the `php.ini` file (should be in your system root directory, e.g. `C:\winnt\` or `C:\windows`. Open it in Notepad. Locate the line that starts with `error_reporting` . Change the line to read: `error_reporting = 2039` . Then change the line that starts with `session.bug_compat_warn` to `session.bug_compat_warn = 0`. Next, find the line that starts with `magic_quotes_gpc` and change it to read `magic_quotes_gpc = 0`. Finally, find the line that starts with `session.save_path` and make sure it points to a valid directory, such as `C:\winnt\temp` or `C:\windows\temp`. Also find the line that starts with `upload_tmp_dir`. Set this directive to the same thing as `session.save_path`. Remember what you specified for these directives for a later step.

3. Open the IIS panel (Start -> Control Panel -> Administrative Tools -> Internet Information Services). Right click on the "Default Website" (or the name of the website you're installing Gallery under) and choose "Properties". Click the "Documents" tab, and click "Add". Enter "index.php" and click OK. Click OK and close the IIS panel.

4. Make sure the `IUSR_[machinename]` account has full read/write access to your PHP session data and upload temp directories (see step 2). Find the directory you specified in Windows Explorer and right click on it, choosing "Properties" then "Security". If you see the `IUSR_[machinename]` account listed, make sure it has full read/write permissions. If not, you will have to add this account. Click "Add..." then "Advanced" then "Find Now". It will show a list of all the user accounts available on the machine. Find the `IUSR_[machinename]` account and click "OK" and "OK" again. Then make sure the account has the proper permissions, as listed above.

5. Download ImageMagick and run the installation program. Do NOT install it to the default directory. Instead, choose something like `C:\ImageMagick` or another directory without a space. Remember this directory.

6. If you are using jhead or other optional programs, install them in a directory without a space. Remember which directory you installed them in.

7. Download Gallery and unpack it under your wwwroot directory.

8. Create two directories called `albums` and `tmp` in the newly created directory where you unpacked Gallery. Give the `IUSR_[machinename]` user full read/write access to these two directories.

9. Put Gallery into config mode by running `configure.bat` in the root Gallery directory

   ### Note

   In Gallery 1.4.4, the configure.bat and secure.bat files are no longer necessary. You can safely ignore any steps which mention those two files if you are using Gallery 1.4.4

10. Run the configuration wizard . Input all necessary information, including where you put all the programs you installed earlier and where you created your albums and temp directories (see previous step).

11. Complete the config wizard and run `secure.bat`.

12. Search for `cmd.exe` on your system. It should be in the `C:\windows\system32` or `C:\winnt\system32` folder. Make sure the `IUSR_[machinename]` account has read and execute permissions to it. Another possible solution may be to copy cmd.exe for your `c:\windows\system32\` folder to the same folder `php.exe` resides in. The problem might not just be permissions, but the ability to run `cmd.exe` from it's default location via IIS.

13. Your Gallery should be successfully installed. Enjoy!

### Note

If you are using NetPBM, instead of ImageMagick (not recommended), you may need to refer to FAQ C.26.

Prev | Up | Next
Installing on a Windows Server (Apache) | Home | Upgrading a Previous Gallery Installation