hg-serve - Man Page

start stand-alone webserver

Examples (TL;DR)

Start a web server instance: hg serve
Start a web server instance on the specified port: hg serve --port port
Start a web server instance on the specified listening address: hg serve --address address
Start a web server instance with a specific identifier: hg serve --name name
Start a web server instance using the specified theme (see the templates directory): hg serve --style style
Start a web server instance using the specified SSL certificate bundle: hg serve --certificate path/to/certificate

Synopsis

hg serve [OPTION]...

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.