Self-host i-librarian-free

Prepare permanent storage directory

mkdir -p /var/www/i-librarian-free/library/data
chown -R 33:33 /var/www/i-librarian-free/library/data

User 33:33 is the user/group ID (UID/GID) that I, Librarian runs as. In an unlikely case of a conflict, you can set the directory permissions to 0777 instead.

Prepare config file

mkdir -p /var/www/i-librarian-free/library/config
tar xf I-Librarian-5.11.3-Linux.tar.xz config/ilibrarian-default.ini --strip-components=1
mv ilibrarian-default.ini /var/www/i-librarian-free/library/config/ilibrarian.ini

Build an image

docker build -t i-librarian-free:5.11.3 - < I-Librarian-5.11.3-Linux.tar.xz

Run container

docker run -d --name il-free -p 127.0.0.1:9050:80 -v /var/www/i-librarian-free/library/data:/i-librarian/data \
  -v /var/www/i-librarian-free/library/config:/i-librarian/config i-librarian-free:5.11.3

services:
  il-free:
    image: i-librarian-free:5.11.3
    container_name: il-free
    restart: always
    ports:
      - "127.0.0.1:9050:80"
    volumes:
      - type: bind
        source: /var/www/i-librarian-free/library/data
        target: /i-librarian/data
      - type: bind
        source: /var/www/i-librarian-free/library/config
        target: /i-librarian/config
        read_only: true

docker compose up -d

1. If you did not use the DEB package, make sure you have installed these packages from repositories:

• Either of these web servers is recommended (you may run I, Librarian with any web server)
  • apache2 (may be named httpd)
  • nginx
• PHP (I, Librarian requires PHP 7.2+)
  • For Apache, php and libapache2-mod-php
  • For Nginx, php-fpm is recommended.
• PHP Extensions
  • php-sqlite3: SQLite database for PHP.
  • php-gd, php-curl, php-intl, php-xml, php-json, php-mbstring, php-zip: Other required PHP extensions.
  • php-ldap: Required if using LDAP.
  • php-sodium: Encryption related requirement
• External Utilities
  • poppler-utils: required for PDF indexing and for the built-in PDF viewer.
  • ghostscript: required for the built-in PDF viewer.
  • tesseract-ocr: optional OCR.
  • libreoffice: optional import of office files.

2. If you are installing from the tar.xz, login as root or use sudo, and extract files into a directory outside the web server's root directory (e.g. /var/www/librarian). Example:

  tar -Jxf I-Librarian-*.tar.xz -C /var/www/librarian

3. Change the owner of the data sub-folder to the account that runs the web server. For Apache, this is usually www-data and for Nginx, nobody. Example:

  chown -R www-data:www-data /var/www/librarian/data

4. Configure the web server appropriately (Apache or Nginx configuration examples provided).

• A running Apache 2.4+ and PHP 8+ are required. Install them using a Windows installer like WAMP.
• Edit Apache configuration file (httpd.conf). Append this at the end using Notepad and edit as needed:

Alias /librarian "C:\I, Librarian\public"
<Directory "C:\I, Librarian\public">
    AllowOverride All
    # Allow access from this computer.
    Require local
    # Allow access from intranet computers.
    Require ip 10
    Require ip 172.16 172.17 172.18 172.19 172.20
    Require ip 172.21 172.22 172.23 172.24 172.25
    Require ip 172.26 172.27 172.28 172.29 172.30 172.31
    Require ip 192.168
    # Insert Allow from directives here to allow access from the internet.
    # "Require all granted" opens access to everybody.
</Directory>

• Restart the server.
• Unzip I, Librarian distributable files into C:\I, Librarian.
• Now you can access your library in a browser at http://127.0.0.1/librarian

It is HIGHLY recommended that you use the package managers Homebrew or MacPorts to enable the use of UNIX based software on your Mac. A Linux-like environment will be setup and the latest versions of the required software (web servers, PHP 7.2+, PHP extensions) can be easily downloaded and automatically compiled when/if necessary. The Linux instructions can then be followed with paths modified as needed (Standard Macport installations live at /opt/local (e.g. /opt/local/var/www, not /var/www) while Brew lives at /usr/local ).

If you want a standalone installation, you will need to have an Apache + PHP stack installed. Details may vary depending on which PHP stack you are using. Two options are MAMP and XAMPP but they come with MySQL as well. To configure these installations, the Linux instructions can be followed. But missing PHP extensions will need to be downloaded (or compiled, like Sodium). Source for Sodium can be found at PECL.