Step-by-Step Guide to Installing Greenstone Digital Library on Windows

Building a digital library no longer requires expensive proprietary systems or a dedicated IT team. With Greenstone Digital Library Software (GSDL), any library, college department, or even a single researcher can organise documents, images, and multimedia into a fully searchable online collection. Greenstone is open-source, free, and surprisingly easy to set up on an ordinary Windows machine. This guide walks you through everything you need to know to install Greenstone on Windows, from checking your system requirements to adding the image-processing tools that handle picture-based collections.

What is Greenstone and why libraries use it 🔗

Greenstone is a suite of software for building and distributing digital library collections. It is produced by the New Zealand Digital Library Project at the University of Waikato, and developed and distributed in cooperation with UNESCO and the Human Info NGO based in Belgium. An important point to remember is that Greenstone is not a digital library by itself. As the INFLIBNET case study explains, it is a tool for building digital libraries, giving you a way to organise information and publish it on the web or on removable media such as DVDs and USB drives.

Because it is issued under the GNU General Public License, there are no licensing fees. This makes it especially popular among universities, public libraries, and research institutions that want full control over their collections without recurring costs. The software supports multiple languages in both the reader and librarian interfaces, which is one reason UNESCO has promoted it for institutions in developing countries.

Hardware and software requirements 🔗

Greenstone is lightweight and runs comfortably on most modern computers. You do not need a high-end server for local use. However, a few software components must be in place for the system to function smoothly. Understanding these requirements before you start saves a lot of troubleshooting later.

Java Runtime Environment 🔗

Greenstone relies heavily on Java. The Java Runtime Environment (JRE) is required to run the Greenstone Librarian Interface (GLI), which is the tool you use to create and manage collections. According to the official documentation, the JRE must be installed before you install Greenstone. If you are using a recent distribution, a compatible JRE is bundled with the installer, so it can be set up automatically if your machine does not already have one. You can confirm whether Java is present by opening the Command Prompt and typing java -version. If a version number appears, you are ready to proceed.

Perl 🔗

Perl is the scripting language Greenstone uses behind the scenes for building collections and processing metadata. The good news for Windows users is that you usually do not have to install Perl separately. As noted in the official Greenstone Installer’s Guide, Perl is already included in the Windows version of the software. The bundled copy is configured to work with Greenstone out of the box, which removes a common source of installation errors.

Apache web server (optional) 🔗

An Apache web server is helpful only if you intend to host your library online for many users. For local use on a single computer, you do not need it. Greenstone ships with its own small built-in web server. Greenstone2 includes a Local Library server for Windows, while Greenstone3 bundles the Apache Tomcat server. The Windows release of Greenstone2 also includes the Apache web server in addition to the local library server, as described on the Greenstone download page. So whether you are testing on a laptop or serving collections across a network, the necessary server software is already provided.

Downloading Greenstone 🔗

There are two main ways to obtain Greenstone, and both lead to the same software.

From a UNESCO CD-ROM 🔗

Historically, Greenstone was widely distributed on CD-ROMs prepared by UNESCO. These discs contained much more than just the core software. According to the official Greenstone workshop materials, a UNESCO CD-ROM included the Greenstone software, documented example collections, multiple language interfaces, the export-to-CD package, the ImageMagick graphics package, the Java runtime, and a single installer that set up all of these together. If your institution still has one of these discs, it offers a convenient all-in-one installation. That said, the versions on older CDs are dated, so they are best used only for learning or legacy purposes.

From the Greenstone website 🔗

For most users today, downloading directly from the official Greenstone site is the better choice because you get the latest stable release. The website offers separate distributions for Windows, Linux, and Mac. The current generation, Greenstone3, is written in Java, takes advantage of modern web technologies, and is the version recommended for new installations. The maintainers also continue to provide releases of its predecessor, Greenstone2, which remains popular in many teaching programmes. Each Windows distribution includes everything needed to run the software, including a pre-built demonstration collection so you can see results immediately.

The installation process on Windows 🔗

Installing Greenstone on Windows is designed to be straightforward. For a default installation, almost no configuration is required, which is exactly why end users routinely install it on personal laptops. Here is how the process unfolds.

Step 1: Run the installer 🔗

Once you have downloaded the Windows distribution, simply double-click the installer file. If the green installer splash screen does not appear after a few seconds, the file may have been blocked by Windows security. To fix this, right-click the installer, choose Properties, go to the General tab, and tick the Unblock box near the bottom in the Security section, as advised on the official download page. Then run the installer again.

Step 2: Follow the InstallShield Wizard 🔗

The setup wizard guides you through a series of simple screens. Based on the steps documented in the Greenstone installation lab, the sequence works like this. First, click Next on the welcome screen. Next, read and accept the license agreement. Then choose the installation location; leaving the default is recommended, which places the software in a subdirectory of C:\Program Files. After that, you select the setup type.

Step 3: Choose the Local Library installation 🔗

When prompted for the setup type, leave it at the default Local Library and click Next. The Local Library version is strongly recommended for most users because it runs straight out of the box and needs no special configuration. It contains a small built-in web server, so a standalone computer can serve pre-built collections without any external software. The alternative Web Library version is harder to set up and is only necessary if you already run a web server and want to use it specifically for Greenstone.

Step 4: Set the admin password 🔗

The installer asks you to choose an administrator password. This password protects the administration pages used to manage registered users and collections. If your computer will not be serving collections online, the exact password does not matter much, but it is good practice to set one you will remember. After this, click Install, let the files copy across, and the installation completes.

Step 5: Launch Greenstone 🔗

To start your library, click the Windows Start button, open the Programs menu, and select Greenstone Digital Library. A dialogue box appears; click Enter Library. This automatically opens your web browser and loads the Greenstone home page, where the demonstration collection will be visible. For Greenstone3 installations, the server starts Tomcat and your library becomes available at a local address such as localhost:8383/greenstone3/library. Seeing this page confirms that the installation has succeeded.

Installing ImageMagick for image-based collections 🔗

If you plan to build collections that include images, such as scanned documents, photographs, thumbnails, or cover pages, you will need ImageMagick. This is a free graphics package that Greenstone uses to process and convert image files. Greenstone relies on it to generate thumbnails and to handle various image formats during the collection-building process.

In most current distributions, ImageMagick is bundled with Greenstone, including support for the JPEG2000 format, and you can simply choose to install it during setup. As the Greenstone release notes confirm, you can opt out only if you already have ImageMagick installed on your system. When you install from an older UNESCO CD-ROM, the installer offers to set up ImageMagick once the main installation is complete.

Installing ImageMagick separately 🔗

If your version did not bundle ImageMagick, you can download it from the official ImageMagick website and choose the Windows version that matches your system architecture. During installation, accept the prompts as they appear. The key thing to remember is to enable the legacy utilities option if it is offered, since Greenstone calls these older command-line tools when it processes images. Once ImageMagick is in place, Greenstone can manage image-rich collections without any further setup.

Confirming a healthy setup 🔗

After installation, a quick check helps you avoid surprises later. Open the demonstration collection to confirm searching and browsing work. Open the Greenstone Librarian Interface from the Start menu to confirm the Java-based tool launches correctly. If both open without errors, your Java, Perl, and core Greenstone components are all communicating properly. Should you later need to remove the software, you can do so cleanly through the Windows Add or Remove Programs option.

What do you think? Would you choose the latest Greenstone3 release for its modern web features, or would you start with the simpler Greenstone2 Local Library to learn the basics first? And for your own collection, which image formats do you think you will most need ImageMagick to handle?

References

1. https://www.greenstone.org/
2. https://ebooks.inflibnet.ac.in/lisp8/chapter/case-studies-greenstone-digital-library-software/
3. https://www.nic.funet.fi/index/Science/db/greenstone/Install.pdf
4. https://www.greenstone.org/download
5. https://files.greenstone.org/workshops/jun2007Fiji/labs/lab1.htm
6. https://wiki.greenstone.org/doku.php?id=en:release:3.05_release_notes