Skip to main content
Version: 3.3.x

🐧Linux Installation Guide

This guide covers the installation of ABCD 3.4+ on Ubuntu/Debian systems using the official release packages.

1. Install System Dependencies​

Update your repositories and install Apache, PHP 8.x, and necessary tools.

sudo apt update
sudo apt install apache2 unzip wget php php-mbstring php-gd php-curl php-xml php-zip libapache2-mod-php

Enable Apache Modules​

ABCD requires the CGI module (to run CISIS scripts) and the Rewrite module (for friendly URLs) to be active.

sudo a2enmod cgi rewrite
sudo systemctl restart apache2

2. Download ABCD​

We recommend downloading the latest stable release instead of cloning the development repository.

  1. Visit the ABCD Releases Page.
  2. Copy the link for the latest .zip or .tar.gz file (e.g., v3.4.0-beta.zip).
  3. In your terminal, download and extract it (assuming /var/www/html/ABCD as destination):
cd /var/www/html
  • Example download (always check the GitHub link for the latest version)
sudo wget [https://github.com/ABCD-DEVCOM/ABCD/archive/refs/tags/v3.4.0.zip](https://github.com/ABCD-DEVCOM/ABCD/archive/refs/tags/v3.4.0.zip) -O abcd.zip
  • Extract
sudo unzip abcd.zip

Rename the extracted folder to 'ABCD' (or your preferred name)

sudo mv ABCD-3.4.0  ABCD

3. Cleanup Directory Structure​

The package contains folders for multiple operating systems. Clean up what is not used:

  1. CGI-BIN: Check the folder structure. If you see cgi-bin_Linux and cgi-bin_Windows:
  • Rename cgi-bin_Linux to cgi-bin.
cd /var/www/html/ABCD/www
sudo mv cgi-bin_Linux cgi-bin
  • Delete cgi-bin_Windows.
sudo rm -rf cgi-bin_Windows
  1. Bases: If this is a clean installation, rename bases-examples to bases.
sudo mv bases-examples_Linux bases

4. Initial Configuration (Crucial)​

ABCD comes with a template configuration file that must be activated.

  1. Navigate to the central configuration folder:
cd /var/www/html/ABCD/www/htdocs/central/
  1. Copy the template to the actual config file:
sudo cp config.php.template config.php
  1. (Optional) Edit config.php if you need to change default paths, although the defaults usually work fine if following this guide.

5. Configure Permissions​

For ABCD to work (save records, upload images), permissions must be exact. 👉 See the Folder Permissions Guide.

6. Enable Executables​

Ensure the CISIS binaries have execution rights:

sudo chmod +x /var/www/html/ABCD/www/cgi-bin/*

7. Next Steps​

  • Configure the Virtual Host (see sidebar).
  • Access http://localhost:9090/admin (or your server IP).

8. Troubleshooting​

OPAC Search Results Not Displaying (Redirecting to Homepage)​

If you can access the OPAC but performing a search redirects you back to the home page instead of displaying the results, your Apache server is likely ignoring the .htaccess file. The URL rewriting required by the OPAC will fail without it.

To fix this, especially on Ubuntu/Debian systems, you need to allow .htaccess overrides in your Apache configuration:

  1. Open your main Apache configuration file:
sudo nano /etc/apache2/apache2.conf

  1. Scroll down to locate the <Directory /var/www/> block.

  2. Change the AllowOverride None directive to AllowOverride All:

<Directory /var/www/>
	Options Indexes FollowSymLinks
	AllowOverride All
	Require all granted
</Directory>
  1. Save the file and restart Apache to apply the changes:
sudo systemctl restart apache2