NAME¶

htsserver - web server for the WebHTTrack interface

SYNOPSIS¶

htsserver <path-to-html-root-dir> [option value ..] [key value ..]

DESCRIPTION¶

htsserver serves the WebHTTrack interface, a set of HTML pages that drive the httrack(1) engine from a web browser. It listens on 127.0.0.1 by default and prints the address to open on a line starting with URL=. Most users start it through webhttrack(1), which also opens the browser.

The first argument is the directory that holds the interface pages and the language files, usually /usr/share/httrack/. The options and the key/value pairs come after it. The help and version options must come first instead.

OPTIONS¶

--port <port>

listen on this port (default: the first free port from 8080)

--bind <address>

listen on this address (default: 127.0.0.1)

--ppid <pid>

exit when the interface started by this launcher process is closed

--ping-timeout <secs>

with --ppid, how long a browser window that stops answering counts as open (default: 120)

key value

any other pair sets a value the interface reads, such as path or lang

-h, --help

print this help and exit

--version

print the version and exit

EXAMPLES¶

htsserver /usr/share/httrack/ lang 1

serve the interface in English

htsserver /usr/share/httrack/ path /tmp/mirrors

keep the projects in /tmp/mirrors

DIAGNOSTICS¶

Each mirror started from the interface writes its errors and warnings to hts-log.txt in the project directory.

BUGS¶

Please reports bugs to <bugs@httrack.com>. Include a complete, self-contained example that will allow the bug to be reproduced, and say which version of httrack you are using. Do not forget to detail options used, OS version, and any other information you deem necessary.

COPYRIGHT¶

Copyright (C) 1998-2026 Xavier Roche and other contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

AVAILABILITY¶

The most recent released version of httrack can be found at: https://www.httrack.com

AUTHOR¶

Xavier Roche <roche@httrack.com>

SEE ALSO¶

The HTML documentation (available online at https://www.httrack.com/html/ ) contains more detailed information. Please also refer to the httrack FAQ (available online at https://www.httrack.com/html/faq.html )

The launcher is webhttrack(1), and the command-line engine is httrack(1).