VirtualHost Directive

Top - Docs - General - Server - Resource - Access - FAQ - Tutorials

Purpose

This directive allows you to customize the server to respond to different IP addresses in different ways. See the tutorial for more information.

Syntax

<VirtualHost servername errorlevel>
...
</VirtualHost>

Where :

servername
This is the DNS name or IP address of this virtual host. The DNS name should map to a single IP address.
errorlevel
This can be either Required or Optional. If set to Required, any misconfiguration or problem will cause the server start to fail. If this is set to Optional, the server will attempt to continue even if the configuration is invalid. This is an optional parameter, and if left off, the server will default to Required.
...
This can be any number of Server directives, including the SRMOptions directive which allows Resource directives in the server configuration file.

Virtual Host

You cannot use VirtualHost directives within VirtualHost directives. You can use as many VirtualHost directives as you like, up to the limits of your servers memory and operating system.

Examples

<VirtualHost www.uiuc.net>
ServerName www.uiuc.net
ServerAdmin blong@uiuc.net
DocumentRoot /www
</VirtualHost>

<VirtualHost 127.0.0.1 Required>
        ServerName localhost
        ServerAdmin yow@wow.net
        <SRMOptions>
                DocumentRoot /www/local
                Alias /icons/ /usr/local/etc/httpd/icons/
                ScriptAlias /cgi-bin/ /usr/local/etc/httpd/cgi-local/
                # Local can use internal imagemap
                AddType text/x-imagemap .map
                AddType application/x-httpd-cgi .cgi
        </SRMOptions>
</VirtualHost>

Return to Configuration File Overview

NCSA HTTPd Development Team / httpd@ncsa.uiuc.edu / 10-02-95