Mercurial > HIS > BLT-XML
Help: serve
hg serve [OPTION]...
start stand-alone webserver
Start a local HTTP repository browser and pull server. You can use this for ad-hoc sharing and browsing of repositories. It is recommended to use a real web server to serve a repository for longer periods of time.
Please note that the server does not implement access control. This means that, by default, anybody can read from the server and nobody can write to it by default. Set the "web.allow-push" option to "*" to allow everybody to push to the server. You should use a real web server if you need to authenticate users.
By default, the server logs accesses to stdout and errors to stderr. Use the -A/--accesslog and -E/--errorlog options to log to files.
To have the server choose a free port number to listen on, specify a port number of 0; in this case, the server will print the port number it uses.
Returns 0 on success.
options ([+] can be repeated):
| -A | --accesslog FILE | name of access log file to write to |
| -d | --daemon | run server in background |
| --daemon-postexec VALUE [+] | used internally by daemon mode | |
| -E | --errorlog FILE | name of error log file to write to |
| -p | --port PORT | port to listen on (default: 8000) |
| -a | --address ADDR | address to listen on (default: all interfaces) |
| --prefix PREFIX | prefix path to serve from (default: server root) | |
| -n | --name NAME | name to show in web pages (default: working directory) |
| --web-conf FILE | name of the hgweb config file (see 'hg help hgweb') | |
| --webdir-conf FILE | name of the hgweb config file (DEPRECATED) | |
| --pid-file FILE | name of file to write process ID to | |
| --stdio | for remote clients (ADVANCED) | |
| --cmdserver MODE | for remote clients (ADVANCED) | |
| -t | --templates TEMPLATE | web templates to use |
| --style STYLE | template style to use | |
| -6 | --ipv6 | use IPv6 instead of IPv4 |
| --certificate FILE | SSL certificate file | |
| --print-url | start and print only the URL | |
| -S | --subrepos | recurse into subrepositories |
global options ([+] can be repeated):
| -R | --repository REPO | repository root directory or name of overlay bundle file |
| --cwd DIR | change working directory | |
| -y | --noninteractive | do not prompt, automatically pick the first choice for all prompts |
| -q | --quiet | suppress output |
| -v | --verbose | enable additional output |
| --color TYPE | when to colorize (boolean, always, auto, never, or debug) | |
| --config CONFIG [+] | set/override config option (use 'section.name=value') | |
| --debug | enable debugging output | |
| --debugger | start debugger | |
| --encoding ENCODE | set the charset encoding (default: UTF-8) | |
| --encodingmode MODE | set the charset encoding mode (default: strict) | |
| --traceback | always print a traceback on exception | |
| --time | time how long the command takes | |
| --profile | print command execution profile | |
| --version | output version information and exit | |
| -h | --help | display help and exit |
| --hidden | consider hidden changesets | |
| --pager TYPE | when to paginate (boolean, always, auto, or never) (default: auto) |
