About Features Downloads Getting Started Documentation Events Support GitHub

Site Tools

Warning: This page has not been updated in over over a year and may be outdated or deprecated.

Using VuFind as the Site Root

By default, VuFind is configured to reside within a directory of your website. However, if you want to configure VuFind to load at the root of your domain, follow these steps:

  1. In the $VUFIND_HOME directory, run “php install.php” and run through the installer's questions. Use “/” as the path, and answer the other questions the same as before (use defaults if you are unsure). This will rewrite VuFind's Apache configuration file, and after you restart the Apache service, the changes should take effect. The install.php script will make a backup of your previous configuration (in $VUFIND_LOCAL_DIR, with a date/time-based file extension), so if you need to revert your changes, or if you wish to compare the new configuration against the old one to be sure you answered all the questions correctly, you can easily do so.
  2. In the [Site] section of $VUFIND_LOCAL_DIR/config/vufind/config.ini, set the “url” setting to “http://yourdomain.edu” (obviously replacing this with your real domain name).
  3. You may need to create an Apache VirtualHost for the host used by VuFind in your Apache configuration, or if you already have one, you may need to explicitly set the DocumentRoot to $VUFIND_HOME/public to ensure that Apache loads the appropriate content at the site root. You may wish to add this to the $VUFIND_LOCAL_DIR/httpd-vufind.conf file created by VuFind's installer, or you could create it in a different Apache config file, depending on how you prefer to manage your configurations. The configuration you add should resemble this example:
<VirtualHost *:80>
    DocumentRoot /usr/local/vufind/public
    ServerName yourdomain.edu
    ServerAlias www.yourdomain.edu
configuration/using_vufind_as_the_site_root.txt · Last modified: 2020/02/24 14:14 by demiankatz