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)

Mercurial > repos > nml > kat_sect

Help: serve