About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools


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

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
configuration:using_vufind_as_the_site_root [2020/02/24 14:09] – [Using VuFind as the Site Root] demiankatzconfiguration:using_vufind_as_the_site_root [2020/02/24 14:14] (current) demiankatz
Line 3: Line 3:
 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: 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 [Site] section of local/config/vufind/config.ini, set the “url” setting to “http://yourdomain.edu” (obviously replacing this with your real domain name). +  - 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 httpd-vufind.confmake the following changes: +  - 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). 
-    * In the AliasMatch lines at the top, change "AliasMatch ^/vufind2/themes/..." to "AliasMatch ^/themes/..." +  - You may need to create an Apache VirtualHost for the host used by VuFind in your Apache configurationor 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 rootYou may wish to add this to the $VUFIND_LOCAL_DIR/httpd-vufind.conf file created by VuFind's installeror you could create it in a different Apache config filedepending on how you prefer to manage your configurations. The configuration you add should resemble this example:
-    * Remove the Alias line under "Configuration for general VuFind base"+
-    * In VuFind 2.5 and earlierRewriteBase should be /; in later versions which use <Location> directive instead of a RewriteBase, this should read <Location />.+
  
-    * You may need to create a virtual host in Apache to complement httpd-vufind.conf which uses your VuFind public directory as its DocumentRoot. For example: 
 <code> <code>
 <VirtualHost *:80> <VirtualHost *:80>
Line 18: Line 15:
 </code> </code>
  
-===== ...if you have already installed VuFind ===== 
- 
-Even if you have already installed VuFind, you should be able to change it to run as the site root fairly easily. Just 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. 
-  - As noted above, you should update the url setting in the [Site] section of your local config.ini file. 
-  - As noted above, you may need to create an Apache VirtualHost for VuFind, 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. 
 ---- struct data ---- ---- struct data ----
 +properties.Page Owner : 
 ---- ----
  
configuration/using_vufind_as_the_site_root.txt · Last modified: 2020/02/24 14:14 by demiankatz