This how-to is written in such a way that (in my opinion) everybody, including people that are new to linux/Freesco, can use it. This means that for more experienced users this how-to is probably too expansive. Sorry for that But I remember my first Freesco-days when I read howto's that I couldn't understand because it assumed the possession of basic skills which I didn't have at that time.
In this how-to, commands you'll have to input are written in code blocks.
Gallery is a web based software product that lets you manage your photos on your own website. You must have your own website with PHP support in order to install and use it. With Gallery you can easily create and maintain albums of photos via an intuitive interface. Give accounts to your friends and family and let them upload and manage their own photos on your website! For more info take a look at the Gallery homepage: http://gallery.menalto.com
Unfortunately it's not possible to get all the features of Gallery working with Freesco. This is because Gallery uses a couple of (optional) binaries which are not available for Freesco. Mind you, it can be done, but not without some serious work/compiling and that is outside the scope of this how-to. Features that won't work:
All other functions should work properly. If you want a Gallery with all features enabled, install Slackware (or some other Linux-distro) on some old machine and run it from there
Well, of course you'll need al working version of Freesco 03x, I'm using 0.3.3 myself. I'm running it on a Pentium 200MMX-64Mb, and that's enough to keep my small Gallery working. Keep in mind that if you plan to put a lot of images in your Gallery, you'll probably need a system that is a bit faster.
You also need a working Web server with PHP enabled. I use apache_1.3.27_dingetje-package with a kernel (I believe the 6th option) from the kernels-1.3-lightning-package 2)
Another package you'll need is utils_1.0_dingetje 3). This package contains the tar and unzip commands you'll need to untar/unzip the files you're about to download. It also contains the vi-editor, which I'll use in this how-to. If you're not familiar with the vi-editor, look f.i here or one of the many other vi tutorials online. Of course feel free to use another editor like the build in freesco editor or the one in the mc package.
You'll also want a shell connection to your Freesco box using the standard Telnet-client or (better!!!) use SSH-access opensshd_3.7.1p1_dingetje-package. I use PuTTY to connect to Freesco with my windows machine.
If you do not have all the packages required, download them at http://www.Freescosoft.org or http://dingetje.homeip.net and install them
First we'll download and “install” the latest version of Gallery. Create a directory in the /www directory where you want to install your Gallery (this can be anything you like).
cd /www mkdir photoalbum cd photoalbum
Now download the latest stable release of Gallery from the Gallery Download Page (http://sourceforge.net/project/showfiles.php?group_id=7130 ) using the snarf command.
tar -zxvf gallery-1.4.4-pl4.tar.gz
You'll see that the tarball extracts itself into a gallery/ dir. Your Gallery-files are now located in /www/photoalbum/gallery
NetPBM are a couple of binaries that Gallery needs in order to handle the images you've uploaded. It resizes them and can create thumbnails etc. You can download a working version of NetPBM from the Gallery Download Page in the same way you've just leeched the Gallery tarball. Unfortunately the latest version of NetPBM (1.4) is too new for the Freesco kernel, so you'll need version 1.1. Take the linux-intel version. If you use this version, the “watermarking” part of Gallery does not work, but I can live with that You'll need to put the NetPBM files in a place like ”/usr/local/NetPBM”
cd /usr/local mkdir NetPBM cd NetPBM snarf http://belnet.dl.sourceforge.net/sourceforge/gallery/NetPBM_gallery-1.4-pl2-linux-intel.zip unzip NetPBM_gallery-1.4-pl2-linux-intel.zip
move all the files to /usr/local/NetPBM Do not forget to make all files and the directory accessible
cd /usr/local chmod -R 755 NetPBM/
Now you've installed all the stuff you need to get Gallery to work.
In your browser, type the following URL: http://my.router.url/photoalbum/gallery/setup/phpinfo.php
You should get a PHPinfo-screen. Check the following variables:
Also check if “session.cookie_domain =” is set to your host, and is not still at “dingetje.homeip.net”. See this FAQ for details.
If your settings are not right edit them in your php.ini file. This file is most likely located at: /usr/local/lib/php.ini
I use the vi-editor:
Safe the file and restart apache
and wait until the HTTP servers have restarted, then refresh/recheck the PHPinfo-screen and see if everything is correct.
In order to make apache obey some commands in the .htaccess-file you'll make the next step, you'll have to add some lines in your htppd.conf file. It might be a safe idea to back up your httpd.conf by typing
cp httpd.conf httpd.conf.old
This way you can always get your web server to run again if you screwed things up
Again we use the vi-editor.
Search for the part of the file where the apache-access to directories is discussed and look for the part where they start talking about ”<Directory ”/www”>”. Scroll down a bit further until you come across the ”</Directory>” line.
Below this line you add the following lines:
<Directory "/www/photoalbum/gallery"> AllowOverride Options FileInfo </Directory>
Safe and exit the file (in vi this is ”:wq”)
Restart the HTTP-servers in order to let this change take effect
Use the vi-editor to create two empty files in this directory
vi config.php (safe and exit) vi .htaccess (safe and exit)
Create a directory for your albums
Create a temp-dir
cd /www mkdir tmp
Now set the right permissions for the files/dirs you've just created
cd /www chmod 777 tmp/ cd /www/photoalbum/gallery chmod 777 albums chmod 666 .htaccess chmod 666 config.php chmod 755 setup/
Every time you want to access the setup of Gallery, you first have to set in into “configure”-mode.
cd /www/photoalbum/gallery sh configure.sh
After you've finished setup, you'll have to put Gallery back into secure mode by
Ok, run the configure.sh script and in your browser go to the following URL:
If you've done everything right, you'll see a screen with a lot of green boxes, some yellow and one red.
|Yellow||12 of 13 NetPBM binaries|
|Yellow||missing ImageMagick binaries|
|Red||missing System locales|
Everything else should be green. You can now continue to step 2
|Graphics suite to use||NetPBM|
|Path to NetPBM||/usr/local/NetPBM|
|PNM to JPEG converter||ppmtojpeg|
Continue to Step 3 and 4 and save the configuration Secure the galley with:
Now go you your Gallery, URL: http://your.router.url/photoalbum/gallery/ And you can log in with the admin-account and password you've created in Step 2 of the Gallery-setup process.
Everything should be up and running and you can start uploading your albums/photos .