Skip to main content

New Installation Method


This installation method is based on a virtual machine instance. Not a container based instance. The best practice is using a Proxmox VM or get a bare metal server.


Tested on version 7.1 - 8.1.1


Check our VuFind installation at

Install Operating System

You can choose whatever OS you like, but Debian based OS server is a good to go. I use Debian 10 Bullseye. I recomend to use a LTS version.

Update and Upgrade the System

Do a full update and upgrade your Linux machine server.

sudo apt update && sudo apt dist-upgrade

Install Database Server

You can choose whatever database server, but I choose MySQL beacuse it just works like a charm.

sudo apt -y install mysql-server

Install PHP and Apache Web Server

Since most of VuFind is written using the PHP language, we need to install PHP and using Apache web server to get things done right.

sudo apt install php libapache2-mod-php

Once the installation is complete, restart Apache to load the PHP module:

sudo systemctl restart apache2

Be sure to enable modules for key technologies used by VuFind (MySQL, LDAP, etc.)

sudo apt -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 the Java JDK

sudo apt -y install default-jdk

Download and Install VuFind


*always check their GitHub for new version

sudo dpkg -i vufind_8.1.1.deb

This is an optional step, when you get error installing .deb package

sudo apt install -f

Reboot machine

sudo reboot now

Disable MySQL root auth_socket plugin to prevent regular login.

sudo mysql -uroot
UPDATE mysql.user SET plugin='mysql_native_password' WHERE User='root'; FLUSH PRIVILEGES;

Quit MySQL and setup root password

sudo /usr/bin/mysql_secure_installation

Increase Security Limit for your current username

nano /etc/security/limits.conf

Paste these lines of code at the very bottom and save. You should logout and login again. In this case, i just reboot the machine.

username         soft    nproc           65000
username         soft    nofile          65000
username         hard    nproc           65000
username         hard    nofile          65000

In this case, my username was geohot

geohot soft nproc 65000
geohot soft nofile 65000
geohot hard nproc 65000
geohot hard nofile 65000

Start the Solr

Go to VuFind directory

cd /usr/local/vufind


./ start