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:
- 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.
- 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).
- 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 </VirtualHost>
configuration/using_vufind_as_the_site_root.txt · Last modified: 2020/02/24 14:14 by demiankatz