Skip to main content

Installation Process

Update & Upgrade server OS

sudo apt update
sudo apt dist-upgrade

Reboot System

sudo shutdown -r now

Install Apache

sudo apt-get -y install apache2
sudo a2enmod rewrite
sudo /etc/init.d/apache2 force-reload

Install MySQL / MariaDB

sudo apt -y install mysql-server


sudo apt -y install mariadb-server

Install PHP

sudo apt-get -y install libapache2-mod-php php-mbstring php-pear php php-dev php-gd php-intl php-json php-ldap php-mysql php-xml php-soap php-curl

Install Java JDK / OpenJDK

sudo apt-get -y install default-jdk


sudo apt install openjdk-17-jdk
sudo rm /usr/lib/jvm/default-java
sudo ln -s /usr/lib/jvm/java-17-openjdk-amd64 /usr/lib/jvm/default-java

Download VuFind master

cd /tmp
tar -xzvf vufind-8.0.4.tar.gz
sudo mv vufind-8.0.4 /usr/local/vufind

Install VuFind

cd /usr/local/vufind
php install.php
set some permissions to allow Apache to write configuration and cache files to disk
sudo chown -R www-data:www-data /usr/local/vufind/local/cache
sudo chown -R www-data:www-data /usr/local/vufind/local/config
install VuFind's command line tools, also need a separate cache
sudo mkdir /usr/local/vufind/local/cache/cli
sudo chmod 777 /usr/local/vufind/local/cache/cli
sudo ln -s /usr/local/vufind/local/httpd-vufind.conf /etc/apache2/conf-enabled/vufind.conf
Apache needs to be restarted
sudo /etc/init.d/apache2 reload

Setup Environment Variable

sudo sh -c 'echo export JAVA_HOME=\"/usr/lib/jvm/default-java\" > /etc/profile.d/'
sudo sh -c 'echo export VUFIND_HOME=\"/usr/local/vufind\" >> /etc/profile.d/'
sudo sh -c 'echo export VUFIND_LOCAL_DIR=\"/usr/local/vufind/local\" >> /etc/profile.d/'
Load configuration
source /etc/profile.d/

Create VuFind user

sudo adduser vufind -y
sudo usermod -aG sudo vufind

Set Limit Performance

nano /etc/security/limits.conf
add these lines to limits.conf
vufind soft nproc 65000
vufind soft nofile 65000
vufind hard nproc 65000
vufind hard nofile 65000

Log Out

Log In with vufind user

Starting Solr Service

cd /usr/local/vufind/
chmod +x
./ start