Editing Installing EPrints on Debian/Ubuntu (section)

== Requirements ==
* Ubuntu 22.04 LTS and Ubuntu 24.04 LTS (non-LTS versions not recommended)
* Debian 11 (Bullseye), Debian 12 (Bookworm) or Debian 13 (Trixie) - These are not as comprehensively tested as Ubuntu LTS versions.

=== Dependencies and Pre-configuration ===
'''The ideal way to install from source is via git using the Core Git repositories [https://github.com/eprints/eprints3.4 EPrints 3.4] or [https://github.com/eprints/eprints EPrints 3.3], and installing from a source tarball is generally discouraged.'''

'''Installing from source via git is now the recommended  way to install EPrints for production repositories, after having proved to be a useful installation method to those seeking to develop the EPrints code, develop a plugin or develop a Bazaar package too.'''

First, as the root user install all the dependencies for EPrints ('''N.B.''' Some dependencies may not be able in certain versions of Debian/Ubuntu.  See [[#Operating System Version Specific Requirements|Operating System Version Specific Requirements]] towards the end of this page):

 apt install perl libncurses6 libselinux1 apache2 libapache2-mod-perl2 libxml-libxml-perl \
   libunicode-string-perl libterm-readkey-perl libmime-lite-perl libmime-types-perl libdigest-sha-perl \
   libdbd-mysql-perl libxml-parser-perl libxml2-dev libxml-twig-perl libarchive-any-perl libjson-perl \
   liblwp-protocol-https-perl libtext-unidecode-perl lynx wget ghostscript poppler-utils antiword elinks \
   texlive-base texlive-binaries psutils imagemagick adduser tar gzip unzip libsearch-xapian-perl \
   libtex-encode-perl libio-string-perl python3-html2text make libexpat1-dev libxslt1-dev

If you are installing on Ubuntu, install MySQL server and client:

  apt install mysql-server mysql-client libmysqlclient-dev

If you are installing on Debian, install MariaDB server and client:

  apt install mariadb-server mariadb-client libmariadb-dev

Next, create the eprints user

 adduser eprints

Now add the eprints user to the www-data group and vice-versa

 usermod -a -G eprints www-data
 usermod -a -G www-data eprints

=== Downloading and Deploying EPrints Source ===

==== Create initial directory with correct permissions ====
As root:
 mkdir /opt/eprints3
 chown eprints:eprints /opt/eprints3
 chmod 2775 /opt/eprints3

==== Cloning from Git ====

 apt install git
 su eprints
 git clone https://github.com/eprints/eprints3.4.git /opt/eprints3
 cd /opt/eprints3/
 git checkout tags/v3.4.7