---
name: "xttpd"
section: "1"
platform: "linux"
package: "xtide"
version: "2.0b3-2.1"
release: "Debian 2.1 (Slink)"
platforms: ["linux"]
url: "https://new.carta.tech/xttpd"
---

# xttpd(1)

Harmonic tide clock and tide predictor (web server)

## NAME

xttpd - Harmonic tide clock and tide predictor (web server)

## SYNOPSIS

**xttpd** \[**port**\]

## DESCRIPTION

XTide is a package that provides tide and current predictions in a wide variety of formats. Graphs, text listings, and calendars can be generated, or a tide clock can be provided on your desktop.

XTide can work with X-windows, plain text terminals, or the web. This is accomplished with three separate programs: the interactive interface (**xtide**), the non-interactive or command line interface (**tide**), and the web interface (**xttpd**).

**xttpd** is an XTide web server. It provides web-based access to XTide's tide predictions by allowing a web browser to speak directly to the XTide program in HTTP. **xttpd** can replace **httpd** or it can co-exist with one.

If you run **xttpd** with no command line arguments, it will assume that it is replacing **httpd** and try to bind port 80. If you want it to co-exist with an existing server, or if you do not have privilege to get port 80, give it the port number as the first command line argument:

% xttpd 8080

You will then need to link it up as http://www.wherever.org:8080/ instead of just http://www.wherever.org/, but otherwise, no damage done. **xttpd** will try to set its UID to 'nobody' once the port is established, but will issue a warning and continue with the default user ID if this fails.

For a complete discussion of the command line options and a detailed explanation of the XTide package, please see the verbose documentation at **http://www.universe.digex.net/~dave/xtide/**.

## CONFIGURATION

See the file /usr/doc/xtide/README.debian for an update to  this section. You must set the environment variable **HFILE\_PATH** to point to the harmonics files that should have been installed along with the **xttpd** program.  Example:

export HFILE\_PATH=/etc/harmonics:/etc/offsets.xml:/etc/harmonics.anchorage

## SEE ALSO

[**tide**(1)](/tide/1.md), [**xtide**(1)](/xtide/1.md), **http://www.universe.digex.net/~dave/xtide/**.