EPrints 3.5.0 Beta 1

This page provides information about the first beta release for EPrints 3.5.0 on Wednesday 18th June 2025. There will be further beta releases and one or more release candidates before the first official release of EPrints 3.5.0.

Installation Instructions

RHEL / Rocky Linux 9

1. Install MariaDB (you may choose to install MySQL instead).

yum install mariadb-server mariadb mariadb-devel

2. Enable MariaDB

systemctl enable --now mariadb

3. Install prerequite packages and tools. (Some extra packages may be required to build CPAN packages later on).

yum install epel-release git libxml2 libxslt httpd mod_perl perl-DBD-MySQL tetex-latex wget gzip tar ImageMagick elinks poppler-utils chkconfig unzip cpan python3-html2text expat-devel libxslt-devel xapian-core xapian-core-devel

4. Add the eprints user

adduser eprints

5. Add the eprints user to the apache group and vice-versa

usermod -a -G eprints apache
usermod -a -G apache eprints

6. For now disable SELinux. (If you want to make this permanent you will need to configure /etc/selinux/config and change SELINUX=permissive). An SELinux policy for EPrints will be provided with the full release of EPrints 3.5.0.

setenforce 0

7. Make a directory to checkout EPrints and set appropriate permissions:

mkdir /opt/eprints3
chown eprints:eprints /opt/eprints3
chmod 2775 /opt/eprints3

8. Become the eprints user and clone EPrints 3.5 recursively and checkout v3.5.0-beta-1

su eprints
cd /opt/eprints3
git clone https://github.com/eprints/eprints3.5.git --recurse-submodules .
git checkout v3.5.0-beta-1

9. Become the root user again and install CPAN modules. (Answer 'y' if prompted whilst running cpan_modules.pl).

su root
/opt/eprints3/cpan_modules.pl

10. Be sure to either set a password for the MariaDB root user or create another user (e.g. eprints) that can create new databases and add new MariaDB users

mysql
CREATE USER 'eprints'@'localhost' IDENTIFIED by '<CHANGE_ME>';
GRANT ALL PRIVILEGES ON *.* TO 'eprints'@'localhost' WITH GRANT OPTION;

11. Become the eprints user again and create your new EPrints archive using the 'pub' flavour and then follow the interactive instructions.

su eprints
/opt/eprints3/bin/epadmin create

12. Become the root user and create an Apache configuration file at /etc/httpd/conf.d/eprints.conf with the following line:

Include /opt/eprints3/cfg/apache.conf

13. For now, disable /etc/httpd/conf.d/ssl.conf

mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.disabled

14. Test and start Apache.

apachectl configtest
systemctl enable --now httpd

Deploying HTTPS using Let's Encrypt

TO BE WRITTEN