comparison doc/hgrc.5.txt @ 13057:1cfaf11c6398 stable

hgrc.5: expand introduction for [web] section
author Martin Geisler <mg@lazybytes.net>
date Wed, 01 Dec 2010 10:52:31 +0100
parents 4fdb4b18eb3d
children f05250572467 b25b5ad0cca8
comparison
equal deleted inserted replaced
13056:4fdb4b18eb3d 13057:1cfaf11c6398
923 Increase the amount of output printed. True or False. Default is False. 923 Increase the amount of output printed. True or False. Default is False.
924 924
925 925
926 ``web`` 926 ``web``
927 """"""" 927 """""""
928 Web interface configuration. 928
929 Web interface configuration. The settings in this section apply to
930 both the builtin webserver (started by :hg:`serve`) and the script you
931 run through a webserver (``hgweb.cgi`` and the derivatives for FastCGI
932 and WSGI).
933
934 The Mercurial webserver does no authentication (it does not prompt for
935 usernames and passwords to validate *who* users are), but it does do
936 authorization (it grants or denies access for *authenticated users*
937 based on settings in this section). You must either configure your
938 webserver to do authentication for you, or disable the authorization
939 checks.
940
941 For a quick setup in a trusted environment, e.g., a private LAN, where
942 you want it to accept pushes from anybody, you can use the following
943 command line::
944
945 $ hg --config web.allow_push=* --config web.push_ssl=False serve
946
947 Note that this will allow anybody to push anything to the server and
948 that this should not be used for public servers.
949
950 The full set of options is:
929 951
930 ``accesslog`` 952 ``accesslog``
931 Where to output the access log. Default is stdout. 953 Where to output the access log. Default is stdout.
932 ``address`` 954 ``address``
933 Interface address to bind to. Default is all. 955 Interface address to bind to. Default is all.