EPrints Documentation - User contributions [en-gb]

Generic Linux Installation

2026-10-09T18:24:17Z

Drn@ecs.soton.ac.uk:

{{manual}}
[[Category:Installation]]
{{Out of Date|This page is out of date and the installation instruction have problems when running on a modern Linux installation.}}
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

== Prerequisites ==
See the [[Required software]] page.

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7
N.B. EPrints needs to be installed as the same user as the Apache webserver runs as. The instructions above assume you are installing with the user "eprints" and group "eprints". Under most UNIX-based platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd /opt/eprints3/
% autoconf
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:21:40Z

Drn@ecs.soton.ac.uk: /* Installation */

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

== Prerequisites ==
See the [[Required software]] page.

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7
N.B. EPrints needs to be installed as the same user as the Apache webserver runs as. The instructions above assume you are installing with the user "eprints" and group "eprints". Under most UNIX-based platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd /opt/eprints3/
% autoconf
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:20:11Z

Drn@ecs.soton.ac.uk: Added link to required software page

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

== Prerequisites ==
See the [[Required software]] page.

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7
N.B. EPrints needs to be installed as the same user as the Apache webserver runs as. The instructions above assume you are installing with the user "eprints" and group "eprints". Under most UNIX-based platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd /opt/eprints3/
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:17:55Z

Drn@ecs.soton.ac.uk: /* Installation */

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7
N.B. EPrints needs to be installed as the same user as the Apache webserver runs as. The instructions above assume you are installing with the user "eprints" and group "eprints". Under most UNIX-based platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd /opt/eprints3/
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:17:34Z

Drn@ecs.soton.ac.uk: /* Download */

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7
N.B. EPrints needs to be installed as the same user as the Apache webserver runs as. The instructions above assume you are installing with the user "eprints" and group "eprints". Under most UNIX-based platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd eprints-3.something
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:14:56Z

Drn@ecs.soton.ac.uk: /* Installation */

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd eprints-3.something
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:14:14Z

Drn@ecs.soton.ac.uk: /* Download */

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository. E.g.
mkdir /opt/eprints3/
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3
su eprints
git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
cd /opt/eprints3
git checkout v3.4.7

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

EPrints needs to be installed as the same user as the apache webserver runs as. We suggest you install it as user "eprints" and group "eprints". Under some UNIX platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

Unpack the eprints tar.gz file:

% gunzip eprints-3.something.tar.gz
% tar xf eprints-3.something.tar

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd eprints-3.something
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Generic Linux Installation

2026-10-09T18:12:21Z

Drn@ecs.soton.ac.uk: /* Download */

{{manual}}
[[Category:Installation]]
'''Below describes installing EPrints on a generic Linux distribution. It is recommended that EPrints is installed on either [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] or [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.'''

==Download==
EPrints can be cloned from GitHub at https://github.com/eprints/eprints3.4 be sure to checkout the latest release after you clone the repository.

==Installation==
''If you are upgrading an existing installation of eprints please see the section on [[Upgrading]] section of this manual.''

EPrints needs to be installed as the same user as the apache webserver runs as. We suggest you install it as user "eprints" and group "eprints". Under some UNIX platforms, creating a user and group can be done using the "adduser" command. Otherwise refer to your operating system documentation.

Unpack the eprints tar.gz file:

% gunzip eprints-3.something.tar.gz
% tar xf eprints-3.something.tar

Now run the "configure" script. This is a /bin/sh script which will attempt to locate various parts of your system such as the perl binary. It will also check your system for required components.

% cd eprints-3.something
% ./configure

By default the system installs as user and group "eprints". You will need to change this if you are not installing as either "root" or "eprints".

The configure script accepts a number of options.

; --help : List all the options (many are intended for compiled software and are ignored).

Recommended:

; --prefix=PREFIX : Where to install EPrints (or look for a version to upgrade). By default <tt>/opt/eprints3/</tt>
; --with-smtp-server=[HOST] : Use HOST to deliver mail. If the server running EPrints has an MTA such as <tt>exim</tt> or <tt>sendmail</tt>, you can specify '''localhost'''. If you do not specify this option, you will get a warning to configure it later.
; --with-user=[USER] : Install eprints to run as USER. By default "eprints".
; --with-group=[GROUP] : Install eprints to run as GROUP. By default "eprints".

Optional:

; --with-perl=[PATH] : Path of perl interpreter (in case configure can't find it, or you have more than one and want to use a specific one).
; --with-virtualhost=[VIRTUALHOST] : Use VIRTUALHOST rather than * for apache VirtualHost directives.
; --with-toolpath=[PATH] : An alternate path to search for the required binaries.
; --disable-diskfree : Disable disk free space calls. These can cause problems on some platforms, notably 64-bit.

Deprecated:

; --with-apache=1 : Use Apache 1.x.x instead of 2.x.x, but EPrints 3 does not support this.

Once you are happy with your configuration you may install eprints by running install.pl:

% ./install.pl

Now you should edit the configuration file for your copy of apache. This is often <tt>/usr/local/apache/conf/http.conf</tt> or <tt>/etc/httpd/conf/httpd.conf</tt>

Add this line: (If you didn't install eprints in <tt>/opt/eprints3/</tt> replace that with the location on your system).
Include /opt/eprints3/cfg/apache.conf
Note that this file is only available after you created your archive via <tt>epadmin create</tt>. See [[Getting_Started_with_EPrints_3#Running_epadmin|Running epadmin]] for more information on creating an archive.

You need to make sure the apache user have read/write access to the installation directory (/opt/eprints3). The user ''must'' be the same as the user you installed eprints as. We recommend to configure your apache to run as:

User eprints
Group eprints

Template:Manual

2026-10-09T18:09:25Z

Drn@ecs.soton.ac.uk:

{{box|title=Manual Sections|content=
* [[Introduction]]
** [[Contact|How to Get Help/Support]]
** [[History]]
* Installing EPrints & Getting Started
** [[Installation|Installing EPrints]]
*** [[Installing EPrints on RHEL/Fedora/CentOS|Installation on RHEL-based Linux]]
*** [[Installing_EPrints_on_Debian/Ubuntu|Installation on Debian/Ubuntu]]
*** [[Generic Linux Installation|Installation on Generic Linux OS]]
**** [[Required software]]
** [[Upgrading|Upgrading EPrints]]
** [[Getting Started]]
** [[Backups]]
** [[Troubleshooting]]
** Advanced Installation
*** [[How to use EPrints with HTTPS]]
*** [[Setting up email]]
* Configuring EPrints
** [[Branding/Logos]]
** [[Metadata|Deposit Types and Metadata]]
** [[Organisation Hierarchy]]
** [[Searches]]
* Advanced Configuration/Howtos
** [[Setting up HTTPS using Let's Encrypt]]
** [[HTTPS-only and HSTS]]
** [[Shibboleth|User Authentication using Shibboleth]]
* Technical Reference
** [[EPrints configuration|EPrints Configuration Reference]]
** [[Repository configuration|Repository Configuration Reference]]
** [[Metadata|Metadata Reference]] (also [[Functions]])
** [[API Overview]]
* [[Entire Manual]] (for printing)
}}
[[Category:Manual]]

Template:Manual

2026-10-09T18:08:48Z

Drn@ecs.soton.ac.uk: Added required software only for generic install

{{box|title=Manual Sections|content=
* [[Introduction]]
** [[Contact|How to Get Help/Support]]
** [[History]]
* Installing EPrints & Getting Started
** [[Installation|Installing EPrints]]
*** [[Installing EPrints on RHEL/Fedora/CentOS|Installation on RHEL-based Linux]]
*** [[Installing_EPrints_on_Debian/Ubuntu|Installation on Debian/Ubuntu]]
*** [[Generic Linux Installation|Installation on Generic Linux OS]]
**** [[Required Software]]
** [[Upgrading|Upgrading EPrints]]
** [[Getting Started]]
** [[Backups]]
** [[Troubleshooting]]
** Advanced Installation
*** [[How to use EPrints with HTTPS]]
*** [[Setting up email]]
* Configuring EPrints
** [[Branding/Logos]]
** [[Metadata|Deposit Types and Metadata]]
** [[Organisation Hierarchy]]
** [[Searches]]
* Advanced Configuration/Howtos
** [[Setting up HTTPS using Let's Encrypt]]
** [[HTTPS-only and HSTS]]
** [[Shibboleth|User Authentication using Shibboleth]]
* Technical Reference
** [[EPrints configuration|EPrints Configuration Reference]]
** [[Repository configuration|Repository Configuration Reference]]
** [[Metadata|Metadata Reference]] (also [[Functions]])
** [[API Overview]]
* [[Entire Manual]] (for printing)
}}
[[Category:Manual]]

Required software

2026-10-09T18:07:05Z

Drn@ecs.soton.ac.uk:

{{manual}}
[[Category:Installation]]

==What Additional Software does EPrints Require?==

In brief, EPrints minimally requires Apache (with mod_perl), MySQL and Perl with some extra modules. Various utilities like wget, tar and unzip would also be useful.

EPrints bundles some [https://github.com/eprints/eprints3.4/blob/master/cpan_modules.pl Perl modules] which it uses, to save you installing them.

==Where to get the Required Software==
Apache, MySQL, Perl and mod_perl are all provided as operating system level packages that can be installed on EPrints' [[Recommended Platforms]]. If you wish to install on a platform that is not recommended, then you will need to determine the best way to install these applications. It may be possible to infer comparable packages for your platform by checking the dependencies installed on [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] and [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.

==Other Tools==

===File uploads===
<tt>wget</tt>, <tt>tar</tt>, <tt>gunzip</tt> and <tt>unzip</tt> are required to allow users to upload files as <tt>.tar.gz</tt> or <tt>.zip</tt> or to capture them from a URL.

These all come installed with most modern versions of linux. If you cannot get them working, you can remove the relevant option by editing "archive_formats" in <tt>SystemSettings.pm</tt>

If there are problems you may need to tweak how these are invoked in <tt>SystemSettings.pm</tt>.

===Full Text Indexing===
The EPrints indexer requires various tools to extract plain (UTF-8) text from different types of document for indexing.

The full text indexer requires various tools to index each kind of document. These tools may or may not be already installed in your system. EPrints uses these tools to build a "words" file for each document (which contains the text of the document in UTF-8). If it can't run the tool, the "words" file will be empty and EPrints will not retry creating it unless you manually remove it.

====PDF====
Full text indexing PDF documents requires <tt>pdftotext</tt> application provided by the ''poppler-utils'' Deb or RPM package.

====Microsoft Word====
Full text indexing of Microsoft Word documents is provided by the ''antiword'' Deb or RPM package. The RPM package is available through the [https://forensics.cert.org/cert-forensics-tools-release-el7.rpm forensics] RPM repository.

====HTML====
Full test indexing of HTML documents requires the <tt>lynx</tt> text-based browser provided by the ''lynx'' Deb or RPM package.

===LaTeX Tools===
There is an optional feature which allows you to instruct EPrints to look in certain fields (e.g. title and abstract) for strings that look like LaTeX equations and render them as images. These tools are only required if you want to use this feature.

These are provided by the ''tetex-latex'' and ''ImageMagick'' RPMs or the ''texlive-base'', ''texlive-bin'' and ''imagemagick'' Deb packages.

This is a "cosmetic" feature, it only affects the rendering of information, so you can always add it later if you want to save time initially.

==Other Platforms==
Often the best way to find certain packages of other platforms is to use a search engine to look for the package name for Red Hat or Ubuntu Linux along with the name of your platform. (E.g. antiword Arch Linux). If you platform does not have comparable packages, then the next best option is to download the software tool is the official site. Below are links to the download pages for the essential components of EPrints:
* [https://httpd.apache.org/download.cgi Apache]
* [https://dev.mysql.com/downloads/ MySQL] (or [https://downloads.mariadb.org/ MariaDB]) as well as [https://www.postgresql.org/download/ PostgreSQL] and even [https://www.oracle.com/de/downloads/ ORACLE]
* [https://www.perl.org/get.html Perl]
* [https://perl.apache.org/download/ mod_perl]

Required software

2026-10-09T18:06:54Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Archive:Required software to Required software over a redirect without leaving a redirect: Not deprecated for generic Linux installation

{{manual}}
[[Category:Installation]]
{{Deprecated|This page is no longer required as prerequisite software is listed on the Installation page for the appropriate platform.}}

==What Additional Software does EPrints Require?==

In brief, EPrints minimally requires Apache (with mod_perl), MySQL and Perl with some extra modules. Various utilities like wget, tar and unzip would also be useful.

EPrints bundles some [https://github.com/eprints/eprints3.4/blob/master/cpan_modules.pl Perl modules] which it uses, to save you installing them.

==Where to get the Required Software==
Apache, MySQL, Perl and mod_perl are all provided as operating system level packages that can be installed on EPrints' [[Recommended Platforms]]. If you wish to install on a platform that is not recommended, then you will need to determine the best way to install these applications. It may be possible to infer comparable packages for your platform by checking the dependencies installed on [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based]] and [[Installing EPrints on Debian/Ubuntu|Debian based]] Linux.

==Other Tools==

===File uploads===
<tt>wget</tt>, <tt>tar</tt>, <tt>gunzip</tt> and <tt>unzip</tt> are required to allow users to upload files as <tt>.tar.gz</tt> or <tt>.zip</tt> or to capture them from a URL.

These all come installed with most modern versions of linux. If you cannot get them working, you can remove the relevant option by editing "archive_formats" in <tt>SystemSettings.pm</tt>

If there are problems you may need to tweak how these are invoked in <tt>SystemSettings.pm</tt>.

===Full Text Indexing===
The EPrints indexer requires various tools to extract plain (UTF-8) text from different types of document for indexing.

The full text indexer requires various tools to index each kind of document. These tools may or may not be already installed in your system. EPrints uses these tools to build a "words" file for each document (which contains the text of the document in UTF-8). If it can't run the tool, the "words" file will be empty and EPrints will not retry creating it unless you manually remove it.

====PDF====
Full text indexing PDF documents requires <tt>pdftotext</tt> application provided by the ''poppler-utils'' Deb or RPM package.

====Microsoft Word====
Full text indexing of Microsoft Word documents is provided by the ''antiword'' Deb or RPM package. The RPM package is available through the [https://forensics.cert.org/cert-forensics-tools-release-el7.rpm forensics] RPM repository.

====HTML====
Full test indexing of HTML documents requires the <tt>lynx</tt> text-based browser provided by the ''lynx'' Deb or RPM package.

===LaTeX Tools===
There is an optional feature which allows you to instruct EPrints to look in certain fields (e.g. title and abstract) for strings that look like LaTeX equations and render them as images. These tools are only required if you want to use this feature.

These are provided by the ''tetex-latex'' and ''ImageMagick'' RPMs or the ''texlive-base'', ''texlive-bin'' and ''imagemagick'' Deb packages.

This is a "cosmetic" feature, it only affects the rendering of information, so you can always add it later if you want to save time initially.

==Other Platforms==
Often the best way to find certain packages of other platforms is to use a search engine to look for the package name for Red Hat or Ubuntu Linux along with the name of your platform. (E.g. antiword Arch Linux). If you platform does not have comparable packages, then the next best option is to download the software tool is the official site. Below are links to the download pages for the essential components of EPrints:
* [https://httpd.apache.org/download.cgi Apache]
* [https://dev.mysql.com/downloads/ MySQL] (or [https://downloads.mariadb.org/ MariaDB]) as well as [https://www.postgresql.org/download/ PostgreSQL] and even [https://www.oracle.com/de/downloads/ ORACLE]
* [https://www.perl.org/get.html Perl]
* [https://perl.apache.org/download/ mod_perl]

Talk:Required software

2026-10-09T18:06:54Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Archive talk:Required software to Talk:Required software over a redirect without leaving a redirect: Not deprecated for generic Linux installation

[http://amohseni.info/img/styles/il-romanzo/ il romanzo di un maestro] [http://psisemiya.com/images/small/citroen-cv/ citroen 2cv annunci] [http://ustall.org/web/benni-bennasi.htm benni bennasi hit my heart] [http://davte.info/library/html/ted-nugent.htm ted nugent. full bluntal nugity live] [http://amohseni.info/img/styles/fitzroy-fiume/ fitzroy (fiume)] [http://psisemiya.com/images/small/cartoni-porno/ cartoni porno di kiki di dragonball] [http://chaba.info/immagini-rose/ immagini rose virtuali] [http://chaba.info/grazia-par/ grazia par la vida] [http://amohseni.info/img/styles/david-gnomo/ david gnomo] [http://kinunia.cn/elise-lotus.htm elise lotus] [http://ustall.org/web/tatuaggi-libellule.htm tatuaggi libellule] [http://helmed.info/topic/kiss-dvd/ kiss dvd hard disk] [http://helmed.info/topic/sistema-solar/ sistema solar] [http://amohseni.info/img/styles/suonerie-sansung/ suonerie sansung] [http://chaba.info/la-fata/ la fata dei confetti] [http://kinunia.cn/nelly-fyrtado.htm nelly fyrtado] [http://kinunia.cn/www-chiwawa.htm www chiwawa it] [http://psisemiya.com/images/small/scaricare-versioni/ scaricare versioni latino greco gratis] [http://davte.info/library/html/opel-zafira.htm opel zafira milano] [http://nobinters.org/tettte.htm tettte] [http://psisemiya.com/images/small/daddo/ daddo] [http://psisemiya.com/images/small/logitech-driving/ logitech driving force pro ps2] [http://ustall.org/web/pesi-balt.htm pesi balt] [http://helmed.info/topic/our-lives/ our lives the calling] [http://helmed.info/topic/adattatore-cf/ adattatore cf mmc] [http://kinunia.cn/chrysler-voyager.htm chrysler voyager 2.5 crd] [http://davte.info/library/html/giocattoli-bandai.htm giocattoli bandai] [http://davte.info/library/html/gatto-molto.htm gatto molto] [http://davte.info/library/html/mezzi-pesanti.htm mezzi pesanti in vendita] [http://ashythro.info/library/html/teoria-e/ teoria e tecnica] [http://amohseni.info/img/styles/baclofene/ baclofene] [http://nobinters.org/stahl-hermann.htm stahl, hermann] [http://saibso.org/www-citroen.htm www citroen it] [http://ustall.org/web/elvis-presley.htm elvis presley comeback] [http://davte.info/library/html/antenna-per.htm antenna per radio] [http://davte.info/library/html/dipinto-paesaggio.htm dipinto paesaggio] [http://ustall.org/web/valtur-sigla.htm valtur sigla] [http://psisemiya.com/images/small/telecomando-cancelli/ telecomando cancelli] [http://kinunia.cn/nfl-street.htm nfl street] [http://ashythro.info/library/html/viaccess-id/ viaccess id keys 18 2004] [http://ustall.org/web/transmeta-computer.htm transmeta computer] [http://helmed.info/topic/hanno-bisogno/ hanno bisogno damore] [http://nobinters.org/commissione-desame.htm commissione desame] [http://helmed.info/topic/tlotr-sountrack/ tlotr sountrack] [http://kinunia.cn/psp-value.htm psp value pack] [http://nobinters.org/dragostea-din.htm dragostea din tie italiano] [http://chaba.info/bwv/ bwv 1041] [http://bloprofeldi.info/lib/dlink-dfw.htm d-link dfw-500] [http://helmed.info/topic/stampante-inkjet/ stampante inkjet formato a2] [http://bloprofeldi.info/lib/motorola-v.htm motorola v 525] [http://amohseni.info/img/styles/nw-e/ nw -e99] [http://kinunia.cn/testo-senza.htm testo senza dubbio articolo31] [http://amohseni.info/img/styles/gprs-gsm/ gprs gsm pc card] [http://davte.info/library/html/sony-vaio.htm sony vaio vgn-fs215z] [http://ustall.org/web/zoom-nikkor.htm zoom nikkor] [http://helmed.info/topic/placido-beniamino/ placido beniamino] [http://bloprofeldi.info/lib/canzone-anni.htm canzone anni 70] [http://chaba.info/tanzania-zanzibar/ tanzania zanzibar vacanze] [http://saibso.org/nuove-navi.htm nuove navi festival crociera] [http://ustall.org/web/lettore-divx.htm lettore divx dvd tx] [http://bloprofeldi.info/lib/turn-me.htm turn me around] [http://bloprofeldi.info/lib/concorsi-per.htm concorsi per call center] [http://chaba.info/video-sul/ video sul nazismo] [http://saibso.org/hell-song.htm hell song] [http://helmed.info/topic/batterie-t/ batterie t28] [http://kinunia.cn/iquique.htm iquique] [http://kinunia.cn/egaxve-sfma.htm eg701ax-ve sfma] [http://kinunia.cn/firma-costituzione.htm firma costituzione europea] [http://kinunia.cn/vaccinium.htm vaccinium] [http://helmed.info/topic/sblocco-nec/ sblocco nec e228] [http://kinunia.cn/dischi-dvd.htm dischi dvd da 8 cm sony] [http://chaba.info/gf-hard/ gf hard] [http://amohseni.info/img/styles/donnie-darko/ donnie darko in italia] [http://psisemiya.com/images/small/www-spazio/ www spazio adolescenti it] [http://kinunia.cn/batterie-per.htm batterie per cellulari ericsson t39] [http://kinunia.cn/gino-paoli.htm gino paoli per una storia] [http://kinunia.cn/dirty-dancing.htm dirty dancing] [http://bloprofeldi.info/lib/www-erotico.htm www erotico] [http://ustall.org/web/laser-colori.htm laser colori a3] [http://saibso.org/citta-del.htm citta del vaticano] [http://davte.info/library/html/musica-gdv.htm musica gdv] [http://bloprofeldi.info/lib/canon-ef.htm canon ef 20mm] [http://helmed.info/topic/stato-di/ stato di fatto] [http://bloprofeldi.info/lib/moto-bimbo.htm moto bimbo] [http://chaba.info/tastiere-cordless/ tastiere cordless] [http://nobinters.org/telefonini-con.htm telefonini con radio e lettore mp3] [http://bloprofeldi.info/lib/clarissa-escort.htm clarissa escort] [http://kinunia.cn/villa-ada.htm villa ada 5 agosto 2003] [http://helmed.info/topic/tv-lcd/ tv lcd 20 sharp lc-20sh1e] [http://ashythro.info/library/html/su-puo/ su puo dare di piu] [http://ustall.org/web/sandals.htm sandals] [http://davte.info/library/html/messenger.htm messenger 8 0] [http://bloprofeldi.info/lib/ethernet-pci.htm ethernet pci] [http://kinunia.cn/metal-slug.htm metal slug x] [http://davte.info/library/html/hp-stampanti.htm hp stampanti multifunzione] [http://helmed.info/topic/mexico-en/ mexico en las olimpiadas] [http://psisemiya.com/images/small/pentium-p/ pentium p4] [http://bloprofeldi.info/lib/decreto-moratti.htm decreto moratti] [http://bloprofeldi.info/lib/casella-blu.htm casella blu] [http://helmed.info/topic/canzone-romantica/ canzone romantica] [http://davte.info/library/html/philips-hz.htm philips 100hz 32] [http://psisemiya.com/images/small/niurka-batista/ niurka batista] [http://ashythro.info/library/html/recuerdos-de/ recuerdos de ti] [http://helmed.info/topic/aspire/ aspire 1300] [http://psisemiya.com/images/small/m-firenze/ m2 firenze] [http://kinunia.cn/maximus-mix.htm maximus mix] [http://saibso.org/portatile-registratori.htm portatile registratori] [http://ustall.org/web/negozi-vendita.htm negozi vendita mobili afgani] [http://helmed.info/topic/hp-/ hp 1010 toner] [http://amohseni.info/img/styles/computer-con/ computer con windows media center] [http://amohseni.info/img/styles/mappe-esami/ mappe esami stato] [http://nobinters.org/touran-trendline.htm touran trendline] [http://amohseni.info/img/styles/inverter-w/ inverter 300w] [http://nobinters.org/carta-geografica.htm carta geografica italia] [http://chaba.info/dvd-le/ dvd le fate ignoranti] [http://psisemiya.com/images/small/vonda-shepard/ vonda shepard tell him] [http://helmed.info/topic/mi-chiamo/ mi chiamo giulia ross] [http://bloprofeldi.info/lib/testo-degli.htm testo degli oro vivo per lei] [http://saibso.org/siti-nazi.htm siti nazi] [http://davte.info/library/html/finanziamento-nice.htm finanziamento nice] [http://davte.info/library/html/yetisports.htm yetisports 1 2 3 4 5 6 7 8 9] [http://ashythro.info/library/html/rete-switch/ rete switch] [http://nobinters.org/verbania-calcio.htm verbania calcio] [http://amohseni.info/img/styles/fr-david/ fr david] [http://psisemiya.com/images/small/il-computer/ il computer] [http://kinunia.cn/citta-di.htm citta di rovellasca provincia di como] [http://helmed.info/topic/free-it/ free6 it] [http://ustall.org/web/www-roswel.htm www roswel t] [http://helmed.info/topic/the-legend/ the legend of fong sai-yuk] [http://saibso.org/giocattoli-casette.htm giocattoli casette] [http://helmed.info/topic/sawaru-made/ sawaru made in wario] [http://kinunia.cn/kthob.htm kth-ob6200 512] [http://nobinters.org/wifi-access.htm wifi access point adsl] [http://helmed.info/topic/the-doors/ the doors film] [http://helmed.info/topic/diffusori-pc/ diffusori pc] [http://psisemiya.com/images/small/rednex-wish/ rednex wish] [http://psisemiya.com/images/small/salento-in/ salento in bus] [http://davte.info/library/html/segnali-nella.htm segnali nella nebbia] [http://saibso.org/hotel-principe.htm hotel principe gatteo a mare] [http://kinunia.cn/julian-mcmahon.htm julian mcmahon] [http://helmed.info/topic/verbatim-metal/ verbatim metal azo] [http://psisemiya.com/images/small/kvrxsc-/ kvr133x64sc3 256 sodimm cl3] [http://davte.info/library/html/aficio.htm aficio 551] [http://ashythro.info/library/html/no-me/ no me puedo explicar] [http://nobinters.org/quattrocchi-filmato.htm quattrocchi filmato] [http://saibso.org/trust-k.htm trust 56k v92 bluetooth wireless modem] [http://chaba.info/ati-radeon/ ati radeon x600pro 256] [http://psisemiya.com/images/small/bagnetto-cassettiera/ bagnetto cassettiera] [http://chaba.info/camera-cologno/ camera cologno monzese] [http://ustall.org/web/piropos-para.htm piropos para enamorar] [http://psisemiya.com/images/small/thuban/ thuban] [http://helmed.info/topic/nano-nano/ nano nano] [http://davte.info/library/html/ragazze-taormina.htm ragazze taormina] [http://ustall.org/web/allegrini-amarone.htm allegrini amarone] [http://chaba.info/canne-di/ canne di mare] [http://psisemiya.com/images/small/video-a/ video a chi dice] [http://ashythro.info/library/html/asus-ddr/ asus ddr 400 socket a] [http://helmed.info/topic/packard-bell/ packard bell vt700] [http://saibso.org/hotel-cordova.htm hotel cordova] [http://helmed.info/topic/giuseppe-x/ giuseppe x 69] [http://ashythro.info/library/html/pix/ pix] [http://chaba.info/remi-shand/ remi shand] [http://ustall.org/web/holly-halston.htm holly halston] [http://amohseni.info/img/styles/inteligente/ inteligente] [http://bloprofeldi.info/lib/copertina-dragostea.htm copertina dragostea compilation] [http://nobinters.org/modello.htm modello 730] [http://bloprofeldi.info/lib/drinken.htm drinken] [http://ashythro.info/library/html/negozi-motori/ negozi motori] [http://davte.info/library/html/download-shanghai.htm download shanghai] [http://chaba.info/acer-monitor/ acer monitor al1715s 17] [http://saibso.org/piscina-catania.htm piscina catania] [http://amohseni.info/img/styles/fox-calendario/ fox calendario] [http://kinunia.cn/sisma-molise.htm sisma molise] [http://davte.info/library/html/lacie-mobile.htm lacie mobile hard drive] [http://ustall.org/web/charis-pietro.htm charis, pietro] [http://ashythro.info/library/html/i-bolidi/ i bolidi] [http://chaba.info/ariante-tower/ ariante tower] [http://nobinters.org/peg-perego.htm peg perego modular system pliko] [http://ustall.org/web/letras-de.htm letras de canciones de korn] [http://ashythro.info/library/html/campeggi-d/ campeggi d italia] [http://kinunia.cn/tv-italiana.htm tv italiana] [http://ustall.org/web/mini-inferno.htm mini inferno] [http://helmed.info/topic/letchworth/ letchworth] [http://davte.info/library/html/www-netpia.htm www netpia com] [http://ashythro.info/library/html/e-sia/ e sia cosi] [http://psisemiya.com/images/small/www-blue/ www blue it] [http://ustall.org/web/stampanti-brother.htm stampanti brother fronte retro] [http://chaba.info/ispels/ ispels] [http://bloprofeldi.info/lib/fattisentire.htm fattisentire] [http://kinunia.cn/a-fsi.htm a3 fsi] [http://amohseni.info/img/styles/ragazzo-fidenza/ ragazzo fidenza] [http://bloprofeldi.info/lib/incontro-settimo.htm incontro settimo torinese] [http://ustall.org/web/cd-key.htm cd key nba live 2003] [http://saibso.org/porno-ialia.htm porno ialia] [http://chaba.info/video/ video 666] [http://nobinters.org/milo-gioielli.htm milo gioielli] [http://psisemiya.com/images/small/www-japan/ www japan imports com] [http://saibso.org/traduzione-canzone.htm traduzione canzone 2pac] [http://ustall.org/web/tatta.htm tatta] [http://saibso.org/carica-batterie.htm carica batterie rapido aa ni-mh]

Template:Manual

2026-10-09T18:05:34Z

Drn@ecs.soton.ac.uk: Removed required software page

{{box|title=Manual Sections|content=
* [[Introduction]]
** [[Contact|How to Get Help/Support]]
** [[History]]
* Installing EPrints & Getting Started
** [[Installation|Installing EPrints]]
*** [[Installing EPrints on RHEL/Fedora/CentOS|Installation on RHEL-based Linux]]
*** [[Installing_EPrints_on_Debian/Ubuntu|Installation on Debian/Ubuntu]]
*** [[Generic Linux Installation|Installation on Generic Linux OS]]
** [[Upgrading|Upgrading EPrints]]
** [[Getting Started]]
** [[Backups]]
** [[Troubleshooting]]
** Advanced Installation
*** [[How to use EPrints with HTTPS]]
*** [[Setting up email]]
* Configuring EPrints
** [[Branding/Logos]]
** [[Metadata|Deposit Types and Metadata]]
** [[Organisation Hierarchy]]
** [[Searches]]
* Advanced Configuration/Howtos
** [[Setting up HTTPS using Let's Encrypt]]
** [[HTTPS-only and HSTS]]
** [[Shibboleth|User Authentication using Shibboleth]]
* Technical Reference
** [[EPrints configuration|EPrints Configuration Reference]]
** [[Repository configuration|Repository Configuration Reference]]
** [[Metadata|Metadata Reference]] (also [[Functions]])
** [[API Overview]]
* [[Entire Manual]] (for printing)
}}
[[Category:Manual]]

Talk:Required software

2026-10-09T18:04:55Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Talk:Required software to Archive talk:Required software: Deprecated

Required software

2026-10-09T18:04:54Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Required software to Archive:Required software: Deprecated

Required software

2026-10-09T18:04:45Z

Drn@ecs.soton.ac.uk: Deprecated page

Archive:Recommended Platforms

2026-10-09T18:02:58Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Recommended Platforms to Archive:Recommended Platforms: Deprecated

{{manual}}
[[Category:Installation]]
{{Deprecated|This page is deprecated. Recommended platforms are listed on the [[Installation]] page instead.}}

* '''Red Hat based Linux''' - [[Installing EPrints on RHEL/Fedora/CentOS|Installation Guide]]
** Red Hat Enterprise Linux (RHEL) (http://www.redhat.com/rhel/): Red Hat Enterprise Linux (RHEL) 9 is currently recommended. However, RHEL 10 should now be suitable as long as you are running at least version 10.1.
** Fedora Core (http://fedora.redhat.com/): Fedora 42 or later currently recommended. However, Fedora version move on quickly, so go out of support quickly and are not regularly tested and therefore Fedora is not recommended for production EPrints repositories.
** Rocky Linux (https://www.rockylinux.org/): Rocky Linux 9 is currently recommended. However, Rocky Linux 10 should now be suitable as long as you are running at least version 10.1.
** Alma Linux, Oracle Linux and other derived versions of RHEL should also be suitable. Version 9 of these Linuxes are currently recommended but version 10 should be suitable as long as you are running at least version 10.1.

* '''Debian based Linux''' - [[Installing EPrints on Debian/Ubuntu|Installation Guide]]
** Debian (https://www.debian.org/) - 11 (Bullseye), 12 (Bookworm) or 13 (Trixie) are currently recommended.
** Ubuntu (https://www.ubuntu.com/) - Ubuntu 22.04 LTS or 24.04 LTS are currently recommended. Non-LTS Ubuntu versions are not recommended.

Recommended Platforms

2026-10-09T18:02:58Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Recommended Platforms to Archive:Recommended Platforms: Deprecated

#REDIRECT [[Archive:Recommended Platforms]]

Archive talk:Recommended Platforms

2026-10-09T18:02:58Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Talk:Recommended Platforms to Archive talk:Recommended Platforms: Deprecated

I need to install and configure eprints in windows XP...
Can anyone help me

Talk:Recommended Platforms

2026-10-09T18:02:58Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Talk:Recommended Platforms to Archive talk:Recommended Platforms: Deprecated

#REDIRECT [[Archive talk:Recommended Platforms]]

Archive:Recommended Platforms

2026-10-09T18:02:41Z

Drn@ecs.soton.ac.uk:

Template:Manual

2026-10-09T18:01:06Z

Drn@ecs.soton.ac.uk: Removed unnecessary page in manual

{{box|title=Manual Sections|content=
* [[Introduction]]
** [[Contact|How to Get Help/Support]]
** [[History]]
* Installing EPrints & Getting Started
** [[Required software|Installing Required Software]]
** [[Installation|Installing EPrints]]
*** [[Installing EPrints on RHEL/Fedora/CentOS|Installation on RHEL-based Linux]]
*** [[Installing_EPrints_on_Debian/Ubuntu|Installation on Debian/Ubuntu]]
*** [[Generic Linux Installation|Installation on Generic Linux OS]]
** [[Upgrading|Upgrading EPrints]]
** [[Getting Started]]
** [[Backups]]
** [[Troubleshooting]]
** Advanced Installation
*** [[How to use EPrints with HTTPS]]
*** [[Setting up email]]
* Configuring EPrints
** [[Branding/Logos]]
** [[Metadata|Deposit Types and Metadata]]
** [[Organisation Hierarchy]]
** [[Searches]]
* Advanced Configuration/Howtos
** [[Setting up HTTPS using Let's Encrypt]]
** [[HTTPS-only and HSTS]]
** [[Shibboleth|User Authentication using Shibboleth]]
* Technical Reference
** [[EPrints configuration|EPrints Configuration Reference]]
** [[Repository configuration|Repository Configuration Reference]]
** [[Metadata|Metadata Reference]] (also [[Functions]])
** [[API Overview]]
* [[Entire Manual]] (for printing)
}}
[[Category:Manual]]

Archive:OneShare

2026-10-09T17:58:55Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page OneShare to Archive:OneShare: Out of date

[[Category:EdShare]]
{{Out of Date|The information on this page has not been significantly updated since 2009.}}

This page provides information on what makes EdShare/Language Box/OneShare different from a standard EPrints installation.

Add to this page any packages that are relevant to EdShare/LBox.

Please see conversations on:
* [[UserFeedback]]: feedback from Debra and Sue
* Bug lists: cf. Mantis http://lslvm-mmr4.ecs.soton.ac.uk/
* [[OneShareWishList]]: discuss there new features which are not mentioned on this page already.

==Core==

===Data Model (seb)===

Tasks

* What is a bare minimum for metadata?
* What do we do with Uni divisions/hierarchy? Part of extended schema? Part of core-data?
* What do we do with the security model eg viewing/editing permissions? see below.
* Do we include or provide different subjects hierarchies (eg JACS...)? As an optional feature?
* What is the name of a 'resource'? A 'Resource' or a 'Share'?
* What are the basic data types?? On EdShare we have shares, collections, bookmarks, shoppbasket. On LBox we have resources, "resource_collection" -> need to harmonize.

Also see sections on Collections, Bookmarks.

Priority: high, core feature!
Time: dev < 1 week, politics < 1 month hopefully

Dev to make decisions

===User Xperience===

Define a user workflow i.e.:

* How does the user interact with the repository?
* What is their path through the site for creating, managing their resources? Is it consistent?

On Edshare, this needs loads of improvements :)

Make links to all features (browsing, searching etc) intuitive/easy to find/consistent.

Priority: low
Time: 1-2 dev, 1 week politics

===UI Styling===

Create a unique, generic style for OneShare. This should be eye-catching but generic/neutral enough (cf. a vanilla EPrints install).

This include: default citations for resources and files, site template, frontpage, <add more>.

* Also we could package the LBox & EdShare styles as optional themes?

Priority: low
Time: unknown?

===Security (seb)===

Please view [[OneSharePerms]].

====Viewing Permissions====

Use EdShare Soton's advanced viewing permissions to share with selected users, schools etc.

Previews are also included into that model i.e. you cannot see previews for a resource if you're not allowed to view/download the resource.

====Editing Permissions====

Cf. Viewing Permissions but for editing.

Maybe merge viewing + editing perms into a more generic ACL system.

====ACLs for Viewing and Editing items?====

We could create a system of ACL (Access Control List) for each share/resource and add the appropriate hooks in the code:"can_user_edit", "can_user_view".

* The idea on EdShare Soton is good (share with school, uni, x/y) but need refactoring/rewriting.
* How do we generalise this to EPrints and add the right hooks to the existing eprints code? Maybe ask TimB for advice.

Priority: low
Time: 3-4 days to refactor/generalise

====HTTPS====

* Make all the code COMPLIANT to HTTPS :)

===Defaults (seb)===

We need to have default browse views, searches etc. which reflects our metadata schema and interests.

Concerns:
* Views: browse by uni hierarchy? by tag? by course code? (+meprints views)
* Searches: search our metadata fields
* Documents namedsets: add multimedia mime types to EPrints
* EPrints type: let's remove all the default types (article, book...)?
* EPrints fields: let's remove all the default -unused- eprint fields? Maybe be careful of hard-coded fields in the code.
* EPrint Worflow
* User Workflow
* LDAP: most Uni will have a LDAP server
* User roles
* more?

===EdShare's links===

EdShare Soton allows users to share files -or- links and even caches the shared links.

* What do we do with this feature? Is this a customised EdShareSoton feature?

==Preview==

===Generating previews (pat+seb)===

Local Previews (pat)

* Any type of documents (doc, pdf, ppt, html...)
* Any type of multimedia files (video, audio)

Remote Previews (seb)

* Develop an interface which allows OneShare to delegate the generation of previews to another server. Talk to DaveT, TimBrody.

Priority: med-high
Time: 1-2 weeks

===Previews/Coverflow-like interface (pat)===

This will be a part of another thread.

* Decide of a nice "player"?!

Priority: super high
Time: ? months?

* What about presentations of the links?

==Social Tools==

===MePrints Profiles===

* Create a 'screencast' to present the feature
* Unroll MePrints to the live servers (EdShare, LBox)
* Possibly develop widgets for the Learning repos.

Priority: medium
Time: <1 week

===Commenting (SNEEP) (marcus+pat)===

Add tools for commenting resources.

* Test the new SNEEP (+make sure it works on https)

Priority: low
Time: 1-2 days

==Collections (marcus)==

Add virtual collections to EPrints. A virtual collection contains links to other resources.

Priority: low, quite mature code
Time: 1-2 days

===Bookmarks (marcus)===

A special virtual collection available for every user. Bookmarks are persistent and can be shared to other users.

AJAX Tools exist to easily populate bookmarks from search results, summary pages etc. (cf EdShare Soton).

* Using a separate dataobj for bookmarks? This would allow more powerful features eg. "who has bookmarks share X"? Also, this would hide My Bookmarks from my list of resources.

Priority: low, quite mature code
Time: 1-2 days

===Folder/Shopping Basket (unassigned)===

A special virtual collection that allows people to aggregate shares during their current session. This allows easy creation of collections or download of several resources in one go.

Emptied when user logs out. Cannot be shared with other users.

* Using a separate dataobj for bookmarks? This would allow more powerful features eg. "who has bookmarks share X"? Also, this would hide My Bookmarks from my list of resources.
* Do we need this?

===Collections Organiser (all)===

The AJAX tool to easily create, edit and manage collections.

* Need storyboards!
* We know that we need a special tool to manage resources/collections but is this the appropriate one?
* Could this replace the 'Manage Deposit' screen altogether (whether collections are enabled or not)?

Priority: need requirements
Time: unknown

==Embedding content (marcus)==

To allow embeddable objects that present a resource (maybe looking like the coverflow tool).

* What do we expect from such a feature? Needs requirements.

Priority: low
Time: <1 week

==IRStats (unassigned)==

Improved integration of IRStats with EPrints/OneShare.

Stats would be a popular feature?

==Extra Tools (as optional packages?)==

Possible optional packages:

* Anti-Virus Scanning: cf. use of Sophos on the EdShare Soton server.
* Bulk Upload & related features
* Tag cloud
* Presentation of latest additions on the frontpage
* LBox's remixed resources (cf. cloning on EP).
* <add more>

==Blackboard integration (unassigned)==

Single-deposit paradigm i.e. dissemination from BB to OneShare.

This will be part of a separate conversation.

Priority: high
Time: unknown

==Packages==
*[[OneShareCollections | Collections]]

OneShare

2026-10-09T17:58:55Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page OneShare to Archive:OneShare: Out of date

#REDIRECT [[Archive:OneShare]]

Archive:OneShare

2026-10-09T17:58:44Z

Drn@ecs.soton.ac.uk: Added Out of Date template

Archive:Integrating EPrints with LDAP

2026-10-09T17:56:48Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Integrating EPrints with LDAP to Archive:Integrating EPrints with LDAP: Out of date

{{Out of Date|The link below no longer works, so local how to for this needs to be written.}}

[http://wiki.unimas.my/unimaswiki//bin/view/HOW-TO,+Tutorial+&+User+Manual/HOW-TO+:+Install+Eprints+v3.3.12++on+Ubuntu+14.04+With+LDAP+Authentication HOW-TO : Install Eprints v3.3.12 on Ubuntu 14.04 With LDAP Authentication]

[[Category: Howto]]

Integrating EPrints with LDAP

2026-10-09T17:56:48Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Integrating EPrints with LDAP to Archive:Integrating EPrints with LDAP: Out of date

#REDIRECT [[Archive:Integrating EPrints with LDAP]]

Archive:Integrating EPrints with LDAP

2026-10-09T17:56:37Z

Drn@ecs.soton.ac.uk: Added Out of Date template

Archive:Import From URL

2026-10-09T17:54:14Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Import From URL to Archive:Import From URL

[[Category: Howto]]
{{Out of Date|This how to needs updating and has some information that is factual incorrect.}}

'''The Eprints3 XML Format'''

Note: to import local files, see [[Import Files]].

Note: for using --enable-web-imports, in file ~/archives/archiv/cfg/cfg.d/plugins.pl $c->{enable_web_imports}=1; must be set.

The file and metadata you wish to import should be placed in an one of the formats supported by the import script. The example used in this page is the Eprints XML Format. Note: This format can be retrieved by exporting an eprint from your repository. The following is an example of the Eprints 3 XML Format, as standardised in [[EPData XML Representation]].

<blockquote>

<source lang="xml">
<?xml version="1.0" encoding="utf-8" ?>
<eprints>
<eprint>
<eprintid></eprintid>
<rev_number></rev_number>
<eprint_status></eprint_status>
<userid></userid>
<dir></dir>
<lastmod></lastmod>
<status_changed></status_changed>
<type>other</type>
<metadata_visibility></metadata_visibility>
<item_issues_count></item_issues_count>
<creators>
<item>
<name>
<family></family>
<given></given>
</name>
<id></id>
</item>
</creators>
<title></title>
<ispublished></ispublished>
<subjects>
<item>SubjectID</item>
</subjects>
<full_text_status></full_text_status>
<publisher></publisher>
<documents>
<document xmlns="http://eprints.org/ep2/data/2.0">
<docid></docid>
<rev_number></rev_number>
<eprintid></eprintid>
<pos></pos>
<format></format>
<language></language>
<security></security>
<main></main>
<files>
<file>
<filename></filename>
<filesize></filesize>
<url></url>
</file>
<files>
</document>
</documents>
</eprint>
</eprints>
</source>

</blockquote>
'''Importing the File into Eprints'''

After putting the metadata and file URL into Eprints 3XML Format, you are ready to import the file. The example shown uses the import tool in the eprints folder (/opt/eprints3/ is assumed).
<pre>
./import ''repository_id'' --enable-web-imports dataset plugin filename
</pre>

'''--enable-web-imports''' : this is used to enable Eprints to download the file from a URL
Allow the imported data to import files from the Web. This can obviously be seen as a security hole if you don't trust the data you are importing. This sets the "enable_web_imports" configuration option for this session only.

'''dataset''' : The name of the dataset to import into, such as "eprint", "archive", "subject" or "user".

'''plugin''' : The id of the input plugin to use. This should not include the leading "Import::". Examples: BibTeX, XML.

Import From URL

2026-10-09T17:54:14Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Import From URL to Archive:Import From URL

#REDIRECT [[Archive:Import From URL]]

Archive:Import From URL

2026-10-09T17:54:07Z

Drn@ecs.soton.ac.uk: Added Out of Date template

Archive:Impact

2026-10-09T17:52:11Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Impact to Archive:Impact: Out of date

{{Out of Date|This page needs updating with more information about Impact repositories.}}
[[Category: Work in Progress]]
[[Category: Contribute]]

==Purpose==

The University of Glasgow has developed impact and knowledge exchange functionality for EPrints based initially on Research Excellence Framework requirements. The code will be available soon. We will be amending the functionality to facilitate further re-use of the information e.g. potentially for reporting to RCUK. Contact: Michael.Eadie@glasgow.ac.uk or Valerie.McCutcheon@glasgow.ac.uk if you are planning some work in this area. Let’s work together.

==Members==

Impact

2026-10-09T17:52:11Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Impact to Archive:Impact: Out of date

#REDIRECT [[Archive:Impact]]

Archive:Impact

2026-10-09T17:52:02Z

Drn@ecs.soton.ac.uk: Added Out of Date template

Frequently Asked Questions

2026-10-09T17:50:24Z

Drn@ecs.soton.ac.uk:

[[Category:FAQ]]
[[Category:Management]]
{{Out of Date|Some of the answers to these FAQ are out date. Please check the history to see whether the specific FAQ you are reading has been updated recently.}}

This all needs sorting out, it's just being grabbed from the old wiki for now.

* [[Copyright and License FAQ]]
* [[Searching FAQ]]
* [[OAI FAQ]]
* [[How much will it cost?]]

== What operating systems can we use? ==

EPrints should work on any Linux operating system. We use Ubuntu (Debian) and Redhat Enterprise Linux.

Running EPrints on Microsoft Windows is possible but strongly not recommended. It can be very difficult to get all the necessary dependencies in place. If you want to get EPrints running but do not have a computer running a Linux operating system, you could install [https://www.virtualbox.org/wiki/Downloads VirtualBox] and then create a Ubuntu or Redhat "virtual machine" (VM) to run on top of your Windows operating system. Alternatively, you could install [https://docs.docker.com/docker-for-windows/install/ Docker Desktop for Windows] and [[Installing EPrints using Docker|install EPrints using Docker]]. However, both these methods are only recommended for testing or demoing EPrints. If you intend to run EPrints long-term you should install on a dedicated Linux server or virtual machine.

== What computer do we need? ==
Any modern physical PC (server or desktop) or a virtual machine should be more than capable of running EPrints. A suggested minimum specification for running a live service:
* 4GB RAM
* 25GB disk space
* 100Mb/s network speed

== How much will it cost to set up? ==

Most of the costs are staff time. Equipment costs are a PC, an internet connection and a BACKUP STRATEGY. Please remember to budget for backups.

EPrints, and all the other software required to make it work, are available for no cost. At some point in the future EPrints may offer some pay-services, but the core software will remain zero cost and freely available to all.

See [[How much will it cost?]]

== How much disk space will we need? ==
The main usage of disk space will be the uploaded files for the publications, (e.g. PDF, Word documents, etc.). On average an eprint item will have associated files (e.g. uploaded PDF and thumbnail and preview images of that PDF) that take up 2MB of disk space. So for every extra 500 eprint items you will need an extra 1GB of disk. However, if you intend to upload lots of videos, images, or large documents, then this requirement will be higher. On top of the space needed for uploaded documents and associated files you will need approximately 5GB for installing the operating system. The disk space required by the database is difficult to determine, as this is dependent on a number of different factors but 1MB per eprint item.
=== Example usage requirements ===
* Small repository: 1000 eprint items
** Operating system: 5GB
** Upload and associated files: 2MB x 1000 = 2GB
** Database: 1MB x 1000 = 1GB
** '''TOTAL:''' 8GB (15GB to give room for expansion)
* Medium-sized repository: 10,000 eprint items
** Operating system: 5GB
** Upload and associated files: 2MB x 10,000 = 20GB
** Database: 1MB x 10,000 = 10GB
** '''TOTAL:''' 35GB (50GB to give room for expansion)
* Large repository: 100,000 eprint items
** Operating system: 5GB
** Upload and associated files: 2MB x 100,000 = 200GB
** Database: 1MB x 100,000 = 100GB
** '''TOTAL:''' 305GB (350-400GB to give room for expansion)

== Is it possible when depositing a document, to just point to an "alternative location" rather than have the full text copied and held in the eprint archive? ==

Yes, and to suppress the normal warning about no documents attached look in '''[archive_root]/cfg/cfg.d/eprint_warnings.pl'''.

== I need to run apache as a user other than "eprints", what do I do to make EPrints work in this situation? ==

Example, apache is running as user "apache".
* Make all the eprints files owned by "apache" instead of "eprints"
* Edit SystemSettings?.pm to tell eprints to run as user "apache"
* You'll need to run all command line scripts as user "apache"
* All eprints cron jobs should be owned by user "apache"

If you are installing a new copy of eprints, you can specify the user and group to use when you run 'configure'. Do
<syntaxhighlight lang="bash">
./configure --help
</syntaxhighlight>
for details.

== How do I get the body HTML of a page without the template around it? ==
This is handy for dynamically linking EPrints content into other sites.

For "view" pages you need to add the option <code>include=>1</code> to the view configuration. This will cause [[API:bin/generate_views|generate_views]] to make a ''.include'' page in addition to the ''.html'' page. The ''.include'' page will have no template around it.

For dynamic pages, i.e. those under ''/cgi/'', you can add the cgi parameter <code>mainonly=yes</code>. E.g. <code><nowiki>http://tryme.demo.eprints-hosting.org/cgi/latest?mainonly=yes</nowiki></code>

== How do I get statistics on number of deposits per month? ==

This rather grim bit of SQL should work, although datestamp is the last modified date, neither the submission nor creation date, it should still give a good indication.
<syntaxhighlight lang="sql">
select count(*), year(datestamp), month(datestamp)
from archive
group by year(datestamp),month(datestamp)
order by year(datestamp),month(datestamp);
</syntaxhighlight>

== I've edited the template (or other config file) but nothing seems to have changed - why? ==

While EPrints tries to automatically reload when a configuration file is changed you may need to reload the Web server for changes to take effect. See also the [[API:bin/epadmin|epadmin reload]], the [[API:bin/generate_static|generate_static]] and [[API:bin/generate_views|generate_views]] commands.

= How do I add a metadata field to a live repository? =
See [[Adding a Field to a Live Repository]].

= Installation Related Questions =

== When running a script I get the error "Insecure dependency in mkdir while running with -T switch" ==

This usually indicates you are running an eprints script as root. Don't do that; become user 'eprints' instead by <code>su - eprints</code>.

== title and fulltext search returns no results, but date search does ==

The indexer daemon is probably not running or is not working correctly, see [[API:bin/indexer|indexer]].

== I don't want to give epadmin my mysql root password. What is the alternative? ==
<syntaxhighlight lang="sql">
mysql> CREATE DATABASE myrepo;
Query OK, 1 row affected (0.06 sec)

mysql> GRANT ALL PRIVILEGES ON myrepo.* TO myrepo@localhost IDENTIFIED BY 'secret';
Query OK, 0 rows affected (0.52 sec)
</syntaxhighlight>

Then provide the database name, user name and password to the '''[[API:bin/epadmin|epadmin]] create''' command.

== How do I get a value for a field of an eprint (without using any SQL)? ==

(assuming the eprint is in the main archive, and has eprintid number 23)

<syntaxhighlight lang="perl">
my $ds = $repo->dataset( "eprint" );
my $eprint = $ds->dataobj( 23 );
my $value = $eprint->value( "editors" );
</syntaxhighlight>

See [[API:EPrints/DataObj|DataObj]].

== How can I get a utf8 string of the name of a subject, given its subjectid? ==

<syntaxhighlight lang="perl">
sub get_subject_name_string
{
my( $session, $subjectid ) = @_;
my $subj = EPrints::Subject->new( $session, $subjectid );
if( !defined $subj )
{
return "error, unknown subject: $subjectid";
}
return EPrints::Utils::tree_to_utf8( $subj->render_description() );
}
</syntaxhighlight>

Archive:Files/MePrints eNova modifications

2026-10-09T17:46:04Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Files/MePrints eNova modifications to Archive:Files/MePrints eNova modifications: This page has been deprecated

{{Deprecated|eNova is no longer supported by the MePrints plugin.}}
[[Category: Eprints3.3]]
[[Category: MePrints]]

eNova MePrints Enhancements

Following feedback from arts researchers and input from the Research Offices at both University for the Creative Arts and the University of the Arts London, several enhancements to the MePrints plugin were made. This process is detailed in the eNova user feedback report which is available here: http://www.vads.ac.uk/kultur2group/downloads/2011_eNova_user_feedback.pdf
Please note that not all features could be enabled in the EPrints Bazaar package: (fill in if relevant)

This package was developed for the Visual Arts Data Service (VADS), a Research Centre of the University for the Creative Arts, in partnership with the University of the Arts London as part of the JISC funded eNova project (2011). More information is available here: http://www.vads.ac.uk/kultur2group/projects/enova/

Reported issue: there is a problem with MePrints obscuring the simple search (which is also affecting the deposit workflow) in EPrints version 3.3.9.

Known issue: the original eNova designed package should not include the field 'Biography' however it is not possible to remove this from the Bazaar package. The recommended approach is to manually edit workflows to remove the 'Biography' field; this does require additional priviledges or preferably access to the server.

Dependencies: There are a couple of dependencies and a number of reasons why images may fail to be displayed including a failure to read the pdf, failure to create the thumbnails, etc. these can usually be solved by running scripts to redo the thumbnails or checking error logs for pdf read errors.

Files/MePrints eNova modifications

2026-10-09T17:46:04Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Files/MePrints eNova modifications to Archive:Files/MePrints eNova modifications: This page has been deprecated

#REDIRECT [[Archive:Files/MePrints eNova modifications]]

Archive:Files/MePrints eNova modifications

2026-10-09T17:45:53Z

Drn@ecs.soton.ac.uk: Deprecated rather than out of date

Archive:EPrints OAI Stylesheet

2026-10-09T17:43:14Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page EPrints OAI Stylesheet to Archive:EPrints OAI Stylesheet: Out of date

{{Out of Date|This page needs updating.}}

To use the EPrints OAI stylesheet on another server:

# Download the XSL source from https://svn.eprints.org/eprints/trunk/system/lib/static/oai2.xsl
# Make oai2.xsl accessible from somewhere on your OAI 2 server - browsers' same-origin policy require the xsl file to be hosted on the same server
# Add the stylesheet to your OAI 2 response:

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<?xml-stylesheet type='text/xsl' href='/oai2.xsl' ?>
<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
<responseDate>2011-12-15T18:11:46Z</responseDate>
<request>http://eprints.soton.ac.uk/cgi/oai2</request>
<error code="badVerb">Requires verb argument</error>
</OAI-PMH>
</source>

[[Category: OpenAccess]]

EPrints OAI Stylesheet

2026-10-09T17:43:14Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page EPrints OAI Stylesheet to Archive:EPrints OAI Stylesheet: Out of date

#REDIRECT [[Archive:EPrints OAI Stylesheet]]

Archive:EPrints OAI Stylesheet

2026-10-09T17:42:55Z

Drn@ecs.soton.ac.uk: Use Out of Date template rather than category

Site lib/

2026-10-09T17:39:21Z

Drn@ecs.soton.ac.uk:

{{dirs}}

'''site_lib/''' does not exist by default but is a special directory which allows direct overriding of Perl modules under [[Perl_lib/|perl_lib/]]. E.g. If you wanted to change the code in perl_lib/EPrints/DataObj/EPrint.pm, you could copy it to site_lib/plugins/EPrints/DataObj/EPrint.pm and edit it there and the latter version would be loaded in place of the former.

site_lib also allows adding of code and configuration using the same path structure as used in [[Lib/|lib/]]. E.g. If you already had a file at lib/cfg.d/my_config.pl, then if you created another file at site_lib/cfg.d/my_config.pl this latter file would load in place of the former.

Site lib/

2026-10-09T17:34:04Z

Drn@ecs.soton.ac.uk:

{{dirs}}

'''site_lib/''' does not exist by default but is a special directory which allows direct overriding of Perl modules under [[Perl_lib/|perl_lib/]] and well as adding code and configuration in much the same way files are added to [[Lib/|lib/]], using the same path. E.g. if you had created a file under lib/cfg.d/my_config.pl, if you created another config file under site_lib/cfg.d/my_config.pl this latter file would load in place of the former.

EPrints Directory Structure Tree

2026-10-09T17:33:42Z

Drn@ecs.soton.ac.uk:

{{dirs}}

A graphical representation of the [[EPrints Directory Structure|EPrints3 directory structure]] after executing the install.pl command. Initially the <tt>archives</tt> directory is empty, it is populated when executing (as the <tt>eprints</tt> user) the <code>bin/epadmin create</code> command. The new repository is created using the data in the [[lib/defaultcfg_zero/]] directory if not using an [[EPrints Flavours|flavour]] or [[flavours/pub_lib/defaultcfg/|flavours/FLAVOUR/defaultcfg/]] if you are.

<div style="margin:2em; background-color:#e9e9e9;">
<table cellpadding="0" cellspacing="2" style="margin: 6px; background-color:#e9e9e9;">
<tr><td>[[Perl_lib/|perl_lib]]</td>
<td>[[Image:jobbra.png|->]]</td>
<td colspan="10">[perl routines]</td></tr>
<tr><td>[[Bin/|bin]]</td>
<td>[[Image:jobbra.png|->]]</td>
<td colspan="10">[command line and crontab tools]</td></tr>
<tr><td>[[Cgi/|cgi]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[dynamic (cgi) EPrints web pages]</td></tr>
<tr><td>[[Cfg/|cfg]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[apache configuration for the whole site]</td></tr>
<tr><td>[[Testdata/|testdata]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[tools and sample test data]</td></tr>
<tr><td>[[Tests/|tests]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[unit tests]</td></tr>
<tr><td>[[Tools/|tools]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[command line tools]</td></tr>
<tr><td>[[Var/|var]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[apache include files plus indexer log]</td></tr>
<tr><td>[[Site_lib/|site_lib]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[for customized system [[Lib/|lib]] files or [[sitewide configuration]] concurrent to [[Archives/ARCHIVEID/cfg/|archives/ARCHIVEID/cfg]]]</td></tr>
<tr><td>[[Lib/|lib]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/cfg.d/|cfg.d]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[core config files]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/citations/|citations]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="4">[how to render data objects]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/defaultcfg_zero/|defaultcfg_zero]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[the content of archives/ID/cfg/ is copied from here]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/lang/|lang]]</td>
<td>[[Image:jobbra.png]]</td>
<td>XX (langid)</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/lang/en/phrases/|phrases]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[system-wide phrases]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/lang/en/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[web pages and icons]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/namedsets/|namedsets]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[options for namedset fields]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>plugins</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[extra EPrints plugins]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[files to be copied to the html directory]</td>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/syscfg.d/|syscfg.d]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[system config files]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[web page templates]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png|"->"]]</td>
<td>[[Lib/themes/|themes]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/|example]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/|lang]]</td>
<td>[[Image:jobbra.png]]</td>
<td>XX (langid)</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/en/phrases/|phrases]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme phrases]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/en/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme language-specific pages]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/en/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme language-specific templates]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme CSS and images]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme templates]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/workflows/|workflows]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="4">[workflows for data objects]</td>
</tr>
<tr><td>[[Flavours/|flavours]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Flavours/pub_lib/|pub_lib]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[see [[EPrints Flavours|3.4+ publication flavour]]]</td>
</tr>
<tr><td>[[Ingredients/|ingredients]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[see [[EPrints Ingredients|3.4+ ingredients]]]</td>
</tr>
<tr><td>[[Archives/|archives]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/|ARCHIVEID]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[see below]</td>
</tr>
</table>
</div>

The content of the "archives/[ArchiveID]/" directory. Any change you make here has effect on the particular repository only.

<div style="margin:2em; background-color:#e9e9e9;">
<table cellpadding="0" cellspacing="2" style="margin: 6px; background-color:#e9e9e9;">
<tr><td>[[Archives/ARCHIVEID/documents/|documents]] </td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[uploaded files, extracted words, abstract pages, etc.]</td>
</tr>
<tr><td>[[Archives/ARCHIVEID/html/|html]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[static files for the repository on all languages]</td>
</tr>
<tr><td>[[Archives/ARCHIVEID/var/|var]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[various repository dependent files]</td>
</tr>
<tr><td>[[Archives/ARCHIVEID/cfg/|cfg]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">subjects [used for importing the subject tree]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/images/|images]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="3">[files to be copied to the html directory]</td>
</tr>
<tr><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/javascript/|javascript]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="3">[files to be copied to the html directory]</td>
</tr>
<tr><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/style/|style]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="3">[files to be copied to the html directory]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/cfg.d/|cfg.d]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="5">[general configuration files as perl script fragments]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/autocomplete/|autocomplete]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="5">[data files for the autocompletion feature]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/citations/|citations]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[directories for citations for different data objects]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/namedsets/|namedsets]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="5">[files containing the possible values for different sets]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/workflows/|workflows]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[directories for workflows for different data objects]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/|lang]]</td>
<td>[[Image:jobbra.png]]</td>
<td>XX (langid)</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/en/phrases/|phrases]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[phrases used locally]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/en/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[templates for static html pages]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/en/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[default html page template]</td>
</tr>
</table>
</div>

Site lib/

2026-10-09T17:33:21Z

Drn@ecs.soton.ac.uk: Added site_lib/ page

{{dirs}}

'''site_lib/''' does not exist by default but is a special directory which allows direct overriding of Perl modules under [[Perl_lib/|perl_lib/]] and well as adding code and configuration in much the same way files are added to [[Lib/lib/]], using the same path. E.g. if you had created a file under lib/cfg.d/my_config.pl, if you created another config file under site_lib/cfg.d/my_config.pl this latter file would load in place of the former.

EPrints Directory Structure Tree

2026-10-09T17:27:31Z

Drn@ecs.soton.ac.uk: Updated page to use new paths

{{dirs}}

A graphical representation of the [[EPrints Directory Structure|EPrints3 directory structure]] after executing the install.pl command. Initially the <tt>archives</tt> directory is empty, it is populated when executing (as the <tt>eprints</tt> user) the <code>bin/epadmin create</code> command. The new repository is created using the data in the [[lib/defaultcfg_zero/]] directory if not using an [[EPrints Flavours|flavour]] or [[flavours/pub_lib/defaultcfg/|flavours/FLAVOUR/defaultcfg/]] if you are.

<div style="margin:2em; background-color:#e9e9e9;">
<table cellpadding="0" cellspacing="2" style="margin: 6px; background-color:#e9e9e9;">
<tr><td>[[Perl_lib/|perl_lib]]</td>
<td>[[Image:jobbra.png|->]]</td>
<td colspan="10">[perl routines]</td></tr>
<tr><td>[[Bin/|bin]]</td>
<td>[[Image:jobbra.png|->]]</td>
<td colspan="10">[command line and crontab tools]</td></tr>
<tr><td>[[Cgi/|cgi]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[dynamic (cgi) EPrints web pages]</td></tr>
<tr><td>[[Cfg/|cfg]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[apache configuration for the whole site]</td></tr>
<tr><td>[[Testdata/|testdata]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[tools and sample test data]</td></tr>
<tr><td>[[Tests/|tests]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[unit tests]</td></tr>
<tr><td>[[Tools/|tools]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[command line tools]</td></tr>
<tr><td>[[Var/|var]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[apache include files plus indexer log]</td></tr>
<tr><td>[[Lib/|site_lib]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="10">[for customized system [[Lib/|lib]] files or [[sitewide configuration]] concurrent to [[Archives/ARCHIVEID/cfg/|archives/ARCHIVEID/cfg]]]</td></tr>
<tr><td>[[Lib/|lib]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/cfg.d/|cfg.d]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[core config files]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/citations/|citations]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="4">[how to render data objects]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/defaultcfg_zero/|defaultcfg_zero]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[the content of archives/ID/cfg/ is copied from here]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/lang/|lang]]</td>
<td>[[Image:jobbra.png]]</td>
<td>XX (langid)</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/lang/en/phrases/|phrases]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[system-wide phrases]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/lang/en/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[web pages and icons]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/namedsets/|namedsets]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[options for namedset fields]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>plugins</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[extra EPrints plugins]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[files to be copied to the html directory]</td>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/syscfg.d/|syscfg.d]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[system config files]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[web page templates]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png|"->"]]</td>
<td>[[Lib/themes/|themes]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/|example]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/|lang]]</td>
<td>[[Image:jobbra.png]]</td>
<td>XX (langid)</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/en/phrases/|phrases]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme phrases]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/en/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme language-specific pages]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/lang/en/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme language-specific templates]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme CSS and images]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/themes/example/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[theme templates]</td>
</tr>
<tr><td></td><td>[[Image:jobbra.png]]</td>
<td>[[Lib/workflows/|workflows]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="4">[workflows for data objects]</td>
</tr>
<tr><td>[[Flavours/|flavours]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Flavours/pub_lib/|pub_lib]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[see [[EPrints Flavours|3.4+ publication flavour]]]</td>
</tr>
<tr><td>[[Ingredients/|ingredients]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[see [[EPrints Ingredients|3.4+ ingredients]]]</td>
</tr>
<tr><td>[[Archives/|archives]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/|ARCHIVEID]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[see below]</td>
</tr>
</table>
</div>

The content of the "archives/[ArchiveID]/" directory. Any change you make here has effect on the particular repository only.

<div style="margin:2em; background-color:#e9e9e9;">
<table cellpadding="0" cellspacing="2" style="margin: 6px; background-color:#e9e9e9;">
<tr><td>[[Archives/ARCHIVEID/documents/|documents]] </td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[uploaded files, extracted words, abstract pages, etc.]</td>
</tr>
<tr><td>[[Archives/ARCHIVEID/html/|html]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[static files for the repository on all languages]</td>
</tr>
<tr><td>[[Archives/ARCHIVEID/var/|var]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">[various repository dependent files]</td>
</tr>
<tr><td>[[Archives/ARCHIVEID/cfg/|cfg]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="7">subjects [used for importing the subject tree]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/images/|images]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="3">[files to be copied to the html directory]</td>
</tr>
<tr><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/javascript/|javascript]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="3">[files to be copied to the html directory]</td>
</tr>
<tr><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/static/style/|style]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="3">[files to be copied to the html directory]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/cfg.d/|cfg.d]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="5">[general configuration files as perl script fragments]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/autocomplete/|autocomplete]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="5">[data files for the autocompletion feature]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/citations/|citations]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[directories for citations for different data objects]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/namedsets/|namedsets]]</td>
<td>[[Image:jobbra.png]]</td>
<td colspan="5">[files containing the possible values for different sets]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/workflows/|workflows]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[directories for workflows for different data objects]</td>
</tr>
<tr><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/|lang]]</td>
<td>[[Image:jobbra.png]]</td>
<td>XX (langid)</td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/en/phrases/|phrases]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[phrases used locally]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/en/static/|static]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[templates for static html pages]</td>
</tr>
<tr><td></td><td></td><td></td><td></td><td></td>
<td>[[Image:jobbra.png]]</td>
<td>[[Archives/ARCHIVEID/cfg/lang/en/templates/|templates]]</td>
<td>[[Image:jobbra.png]]</td>
<td>[default html page template]</td>
</tr>
</table>
</div>

Archives/

2026-10-09T17:26:20Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Eprints3/archives/ to Archives/: More appropriate location

{{dirs}}

This directory contains one directory per repository. The name of the directory is the ID of the repository.

To see the filesystem inside an archive, follow ARCHIVEID.

*'''[[EPrints_Directory_Structure_Tree|eprints3]]/archives'''
** '''[[Archives/ARCHIVEID/|ARCHIVEID/]]''' - config. and data for repository ARCHIVEID
** '''foo/''' - config. and data for repository foo
** '''bar/''' - config. and data for repository bar

Eprints3/archives/

2026-10-09T17:26:20Z

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Eprints3/archives/ to Archives/: More appropriate location

#REDIRECT [[Archives/]]

Archives/

2026-10-09T17:25:30Z

Drn@ecs.soton.ac.uk: Updated page to use new paths