Installing EPrints 3 on Win32

From EPrints Documentation
Jump to: navigation, search

Download an appropriate EPrints Release

Warning This feature requires EPrints version 3.2.1 or later

EPrints 3.4+ no longer supports installation on Windows. If you do not have a Linux server, you can always create a Linux virtual machine on a Windows PC, get one on a Cloud hosting service or use Docker.

This page contains notes concerning installing version EPrints 3.3 on Win32-based platforms. Windows is not a well-supported platform and these instructions are likely to go out of date, due to the complexity of getting a working Apache-Perl environment working. It is strongly recommended to install EPrints on Linux operating system such as RedHat or Ubuntu.


  • Microsoft Windows XP or later
  • Apache 2.0 or later
  • MySQL 5 or later
  • ModPerl 2.0 or later

For indexing and thumbnailing you will also need:

Download EPrints Windows Installation Package (MSI)

Download the latest Win32 build from the link at the top of this page - do not install this until ALL supporting software is in place and in the places outlined!

Supporting Software


Download and install 64bit MySQL from

During the MySQL configuration Wizard:

  • Change default character set to Best support For Multilingualism


Download and install the 64bit Apache 2.2 from to C:\Apache2.

  • Add C:\Apache2\bin to the windows path environment variable. Failure to add this path will result with a missing libaprutil-1.dll error when you attempt to run EPrints.


Download and install the 64bit Strawberry Perl 5.16 from to C:\Strawberry


Download and install the 64bit mod_perl for Strawberry Perl 5.16 from

Perl Modules

At a command-prompt run:

> cpan install Win32-Daemon
> cpan install Win32-DriveInfo

Indexing and Thumbnailing Tools

To get indexing and thumbnailing working will require some configuration file changes.

When you have installed a tool you need to tell EPrints where to find it. Edit perl_lib\EPrints\

$EPrints::SystemSettings::conf = {
 executables => {
  convert => '/ImageMagick/convert.exe',
  pdftotext => '/xpdf/pdftotext.exe',

For a full list of tools look in lib\syscfg.d\


Edit the Apache configuration file C:\Apache2\conf\httpd.conf and add below the last LoadModule line:

# LoadFile C:/perl/bin/perl510.dll # Not necessary?
LoadModule perl_module modules/

And at the end of the file:

Include C:/eprints/cfg/apache.conf

Getting Started

To create the indexer service entries (EPrints 3.3+), as administrator run:

> perl C:\eprints\bin\indexer install

Before starting Apache configure a new repository, see Getting Started with EPrints 3.

You will need to manually restart the indexer if you change the repository configuration.