Installation

Full installation instructions are found in the README file included with Scry. Here's the quick version, assuming you are installing on a form of UNIX and have PHP with GD already configured:

• download the latest version
• cd /path/to/webserver/document/root
• tar zxvf /path/to/scry/scry-X.X.tar.gz
• mv scry-X.X scry
• cd scry
• mkdir cache
• chmod 777 cache
• edit scry/setup.php; set two filesystem paths and two URLs
• view scry/index.php in your browser and verify your setup
• edit scry/setup.php; set the default theme

Troubleshooting

There are several common problems you may encounter when using Scry for the first time:

Errors about files or directories being unreadable
First verify that $CFG_path_images is correctly set and points to your photos directory. Scry also needs to be able to read from this directory. Make sure that the user your webserver runs under has read and execute permissions on the photo directory and all of its parent directories. This may mean that you need to add read and execute permissions to all users using a command such as chmod w+x,w+r directory_name.

Scry also needs to write to the cache directory you created during setup. Make sure that you changed the permissions of this directory via the chmod 777 cache command.

Errors about Scry being unable to load three .tpl files
This means that Scry can't find the template files it uses to present your albums. Verify that $CFG_path_scry points to the directory where you installed Scry in your webserver's document root. If you're in the scry directory, the result of the pwd command should match $CFG_path_scry.

Thumbnails don't show up, only the image filenames
Right click on one of the broken images and view it. If you get a text message about PHP running out of memory, see the next topic below. If there's an error saying there's been a problem with a GD function (ImageCopyResized, ImageCopyResampled, ImageCreate, ImageCreateTrueColor, ImageCreateFromJpeg), your version of GD may not support all the functions Scry needs. Edit Scry's setup.php and change $CFG_use_old_gd to true. If this solves the problem, Scry will run but in a lower quality mode. Upgrade to GD 2.0 for better image quality. If problems persist, it's possible that PHP and GD are not set up correctly with JPEG support.

Some images show up, others don't
PHP and GD require a fair bit of memory to resize large JPEG images. Right click on one of the images that doesn't show up and view it. If there's a text error saying PHP ran out of memory, you'll have to increase PHP's memory_limit configuration directive.

Scry on Windows
Scry works out of the box on Windows with both Apache and IIS. Be sure to install PHP with GD support. Note that paths must be in the form: c:/scry/photos/.