1<url: docs-2.0="" http:="" httpd.apache.org=""> for detailed information about   
   2  
   3# the directives.   
   4  
   5#   
   6  
   7# Do NOT simply read the instructions in here without understanding   
   8  
   9# what they do. They're here only as hints or reminders. If you are unsure   
  10  
  11# consult the online docs. You have been warned.   
  12  
  13#   
  14  
  15# The configuration directives are grouped into three basic sections:   
  16  
  17# 1. Directives that control the operation of the Apache server process as a   
  18  
  19# whole (the 'global environment').   
  20  
  21# 2. Directives that define the parameters of the 'main' or 'default' server,   
  22  
  23# which responds to requests that aren't handled by a virtual host.   
  24  
  25# These directives also provide default values for the settings   
  26  
  27# of all virtual hosts.   
  28  
  29# 3. Settings for virtual hosts, which allow Web requests to be sent to   
  30  
  31# different IP addresses or hostnames and have them handled by the   
  32  
  33# same Apache server process.   
  34  
  35#   
  36  
  37# Configuration and logfile names: If the filenames you specify for many   
  38  
  39# of the server's control files begin with "/" (or "drive:/" for Win32), the   
  40  
  41# server will use that explicit path. If the filenames do *not* begin   
  42  
  43# with "/", the value of ServerRoot is prepended -- so "logs/foo.log"   
  44  
  45# with ServerRoot set to "/server/apache" will be interpreted by the   
  46  
  47# server as "/server/apache/logs/foo.log".   
  48  
  49#   
  50  
  51  
  52  
  53### Section 1: Global Environment   
  54  
  55#   
  56  
  57# The directives in this section affect the overall operation of Apache,   
  58  
  59# such as the number of concurrent requests it can handle or where it   
  60  
  61# can find its configuration files.   
  62  
  63#   
  64  
  65  
  66  
  67#   
  68  
  69# ServerRoot: The top of the directory tree under which the server's   
  70  
  71# configuration, error, and log files are kept.   
  72  
  73#   
  74  
  75# NOTE! If you intend to place this on an NFS (or otherwise network)   
  76  
  77# mounted filesystem then please read the LockFile documentation (available   
  78  
  79# at <url: docs-2.0="" http:="" httpd.apache.org="" mo...n.html#lockfile=""> );   
  80  
  81# you will save yourself a lot of trouble.   
  82  
  83#   
  84  
  85# Do NOT add a slash at the end of the directory path.   
  86  
  87#   
  88  
  89ServerRoot "/server/apache"   
  90  
  91  
  92  
  93#   
  94  
  95# The accept serialization lock file MUST BE STORED ON A LOCAL DISK.   
  96  
  97#   
  98  
  99<ifmodule !mpm_winnt.c="">
 100<ifmodule !mpm_netware.c="">   
 101  
 102#LockFile logs/accept.lock   
 103  
 104</ifmodule>
 105</ifmodule>   
 106  
 107  
 108  
 109#   
 110  
 111# ScoreBoardFile: File used to store internal server process information.   
 112  
 113# If unspecified (the default), the scoreboard will be stored in an   
 114  
 115# anonymous shared memory segment, and will be unavailable to third-party   
 116  
 117# applications.   
 118  
 119# If specified, ensure that no two invocations of Apache share the same   
 120  
 121# scoreboard file. The scoreboard file MUST BE STORED ON A LOCAL DISK.   
 122  
 123#   
 124  
 125<ifmodule !mpm_netware.c="">
 126<ifmodule !perchild.c="">   
 127  
 128#ScoreBoardFile logs/apache_runtime_status   
 129  
 130</ifmodule>
 131</ifmodule>   
 132  
 133  
 134  
 135  
 136  
 137#   
 138  
 139# PidFile: The file in which the server should record its process   
 140  
 141# identification number when it starts.   
 142  
 143#   
 144  
 145<ifmodule !mpm_netware.c="">   
 146  
 147PidFile logs/httpd.pid   
 148  
 149</ifmodule>   
 150  
 151  
 152  
 153#   
 154  
 155# Timeout: The number of seconds before receives and sends time out.   
 156  
 157#   
 158  
 159Timeout 300   
 160  
 161  
 162  
 163#   
 164  
 165# KeepAlive: Whether or not to allow persistent connections (more than   
 166  
 167# one request per connection). Set to "Off" to deactivate.   
 168  
 169#   
 170  
 171KeepAlive On   
 172  
 173  
 174  
 175#   
 176  
 177# MaxKeepAliveRequests: The maximum number of requests to allow   
 178  
 179# during a persistent connection. Set to 0 to allow an unlimited amount.   
 180  
 181# We recommend you leave this number high, for maximum performance.   
 182  
 183#   
 184  
 185MaxKeepAliveRequests 100   
 186  
 187  
 188  
 189#   
 190  
 191# KeepAliveTimeout: Number of seconds to wait for the next request from the   
 192  
 193# same client on the same connection.   
 194  
 195#   
 196  
 197KeepAliveTimeout 15   
 198  
 199  
 200  
 201##   
 202  
 203## Server-Pool Size Regulation (MPM specific)   
 204  
 205##   
 206  
 207  
 208  
 209# prefork MPM   
 210  
 211# StartServers: number of server processes to start   
 212  
 213# MinSpareServers: minimum number of server processes which are kept spare   
 214  
 215# MaxSpareServers: maximum number of server processes which are kept spare   
 216  
 217# MaxClients: maximum number of server processes allowed to start   
 218  
 219# MaxRequestsPerChild: maximum number of requests a server process serves   
 220  
 221<ifmodule prefork.c="">   
 222  
 223StartServers 5   
 224  
 225MinSpareServers 5   
 226  
 227MaxSpareServers 10   
 228  
 229MaxClients 150   
 230  
 231MaxRequestsPerChild 0   
 232  
 233</ifmodule>   
 234  
 235  
 236  
 237# worker MPM   
 238  
 239# StartServers: initial number of server processes to start   
 240  
 241# MaxClients: maximum number of simultaneous client connections   
 242  
 243# MinSpareThreads: minimum number of worker threads which are kept spare   
 244  
 245# MaxSpareThreads: maximum number of worker threads which are kept spare   
 246  
 247# ThreadsPerChild: constant number of worker threads in each server process   
 248  
 249# MaxRequestsPerChild: maximum number of requests a server process serves   
 250  
 251<ifmodule worker.c="">   
 252  
 253StartServers 2   
 254  
 255MaxClients 150   
 256  
 257MinSpareThreads 25   
 258  
 259MaxSpareThreads 75   
 260  
 261ThreadsPerChild 25   
 262  
 263MaxRequestsPerChild 0   
 264  
 265</ifmodule>   
 266  
 267  
 268  
 269# perchild MPM   
 270  
 271# NumServers: constant number of server processes   
 272  
 273# StartThreads: initial number of worker threads in each server process   
 274  
 275# MinSpareThreads: minimum number of worker threads which are kept spare   
 276  
 277# MaxSpareThreads: maximum number of worker threads which are kept spare   
 278  
 279# MaxThreadsPerChild: maximum number of worker threads in each server process   
 280  
 281# MaxRequestsPerChild: maximum number of connections per server process   
 282  
 283<ifmodule perchild.c="">   
 284  
 285NumServers 5   
 286  
 287StartThreads 5   
 288  
 289MinSpareThreads 5   
 290  
 291MaxSpareThreads 10   
 292  
 293MaxThreadsPerChild 20   
 294  
 295MaxRequestsPerChild 0   
 296  
 297</ifmodule>   
 298  
 299  
 300  
 301# WinNT MPM   
 302  
 303# ThreadsPerChild: constant number of worker threads in the server process   
 304  
 305# MaxRequestsPerChild: maximum number of requests a server process serves   
 306  
 307<ifmodule mpm_winnt.c="">   
 308  
 309ThreadsPerChild 250   
 310  
 311MaxRequestsPerChild 0   
 312  
 313</ifmodule>   
 314  
 315  
 316  
 317# BeOS MPM   
 318  
 319# StartThreads: how many threads do we initially spawn?   
 320  
 321# MaxClients: max number of threads we can have (1 thread == 1 client)   
 322  
 323# MaxRequestsPerThread: maximum number of requests each thread will process   
 324  
 325<ifmodule beos.c="">   
 326  
 327StartThreads 10   
 328  
 329MaxClients 50   
 330  
 331MaxRequestsPerThread 10000   
 332  
 333</ifmodule>   
 334  
 335  
 336  
 337# NetWare MPM   
 338  
 339# ThreadStackSize: Stack size allocated for each worker thread   
 340  
 341# StartThreads: Number of worker threads launched at server startup   
 342  
 343# MinSpareThreads: Minimum number of idle threads, to handle request spikes   
 344  
 345# MaxSpareThreads: Maximum number of idle threads   
 346  
 347# MaxThreads: Maximum number of worker threads alive at the same time   
 348  
 349# MaxRequestsPerChild: Maximum number of requests a thread serves. It is   
 350  
 351# recommended that the default value of 0 be set for this   
 352  
 353# directive on NetWare. This will allow the thread to   
 354  
 355# continue to service requests indefinitely.   
 356  
 357<ifmodule mpm_netware.c="">   
 358  
 359ThreadStackSize 65536   
 360  
 361StartThreads 250   
 362  
 363MinSpareThreads 25   
 364  
 365MaxSpareThreads 250   
 366  
 367MaxThreads 1000   
 368  
 369MaxRequestsPerChild 0   
 370  
 371</ifmodule>   
 372  
 373  
 374  
 375# OS/2 MPM   
 376  
 377# StartServers: Number of server processes to maintain   
 378  
 379# MinSpareThreads: Minimum number of idle threads per process,   
 380  
 381# to handle request spikes   
 382  
 383# MaxSpareThreads: Maximum number of idle threads per process   
 384  
 385# MaxRequestsPerChild: Maximum number of connections per server process   
 386  
 387<ifmodule mpmt_os2.c="">   
 388  
 389StartServers 2   
 390  
 391MinSpareThreads 5   
 392  
 393MaxSpareThreads 10   
 394  
 395MaxRequestsPerChild 0   
 396  
 397</ifmodule>   
 398  
 399  
 400  
 401#   
 402  
 403# Listen: Allows you to bind Apache to specific IP addresses and/or   
 404  
 405# ports, instead of the default. See also the <virtualhost>   
 406  
 407# directive.   
 408  
 409#   
 410  
 411# Change this to Listen on specific IP addresses as shown below to   
 412  
 413# prevent Apache from glomming onto all bound IP addresses (0.0.0.0)   
 414  
 415#   
 416  
 417#Listen 12.34.56.78:80   
 418  
 419  
 420  
 421Listen 80   
 422  
 423  
 424  
 425#   
 426  
 427# Dynamic Shared Object (DSO) Support   
 428  
 429#   
 430  
 431# To be able to use the functionality of a module which was built as a DSO you   
 432  
 433# have to place corresponding `LoadModule' lines at this location so the   
 434  
 435# directives contained in it are actually available _before_ they are used.   
 436  
 437# Statically compiled modules (those listed by `httpd -l') do not need   
 438  
 439# to be loaded here.   
 440  
 441#   
 442  
 443# Example:   
 444  
 445# LoadModule foo_module modules/mod_foo.so   
 446  
 447#   
 448  
 449  
 450  
 451#   
 452  
 453# ExtendedStatus controls whether Apache will generate "full" status   
 454  
 455# information (ExtendedStatus On) or just basic information (ExtendedStatus   
 456  
 457# Off) when the "server-status" handler is called. The default is Off.   
 458  
 459#   
 460  
 461#ExtendedStatus On   
 462  
 463  
 464  
 465### Section 2: 'Main' server configuration   
 466  
 467#   
 468  
 469# The directives in this section set up the values used by the 'main'   
 470  
 471# server, which responds to any requests that aren't handled by a   
 472  
 473# <virtualhost> definition. These values also provide defaults for   
 474  
 475# any <virtualhost> containers you may define later in the file.   
 476  
 477#   
 478  
 479# All of these directives may appear inside <virtualhost> containers,   
 480  
 481# in which case these default settings will be overridden for the   
 482  
 483# virtual host being defined.   
 484  
 485#   
 486  
 487  
 488  
 489<ifmodule !mpm_winnt.c="">
 490<ifmodule !mpm_netware.c="">   
 491  
 492#   
 493  
 494# If you wish httpd to run as a different user or group, you must run   
 495  
 496# httpd as root initially and it will switch.   
 497  
 498#   
 499  
 500# User/Group: The name (or #number) of the user/group to run httpd as.   
 501  
 502# . On SCO (ODT 3) use "User nouser" and "Group nogroup".   
 503  
 504# . On HPUX you may not be able to use shared memory as nobody, and the   
 505  
 506# suggested workaround is to create a user www and use that user.   
 507  
 508# NOTE that some kernels refuse to setgid(Group) or semctl(IPC_SET)   
 509  
 510# when the value of (unsigned)Group is above 60000;   
 511  
 512# don't use Group #-1 on these systems!   
 513  
 514#   
 515  
 516User nobody   
 517  
 518Group #-1   
 519  
 520</ifmodule>
 521</ifmodule>   
 522  
 523  
 524  
 525#   
 526  
 527# ServerAdmin: Your address, where problems with the server should be   
 528  
 529# e-mailed. This address appears on some server-generated pages, such   
 530  
 531# as error documents. e.g. [email protected]   
 532  
 533#   
 534  
 535ServerAdmin [email protected] ess   
 536  
 537  
 538  
 539#   
 540  
 541# ServerName gives the name and port that the server uses to identify itself.   
 542  
 543# This can often be determined automatically, but we recommend you specify   
 544  
 545# it explicitly to prevent problems during startup.   
 546  
 547#   
 548  
 549# If this is not set to valid DNS name for your host, server-generated   
 550  
 551# redirections will not work. See also the UseCanonicalName directive.   
 552  
 553#   
 554  
 555# If your host doesn't have a registered DNS name, enter its IP address here.   
 556  
 557# You will have to access it by its address anyway, and this will make   
 558  
 559# redirections work in a sensible way.   
 560  
 561#   
 562  
 563#ServerName new.host.name:80   
 564  
 565  
 566  
 567#   
 568  
 569# UseCanonicalName: Determines how Apache constructs self-referencing   
 570  
 571# URLs and the SERVER_NAME and SERVER_PORT variables.   
 572  
 573# When set "Off", Apache will use the Hostname and Port supplied   
 574  
 575# by the client. When set "On", Apache will use the value of the   
 576  
 577# ServerName directive.   
 578  
 579#   
 580  
 581UseCanonicalName Off   
 582  
 583  
 584  
 585#   
 586  
 587# DocumentRoot: The directory out of which you will serve your   
 588  
 589# documents. By default, all requests are taken from this directory, but   
 590  
 591# symbolic links and aliases may be used to point to other locations.   
 592  
 593#   
 594  
 595DocumentRoot "/server/apache/htdocs"   
 596  
 597  
 598  
 599#   
 600  
 601# Each directory to which Apache has access can be configured with respect   
 602  
 603# to which services and features are allowed and/or disabled in that   
 604  
 605# directory (and its subdirectories).   
 606  
 607#   
 608  
 609# First, we configure the "default" to be a very restrictive set of   
 610  
 611# features.   
 612  
 613#   
 614  
 615<directory></directory>   
 616  
 617Options FollowSymLinks   
 618  
 619AllowOverride all   
 620  
 621   
 622  
 623  
 624  
 625#   
 626  
 627# Note that from this point forward you must specifically allow   
 628  
 629# particular features to be enabled - so if something's not working as   
 630  
 631# you might expect, make sure that you have specifically enabled it   
 632  
 633# below.   
 634  
 635#   
 636  
 637  
 638  
 639#   
 640  
 641# This should be changed to whatever you set DocumentRoot to.   
 642  
 643#   
 644  
 645<directory "="" apache="" htdocs"="" server="">   
 646  
 647  
 648  
 649#   
 650  
 651# Possible values for the Options directive are "None", "All",   
 652  
 653# or any combination of:   
 654  
 655# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews   
 656  
 657#   
 658  
 659# Note that "MultiViews" must be named *explicitly* --- "Options All"   
 660  
 661# doesn't give it to you.   
 662  
 663#   
 664  
 665# The Options directive is both complicated and important. Please see   
 666  
 667# http://httpd.apache.org/docs-2.0/mod/core.html#options   
 668  
 669# for more information.   
 670  
 671#   
 672  
 673Options Indexes FollowSymLinks   
 674  
 675  
 676  
 677#   
 678  
 679# AllowOverride controls what directives may be placed in .htaccess files.   
 680  
 681# It can be "All", "None", or any combination of the keywords:   
 682  
 683# Options FileInfo AuthConfig Limit   
 684  
 685#   
 686  
 687AllowOverride all   
 688  
 689  
 690  
 691#   
 692  
 693# Controls who can get stuff from this server.   
 694  
 695#   
 696  
 697Order allow,deny   
 698  
 699Allow from all   
 700  
 701  
 702  
 703</directory>   
 704  
 705  
 706  
 707#   
 708  
 709# UserDir: The name of the directory that is appended onto a user's home   
 710  
 711# directory if a ~user request is received.   
 712  
 713#   
 714  
 715UserDir public_html   
 716  
 717  
 718  
 719#   
 720  
 721# Control access to UserDir directories. The following is an example   
 722  
 723# for a site where these directories are restricted to read-only.   
 724  
 725#   
 726  
 727#<directory *="" home="" public_html="">   
 728  
 729# AllowOverride FileInfo AuthConfig Limit Indexes   
 730  
 731# Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec   
 732  
 733# <limit get="" options="" post="" propfind="">   
 734  
 735# Order allow,deny   
 736  
 737# Allow from all   
 738  
 739# </limit>   
 740  
 741# <limitexcept get="" options="" post="" propfind="">   
 742  
 743# Order deny,allow   
 744  
 745# Deny from all   
 746  
 747# </limitexcept>   
 748  
 749#</directory>   
 750  
 751  
 752  
 753#   
 754  
 755# DirectoryIndex: sets the file that Apache will serve if a directory   
 756  
 757# is requested.   
 758  
 759#   
 760  
 761# The index.html.var file (a type-map) is used to deliver content-   
 762  
 763# negotiated documents. The MultiViews Option can be used for the   
 764  
 765# same purpose, but it is much slower.   
 766  
 767#   
 768  
 769DirectoryIndex index.htm index.html index.html.ee index.html.var index.php index.asp index.cgi index.pl   
 770  
 771  
 772  
 773#   
 774  
 775# AccessFileName: The name of the file to look for in each directory   
 776  
 777# for additional configuration directives. See also the AllowOverride   
 778  
 779# directive.   
 780  
 781#   
 782  
 783AccessFileName .htaccess   
 784  
 785  
 786  
 787#   
 788  
 789# The following lines prevent .htaccess and .htpasswd files from being   
 790  
 791# viewed by Web clients.   
 792  
 793#   
 794  
 795<files "^\\.ht"="" ~="">   
 796  
 797Order allow,deny   
 798  
 799Deny from all   
 800  
 801</files>   
 802  
 803  
 804  
 805#   
 806  
 807# TypesConfig describes where the mime.types file (or equivalent) is   
 808  
 809# to be found.   
 810  
 811#   
 812  
 813TypesConfig conf/mime.types   
 814  
 815  
 816  
 817#   
 818  
 819# DefaultType is the default MIME type the server will use for a document   
 820  
 821# if it cannot otherwise determine one, such as from filename extensions.   
 822  
 823# If your server contains mostly text or HTML documents, "text/plain" is   
 824  
 825# a good value. If most of your content is binary, such as applications   
 826  
 827# or images, you may want to use "application/octet-stream" instead to   
 828  
 829# keep browsers from trying to display binary files as though they are   
 830  
 831# text.   
 832  
 833#   
 834  
 835DefaultType text/plain   
 836  
 837  
 838  
 839#   
 840  
 841# The mod_mime_magic module allows the server to use various hints from the   
 842  
 843# contents of the file itself to determine its type. The MIMEMagicFile   
 844  
 845# directive tells the module where the hint definitions are located.   
 846  
 847#   
 848  
 849<ifmodule mod_mime_magic.c="">   
 850  
 851MIMEMagicFile conf/magic   
 852  
 853</ifmodule>   
 854  
 855  
 856  
 857#   
 858  
 859# HostnameLookups: Log the names of clients or just their IP addresses   
 860  
 861# e.g., www.apache.org (on) or 204.62.129.132 (off).   
 862  
 863# The default is off because it'd be overall better for the net if people   
 864  
 865# had to knowingly turn this feature on, since enabling it means that   
 866  
 867# each client request will result in AT LEAST one lookup request to the   
 868  
 869# nameserver.   
 870  
 871#   
 872  
 873HostnameLookups Off   
 874  
 875  
 876  
 877#   
 878  
 879# EnableMMAP: Control whether memory-mapping is used to deliver   
 880  
 881# files (assuming that the underlying OS supports it).   
 882  
 883# The default is on; turn this off if you serve from NFS-mounted   
 884  
 885# filesystems. On some systems, turning it off (regardless of   
 886  
 887# filesystem) can improve performance; for details, please see   
 888  
 889# http://httpd.apache.org/docs-2.0/mo...html#enablemmap   
 890  
 891#   
 892  
 893#EnableMMAP off   
 894  
 895  
 896  
 897#   
 898  
 899# EnableSendfile: Control whether the sendfile kernel support is   
 900  
 901# used to deliver files (assuming that the OS supports it).   
 902  
 903# The default is on; turn this off if you serve from NFS-mounted   
 904  
 905# filesystems. Please see   
 906  
 907# http://httpd.apache.org/docs-2.0/mo...#enablesendfile   
 908  
 909#   
 910  
 911#EnableSendfile off   
 912  
 913  
 914  
 915#   
 916  
 917# ErrorLog: The location of the error log file.   
 918  
 919# If you do not specify an ErrorLog directive within a <virtualhost>   
 920  
 921# container, error messages relating to that virtual host will be   
 922  
 923# logged here. If you *do* define an error logfile for a <virtualhost>   
 924  
 925# container, that host's errors will be logged there and not here.   
 926  
 927#   
 928  
 929ErrorLog logs/error_log   
 930  
 931  
 932  
 933#   
 934  
 935# LogLevel: Control the number of messages logged to the error_log.   
 936  
 937# Possible values include: debug, info, notice, warn, error, crit,   
 938  
 939# alert, emerg.   
 940  
 941#   
 942  
 943LogLevel warn   
 944  
 945  
 946  
 947#   
 948  
 949# The following directives define some format nicknames for use with   
 950  
 951# a CustomLog directive (see below).   
 952  
 953#   
 954  
 955LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined   
 956  
 957LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common   
 958  
 959LogFormat "%{Referer}i -&gt; %U" referer   
 960  
 961LogFormat "%{User-agent}i" agent   
 962  
 963  
 964  
 965# You need to enable mod_logio.c to use %I and %O   
 966  
 967#LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio   
 968  
 969  
 970  
 971#   
 972  
 973# The location and format of the access logfile (Common Logfile Format).   
 974  
 975# If you do not define any access logfiles within a <virtualhost>   
 976  
 977# container, they will be logged here. Contrariwise, if you *do*   
 978  
 979# define per-<virtualhost> access logfiles, transactions will be   
 980  
 981# logged therein and *not* in this file.   
 982  
 983#   
 984  
 985CustomLog logs/access_log common   
 986  
 987  
 988  
 989#   
 990  
 991# If you would like to have agent and referer logfiles, uncomment the   
 992  
 993# following directives.   
 994  
 995#   
 996  
 997#CustomLog logs/referer_log referer   
 998  
 999#CustomLog logs/agent_log agent   
1000  
1001  
1002  
1003#   
1004  
1005# If you prefer a single logfile with access, agent, and referer information   
1006  
1007# (Combined Logfile Format) you can use the following directive.   
1008  
1009#   
1010  
1011#CustomLog logs/access_log combined   
1012  
1013  
1014  
1015#   
1016  
1017# ServerTokens   
1018  
1019# This directive configures what you return as the Server HTTP response   
1020  
1021# Header. The default is 'Full' which sends information about the OS-Type   
1022  
1023# and compiled in modules.   
1024  
1025# Set to one of: Full | OS | Minor | Minimal | Major | Prod   
1026  
1027# where Full conveys the most information, and Prod the least.   
1028  
1029#   
1030  
1031ServerTokens Full   
1032  
1033  
1034  
1035#   
1036  
1037# Optionally add a line containing the server version and virtual host   
1038  
1039# name to server-generated pages (internal error documents, FTP directory   
1040  
1041# listings, mod_status and mod_info output etc., but not CGI generated   
1042  
1043# documents or custom error documents).   
1044  
1045# Set to "EMail" to also include a mailto: link to the ServerAdmin.   
1046  
1047# Set to one of: On | Off | EMail   
1048  
1049#   
1050  
1051ServerSignature On   
1052  
1053  
1054  
1055#   
1056  
1057# Aliases: Add here as many aliases as you need (with no limit). The format is   
1058  
1059# Alias fakename realname   
1060  
1061#   
1062  
1063# Note that if you include a trailing / on fakename then the server will   
1064  
1065# require it to be present in the URL. So "/icons" isn't aliased in this   
1066  
1067# example, only "/icons/". If the fakename is slash-terminated, then the   
1068  
1069# realname must also be slash terminated, and if the fakename omits the   
1070  
1071# trailing slash, the realname must also omit it.   
1072  
1073#   
1074  
1075# We include the /icons/ alias for FancyIndexed directory listings. If you   
1076  
1077# do not use FancyIndexing, you may comment this out.   
1078  
1079#   
1080  
1081Alias /icons/ "/server/apache/icons/"   
1082  
1083  
1084  
1085<directory "="" apache="" icons"="" server="">   
1086  
1087Options Indexes MultiViews   
1088  
1089AllowOverride None   
1090  
1091Order allow,deny   
1092  
1093Allow from all   
1094  
1095</directory>   
1096  
1097  
1098  
1099#   
1100  
1101# This should be changed to the ServerRoot/manual/. The alias provides   
1102  
1103# the manual, even if you choose to move your DocumentRoot. You may comment   
1104  
1105# this out if you do not care for the documentation.   
1106  
1107#   
1108  
1109Alias /manual "/server/apache/manual"   
1110  
1111  
1112  
1113<directory "="" apache="" manual"="" server="">   
1114  
1115Options Indexes FollowSymLinks MultiViews IncludesNoExec   
1116  
1117AddOutputFilter Includes html   
1118  
1119AllowOverride all   
1120  
1121Order allow,deny   
1122  
1123Allow from all   
1124  
1125</directory>   
1126  
1127  
1128  
1129#   
1130  
1131# ScriptAlias: This controls which directories contain server scripts.   
1132  
1133# ScriptAliases are essentially the same as Aliases, except that   
1134  
1135# documents in the realname directory are treated as applications and   
1136  
1137# run by the server when requested rather than as documents sent to the client.   
1138  
1139# The same rules about trailing "/" apply to ScriptAlias directives as to   
1140  
1141# Alias.   
1142  
1143#   
1144  
1145ScriptAlias /cgi-bin/ "/server/apache/cgi-bin/"   
1146  
1147  
1148  
1149<ifmodule mod_cgid.c="">   
1150  
1151#   
1152  
1153# Additional to mod_cgid.c settings, mod_cgid has Scriptsock <path>   
1154  
1155# for setting UNIX socket for communicating with cgid.   
1156  
1157#   
1158  
1159#Scriptsock logs/cgisock   
1160  
1161</path></ifmodule>   
1162  
1163  
1164  
1165#   
1166  
1167# "/server/apache/cgi-bin" should be changed to whatever your ScriptAliased   
1168  
1169# CGI directory exists, if you have that configured.   
1170  
1171#   
1172  
1173<directory "="" apache="" cgi-bin"="" server="">   
1174  
1175AllowOverride all   
1176  
1177Options all   
1178  
1179Order allow,deny   
1180  
1181Allow from all   
1182  
1183</directory>   
1184  
1185  
1186  
1187#   
1188  
1189# Redirect allows you to tell clients about documents which used to exist in   
1190  
1191# your server's namespace, but do not anymore. This allows you to tell the   
1192  
1193# clients where to look for the relocated document.   
1194  
1195# Example:   
1196  
1197# Redirect permanent /foo http://www.andsky.com/bar   
1198  
1199  
1200  
1201#   
1202  
1203# Directives controlling the display of server-generated directory listings.   
1204  
1205#   
1206  
1207  
1208  
1209#   
1210  
1211# IndexOptions: Controls the appearance of server-generated directory   
1212  
1213# listings.   
1214  
1215#   
1216  
1217IndexOptions FancyIndexing VersionSort   
1218  
1219  
1220  
1221#   
1222  
1223# AddIcon* directives tell the server which icon to show for different   
1224  
1225# files or filename extensions. These are only displayed for   
1226  
1227# FancyIndexed directories.   
1228  
1229#   
1230  
1231AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip   
1232  
1233  
1234  
1235AddIconByType (TXT,/icons/text.gif) text/*   
1236  
1237AddIconByType (IMG,/icons/image2.gif) image/*   
1238  
1239AddIconByType (SND,/icons/sound2.gif) audio/*   
1240  
1241AddIconByType (VID,/icons/movie.gif) video/*   
1242  
1243  
1244  
1245AddIcon /icons/binary.gif .bin .exe   
1246  
1247AddIcon /icons/binhex.gif .hqx   
1248  
1249AddIcon /icons/tar.gif .tar   
1250  
1251AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv   
1252  
1253AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip   
1254  
1255AddIcon /icons/a.gif .ps .ai .eps   
1256  
1257AddIcon /icons/layout.gif .html .shtml .htm .pdf   
1258  
1259AddIcon /icons/text.gif .txt   
1260  
1261AddIcon /icons/c.gif .c   
1262  
1263AddIcon /icons/p.gif .pl .py   
1264  
1265AddIcon /icons/f.gif .for   
1266  
1267AddIcon /icons/dvi.gif .dvi   
1268  
1269AddIcon /icons/uuencoded.gif .uu   
1270  
1271AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl   
1272  
1273AddIcon /icons/tex.gif .tex   
1274  
1275AddIcon /icons/bomb.gif core   
1276  
1277  
1278  
1279AddIcon /icons/back.gif ..   
1280  
1281AddIcon /icons/hand.right.gif README   
1282  
1283AddIcon /icons/folder.gif ^^DIRECTORY^^   
1284  
1285AddIcon /icons/blank.gif ^^BLANKICON^^   
1286  
1287  
1288  
1289#   
1290  
1291# DefaultIcon is which icon to show for files which do not have an icon   
1292  
1293# explicitly set.   
1294  
1295#   
1296  
1297DefaultIcon /icons/unknown.gif   
1298  
1299  
1300  
1301#   
1302  
1303# AddDescription allows you to place a short description after a file in   
1304  
1305# server-generated indexes. These are only displayed for FancyIndexed   
1306  
1307# directories.   
1308  
1309# Format: AddDescription "description" filename   
1310  
1311#   
1312  
1313#AddDescription "GZIP compressed document" .gz   
1314  
1315#AddDescription "tar archive" .tar   
1316  
1317#AddDescription "GZIP compressed tar archive" .tgz   
1318  
1319  
1320  
1321#   
1322  
1323# ReadmeName is the name of the README file the server will look for by   
1324  
1325# default, and append to directory listings.   
1326  
1327#   
1328  
1329# HeaderName is the name of a file which should be prepended to   
1330  
1331# directory indexes.   
1332  
1333ReadmeName README.html   
1334  
1335HeaderName HEADER.html   
1336  
1337  
1338  
1339#   
1340  
1341# IndexIgnore is a set of filenames which directory indexing should ignore   
1342  
1343# and not include in the listing. Shell-style wildcarding is permitted.   
1344  
1345#   
1346  
1347IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t   
1348  
1349  
1350  
1351#   
1352  
1353# AddEncoding allows you to have certain browsers (Mosaic/X 2.1+) uncompress   
1354  
1355# information on the fly. Note: Not all browsers support this.   
1356  
1357# Despite the name similarity, the following Add* directives have nothing   
1358  
1359# to do with the FancyIndexing customization directives above.   
1360  
1361#   
1362  
1363AddEncoding x-compress Z   
1364  
1365AddEncoding x-gzip gz tgz   
1366  
1367  
1368  
1369#   
1370  
1371# DefaultLanguage and AddLanguage allows you to specify the language of   
1372  
1373# a document. You can then use content negotiation to give a browser a   
1374  
1375# file in a language the user can understand.   
1376  
1377#   
1378  
1379# Specify a default language. This means that all data   
1380  
1381# going out without a specific language tag (see below) will   
1382  
1383# be marked with this one. You probably do NOT want to set   
1384  
1385# this unless you are sure it is correct for all cases.   
1386  
1387#   
1388  
1389# * It is generally better to not mark a page as   
1390  
1391# * being a certain language than marking it with the wrong   
1392  
1393# * language!   
1394  
1395#   
1396  
1397# DefaultLanguage nl   
1398  
1399#   
1400  
1401# Note 1: The suffix does not have to be the same as the language   
1402  
1403# keyword --- those with documents in Polish (whose net-standard   
1404  
1405# language code is pl) may wish to use "AddLanguage pl .po" to   
1406  
1407# avoid the ambiguity with the common suffix for perl scripts.   
1408  
1409#   
1410  
1411# Note 2: The example entries below illustrate that in some cases   
1412  
1413# the two character 'Language' abbreviation is not identical to   
1414  
1415# the two character 'Country' code for its country,   
1416  
1417# E.g. 'Danmark/dk' versus 'Danish/da'.   
1418  
1419#   
1420  
1421# Note 3: In the case of 'ltz' we violate the RFC by using a three char   
1422  
1423# specifier. There is 'work in progress' to fix this and get   
1424  
1425# the reference data for rfc1766 cleaned up.   
1426  
1427#   
1428  
1429# Danish (da) - Dutch (nl) - English (en) - Estonian (et)   
1430  
1431# French (fr) - German (de) - Greek-Modern (el)   
1432  
1433# Italian (it) - Norwegian (no) - Norwegian Nynorsk (nn) - Korean (ko)   
1434  
1435# Portugese (pt) - Luxembourgeois* (ltz)   
1436  
1437# Spanish (es) - Swedish (sv) - Catalan (ca) - Czech(cz)   
1438  
1439# Polish (pl) - Brazilian Portuguese (pt-br) - Japanese (ja)   
1440  
1441# Russian (ru) - Croatian (hr)   
1442  
1443#   
1444  
1445AddLanguage da .dk   
1446  
1447AddLanguage nl .nl   
1448  
1449AddLanguage en .en   
1450  
1451AddLanguage et .et   
1452  
1453AddLanguage fr .fr   
1454  
1455AddLanguage de .de   
1456  
1457AddLanguage he .he   
1458  
1459AddLanguage el .el   
1460  
1461AddLanguage it .it   
1462  
1463AddLanguage ja .ja   
1464  
1465AddLanguage pl .po   
1466  
1467AddLanguage ko .ko   
1468  
1469AddLanguage pt .pt   
1470  
1471AddLanguage nn .nn   
1472  
1473AddLanguage no .no   
1474  
1475AddLanguage pt-br .pt-br   
1476  
1477AddLanguage ltz .ltz   
1478  
1479AddLanguage ca .ca   
1480  
1481AddLanguage es .es   
1482  
1483AddLanguage sv .sv   
1484  
1485AddLanguage cz .cz   
1486  
1487AddLanguage ru .ru   
1488  
1489AddLanguage tw .tw   
1490  
1491AddLanguage zh-tw .tw   
1492  
1493AddLanguage hr .hr   
1494  
1495  
1496  
1497#   
1498  
1499# LanguagePriority allows you to give precedence to some languages   
1500  
1501# in case of a tie during content negotiation.   
1502  
1503#   
1504  
1505# Just list the languages in decreasing order of preference. We have   
1506  
1507# more or less alphabetized them here. You probably want to change this.   
1508  
1509#   
1510  
1511LanguagePriority en da nl et fr de el it ja ko no pl pt pt-br ltz ca es sv tw   
1512  
1513  
1514  
1515#   
1516  
1517# ForceLanguagePriority allows you to serve a result page rather than   
1518  
1519# MULTIPLE CHOICES (Prefer) [in case of a tie] or NOT ACCEPTABLE (Fallback)   
1520  
1521# [in case no accepted languages matched the available variants]   
1522  
1523#   
1524  
1525#ForceLanguagePriority Prefer Fallback   
1526  
1527  
1528  
1529#   
1530  
1531# Specify a default charset for all pages sent out. This is   
1532  
1533# always a good idea and opens the door for future internationalisation   
1534  
1535# of your web site, should you ever want it. Specifying it as   
1536  
1537# a default does little harm; as the standard dictates that a page   
1538  
1539# is in iso-8859-1 (latin1) unless specified otherwise i.e. you   
1540  
1541# are merely stating the obvious. There are also some security   
1542  
1543# reasons in browsers, related to javascript and URL parsing   
1544  
1545# which encourage you to always set a default char set.   
1546  
1547#   
1548  
1549AddDefaultCharset gb2312   
1550  
1551  
1552  
1553#   
1554  
1555# Commonly used filename extensions to character sets. You probably   
1556  
1557# want to avoid clashes with the language extensions, unless you   
1558  
1559# are good at carefully testing your setup after each change.   
1560  
1561# See http://www.iana.org/assignments/character-sets for the   
1562  
1563# official list of charset names and their respective RFCs.   
1564  
1565#   
1566  
1567AddCharset ISO-8859-1 .iso8859-1 .latin1   
1568  
1569AddCharset ISO-8859-2 .iso8859-2 .latin2 .cen   
1570  
1571AddCharset ISO-8859-3 .iso8859-3 .latin3   
1572  
1573AddCharset ISO-8859-4 .iso8859-4 .latin4   
1574  
1575AddCharset ISO-8859-5 .iso8859-5 .latin5 .cyr .iso-ru   
1576  
1577AddCharset ISO-8859-6 .iso8859-6 .latin6 .arb   
1578  
1579AddCharset ISO-8859-7 .iso8859-7 .latin7 .grk   
1580  
1581AddCharset ISO-8859-8 .iso8859-8 .latin8 .heb   
1582  
1583AddCharset ISO-8859-9 .iso8859-9 .latin9 .trk   
1584  
1585AddCharset ISO-2022-JP .iso2022-jp .jis   
1586  
1587AddCharset ISO-2022-KR .iso2022-kr .kis   
1588  
1589AddCharset ISO-2022-CN .iso2022-cn .cis   
1590  
1591AddCharset Big5 .Big5 .big5   
1592  
1593# For russian, more than one charset is used (depends on client, mostly):   
1594  
1595AddCharset WINDOWS-1251 .cp-1251 .win-1251   
1596  
1597AddCharset CP866 .cp866   
1598  
1599AddCharset KOI8-r .koi8-r .koi8-ru   
1600  
1601AddCharset KOI8-ru .koi8-uk .ua   
1602  
1603AddCharset ISO-10646-UCS-2 .ucs2   
1604  
1605AddCharset ISO-10646-UCS-4 .ucs4   
1606  
1607AddCharset UTF-8 .utf8   
1608  
1609  
1610  
1611# The set below does not map to a specific (iso) standard   
1612  
1613# but works on a fairly wide range of browsers. Note that   
1614  
1615# capitalization actually matter</virtualhost></virtualhost></virtualhost></virtualhost></virtualhost></virtualhost></virtualhost></virtualhost></url:></url:>