mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

adding documentation

Browse Source
This commit is contained in:
Michael Newton
2015-08-10 10:43:11 -07:00
parent 8cf23acdba
commit aa57c952f9
1 changed files with 22 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/Extensions/Sub-Directory.md Normal file
View File

@ -0,0 +1,22 @@
To run LibreNMS under a subdirectory on your Apache server, the directives for the LibreNMS directory are placed in the base server configuration, or in a virtual host
container of your choosing. If using a virtual host, place the directives in the file where the virtual host is configured. If using the base server on RHEL distributions
(CentOS, Scientific Linux, etc.) the directives can be placed in `/etc/httpd/conf.d/librenms.conf`. For Debian distributions (Ubuntu, etc.) place the directives in
`/etc/apache2/sites-available/default`.
```apache
#This directive is never put inside a virtual host
AllowEncodedSlashes On
#These directives can be inside a virtual host or in the base server configuration
Alias /librenms /opt/librenms/html
<Directory "/opt/librenms/html">
AllowOverride All
Options FollowSymLinks MultiViews
</Directory>
```
The `RewriteBase` directive in `html/.htaccess` must be rewritten to reference the subdirectory name. Assuming LibreNMS is running at http://example.com/librenms/,
you will need to change `RewriteBase /` to `RewriteBase /librenms`.
Finally, ensure `$config["base_url"]` -- if configured -- is correct as well.