Related YoLinux Tutorials:
°Web Site Configuration
°Web Site Password Protection
°YoLinux Tutorials Index
Free Information Technology Magazines and Document Downloads
|List of Web Photo Album Galleries:
Linux Server Gallery Software:
|Web Server Software||Description||Requirements||Demo|
|CopperMine||Message board format||PHP, GD or ImageMagick and MySQL||demo|
|Easy Photo Gallery||PHP 5, MySQL, GD, Zlib||Screen shots|
|Gallery2||Complete Gallery||PHP (and php gd or GraphicsMagick), ImageMagick (or NetPBM), SQL db. Install with YUM from EPEL repository.|
|Goop Gallery||Full featured, no DB required.||CMS: CakePHP or Drupal|
|Gullery||Photo hiearchy||Ruby, mini-Magick||no demo|
|iFoto||PHP, GD2 and CSS based|
|MiniShowcase||Galleries and thumbnails||PHP|
|My Photo Gallery||Directory based hierarchy||PERL, ImageMagick|
(included in a standard Linux installation)
|Plogger||Heirarchy of photos||PHP, MySQL and GD||demo|
|PYXY||Simple collection of photos||PHP, Lightbox.js||demo|
|Simple PHP Photo Gallery||PHP|
|Single File Gallery||Just a single PHP file.||PHP and php gd|
|Weblery||Single PHP file.||PHP|
|Zen||Heirarchy of images||PHP5, GD and MySQL 5||demo|
After reviewing many of the Web Photo Gallery server software packages,
I quickly became convinced that "My Photo Gallery" by Mike Spice, was the
best balance between features and complexity of installation for an online
community/family photo album for my family web site.
This particular tutorial covers "My Photo Gallery" installed on
Red Hat Linux.
Features include the ability to browse photos in "thumbnail" format
and select photos for viewing. The thumbnails are generated on the fly
the first time through. A search capability is also built in to make
it easy for the viewer to find photos. The photo site management tool
provided allows one to upload/delete photos, create and delete folders
(album directories) and to annotate it all. It is ideal for setting
up a community/family photo album on the web which users/family members
can self manage.
The hierarchy and organization is maintained by file system directories
which nicely mapped to the way I organized photos on my own desktop.
MyPhotoGallery will generate the thumbnail images and web presentation and navigation.
- Configure web server: It is assumed that Linux is installed including the Apache web server and PERL.
See the YoLinux.com Web server configuration tutorial for Apache, DNS and FTP configuration.
Also see the YoLinux.com Internet security configuration tutorial.
- Install ImageMagick: ImageMagick Home
(They also have tar.gz files.)
- Red Hat/CentOS/Fedora:
- Yum installation: yum install ImageMagick ImageMagick-perl
- Install from RPM's:
rpm -Uvh --nodeps -ImageMagick-5.3.7-1.i386.rpm ImageMagick-perl-5.3.7-1.i386.rpm ImageMagick-devel-5.3.7-1.i386.rpm
[Potential Pitfall] Red Hat 7.1: The --nodeps flag fixes the dependency on libbz2.so.1.0
Add link: ln -s /usr/lib/libbz2.so.1.0.0 /usr/lib/libbz2.so.1.0
[Potential Pitfall] Red Hat 7.1: The installation of C++ development libraries may cause dependency failures. They can be removed:
rpm -e ImageMagick-c++-5.2.7-2 ImageMagick-c++-devel-5.2.7-2
- Ubuntu: apt-get install imagemagick perlmagick
- Install libjpeg: MyPhotoGallery requires the command jpegtran:
- Red Hat/CentOS/Fedora: yum install libjpeg
- Install PERL modules:
- Install PERL modules using CPAN libraries:
First time through it will ask a bunch of questions.
(Answer "no" to the first question for autoconfigure.)
Defaults were good for me. The only reason to manually configure this is if you are using a proxy.
It then asks for your location (i.e. North America) and country.
I entered a number for the first CPAN server but after that the actual URL was cut and pasted in whole.
# perl -MCPAN -e shell
cpan> install IO::String
cpan> install Image::Info
Image::Info is up to date. - I guess I was good to go on this one.
cpan> install Image::Magick - I did not need to do this as it was supplied by the RPM
- Install PERL modules using RPM's:
Example: Red Hat Enterprise 5/CentOS 5 Perl module RPM install:
Perl module RPMs are available from http://pkgs.repoforge.org/:
- rpm -ivh perl-IO-String-1.08-1.2.el5.rf.noarch.rpm perl-Image-Info-1.26-1.el5.rf.noarch.rpm perl-Image-Base-1.07-2.2.el5.rf.noarch.rpm perl-Image-Xbm-1.08-2.2.el5.rf.noarch.rpm perl-Image-Xpm-1.09-2.2.el5.rf.noarch.rpm
- Install RPM from YUM repository: yum install ImageMagick-perl
If it fails to install, load the appropriate RPMs and retry using
"force install module-name"
- Prepare CGI directory:
For more on SELinux, see our Apache configuration tutorial.
cd /var/www/cgi-bin/ - Note: Ubuntu uses /usr/lib/cgi-bin/
mkdir cgi-user1-photo - or pick a name which works for you.
chmod +rx cgi-user1-photo
chcon -R -h -t httpd_sys_script_exec_t cgi-user1-photo - If using SELinux kernel
- Prepare user photo directories:
For more on SELinux, see our Apache configuration tutorial.
mkdir photo - To store photo image files (or pick a name which works for you.)
mkdir photodata - To store photo comments, data and thumbnail files
chmod ugo+rx photo photodata - or chown apache.apache photodata or use Apache suexec
chmod ugo+w photodata
chcon -R -h -t httpd_sys_script_rw_t photo photodata - If using SELinux kernel
- Unpack myPhotoGallery: tar xzf myphotogallery-X.X.tar.gz
(This creates a subdirectory "photo/" and its' contents.)
- Relocate cgi and prepare cgi directory:
cd photo - Directory created by un-taring/un-zipping tar.gz file.
cp -R common.pl sitevariables.pl imagemagick.pl index.cgi protected/ /var/www/cgi-bin/cgi-user1-photo
chmod ugo+w /var/www/cgi-bin/cgi-user1-photo/log.txt
chcon -R -h -t httpd_sys_script_ra_t /var/www/cgi-bin/cgi-user1-photo/log.txt
cp template.html /var/www/cgi-bin/cgi-user1-photo
chcon -R -h -t httpd_sys_script_ro_t /var/www/cgi-bin/cgi-user1-photo/template.html
- Relocate supporting image files:
cp -R site-images/ /home/user1/public_html/photodata/
chcon -R -h -t httpd_sys_content_t /home/user1/public_html/photodata/site-images
- Password protecting the album management CGI (protected/manage.cgi):
See the YoLinux Apache authentication tutorial.
This prevents other internet users from unauthorized upload and modification of your photo album.
Directories which have files which are created or modified must have
access privileges which allow the Apache web server the ability to upload, create or modify the files.
This includes the photodata directory and log files.
This can be achieved by one of the following solutions:
- Files copied to a directory assume the SELinux context type of the directory.
- SELinux change context command chcon man page
- SELinux Context Types:
||Used for static web content. i.e. HTML web pages.
||Use for executable CGI scripts or binary executables.
||CGI is allowed to alter/delete files of this context.
||CGI is allowed to read or append files of this context.
||CGI is allowed to read files and directories of this context.
- Allowing all users the ability to write or modify:
chmod ugo+w photodata
- Make it owned by the web server process "apache" (Red Hat/Fedora) or "www-data" (Ubuntu):
chown apache.apache photodata
- Configure the Apache web server to execute the CGI as the directory owner.
The cgi can run under (switch user) the owners id.
By default, the Red Hat configuration has the apache web server running under the user id apache. Ubuntu will run under the user id www-data.
For more on Apache configuration for suexec, see our Apache configuration tutorial.
Edit configuration files: (First cd /var/www/cgi-bin/cgi-user1-photo/)
- Set paths: sitevariables.pl
- Edit page template: template.html
This step is only required if you want to change the page title, default colors, add CSS, etc. Add tips and instructions here as well.
- Configuration Management: http://your-domain/cgi-bin/cgi-user1-photo/protected/manage.cgi
Perform this first. This CGI will test your PERL module installation, ImageMagick installation and CGI access to all required directories.
- Photo Album Viewing: http://your-domain/cgi-bin/cgi-user1-photo/index.cgi
- A file system directory is equivalent to a "Photo Album".
- Uploading files: One may use the web interface (manage.cgi) to upload from a remote client computer or just place the photos in directories on the web server (via FTP or read from CD, etc) and MyPhotoGallery will operate on the image files it finds in those directories.
- An image can be chosen as the "Album Cover" or the default file folder icon will be used.
- Directory/Album password protection: Create a file "lock" in the directory/album to protect.
[Potential Pitfall] A corrupted or blank
file will cause a unique error. When viewing an album, the entire page will be
blank. Remove the image file or rename with a "." as a prefix to make it a
hidden file and all will work again.
[Potential Pitfall] MyPhotoGallery version 2.X (old) Do NOT upload an image
file with blanks in the name because it will mess up the generation of the thumbnail images. Use and underscore "_" instead.
It is not something that UNIX users would typically do but the MS/Windows users
seem to do this as a matter of habit. (Later version of MyPhotoGallery fixes this limitation)
[Potential Pitfall] Do not use the character "&" in a file or folder name.
[Potential Pitfall] Upgrade from Red
Hat 7.1 to 7.3 breaks the Photo Album due to bugs in Image Magick. To
fix this I had to reinstall the old version by performing the following
- rpm -e ImageMagick ImageMagick-perl ImageMagick-devel xfig
- ln -s /usr/lib/libbz2.so.1.0.2 /usr/lib/libbz2.so.1.0
- rpm -ivh --nodeps ImageMagick-5.3.7-1.i386.rpm ImageMagick-devel-5.3.7-1.i386.rpm ImageMagick-perl-5.3.7-1.i386.rpm
|Generate a static photo gallery:
A static photo gallery is one which is comprised of a static HTML page of
thumbnail images which link to a full size version of the image selected.
The web server based image gallery software covered above are server based software systems to enable the upload and display of photos.
The software is used to dynamically generate the pages.
Two Linux desktop GUI tools are covered here which can be used to generate
a static HTML page of your photos.
The Red Hat (RHEL6) and Fedora based distributions (including clones like CentOS),
include the KDE Konqueror web and file browser (RPM package: kdebase) with the Image Gallery plugin.
The current realese of Ubuntu Natty (11) does not include this Konqueror plugin so I recommend the use of KDE Kallery.
|Using KDE Konqueror Web Browser / File Manager (kfm) to generate a static photo gallery:
Konqueror (KDE 3 and 4): The KDE file manager/web browser has the ability to generate a web page (html) displaying thumbnails of photos which when selected will display the full photo.
This requires the image manipulation software dependancy: ImageMagick.
Place all photos to be displayed on the web page in a single directory.
Launch the KDE file manager:
- /usr/bin/kfmclient exec ./
(required for Fedora 3 but not in later releases)
Where "./" is the current directory or the directory path of the photos.
Browse file system with browser: file:/
Use the KDE file manager to go to that directory and press "ctrl-I" to
generate. (Or from the task bar select: "Tools" + "Create Image Gallery")
The result is the generation of thumbnail images of all photos (it generates the directory thumbs/ and the thumbnail images) and a web page
(images.html) to display all the thumbnail images with hyperlinks to the actual photos.
Select "Tools" + "Create Image Gallery"
Take defaults or customize your settings.
KDE Konqueror requires the "Image Gallery" plugin.
Verify that this plugin is pressent: "Settings" + "Configure Extensions"
The KDE file transfer capabilities may be used to upload this to the web server.
(fish://www.host.com/path uses ssh for file transfer).
Ubuntu Lucid: apt-get install konqueror kdelibs konqueror-plugin-kimgallery
This feature is no longer available in Ubuntu Natty (11)
Takes a directory of images, scales them to a user specified maximum size and quality and generates an html page of thumbnail images, each of which link to a web page (optional) displaying the full size image.
This application will lead you step by step to the generation of a web page of thumb nail images and the selection of images.
- Ubuntu: apt-get install kallery
Select "Add ..." to select the image files to use.
The vieing order can be customized.
You have the option to choose the thumbnail image size as well as the image size of the "full size" image to be viewed upon selection.
Other options include image information to be displayed (date, dimensions, file size, custom comments, exposure info, ...), background colors, link and navigation customization, CSS, language encoding, etc ...