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