---
name: "webcit"
section: "8"
platform: "linux"
package: "citadel-webcit"
version: "917-dfsg-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/webcit"
---

# webcit(8)

Citadel Servlet Engine.

## NAME

webcit - Citadel Servlet Engine.

## SYNOPSIS

**webcit** **\[-i** **ip\_addr\]** **\[-p** **http\_port\]** **\[-t** **tracefile\]** **\[-T** **Templatedebuglevel\]** **\[-c\]** **\[-f\]** **\[-d\]** **\[-s\]** **\[remotehost** **\[remoteport\]** **\]**

## DESCRIPTION

WebCit (the binaries name is webcit) is the Citadel Servlet engine. It can operate with Citserver on another box, but it can't operate without.

## OPTIONS

- SwitchResult

  - **-hPATH**

  Specify the home directory eg. -h/usr/local/citadel not adding a leading / will make the path relative to the compiletime path. Needed for running several webcit/citadel instances at the same host

- **-d**

  Run as a daemon; fork watcher process.

- **-DPATH**

  Run as a daemon but create a pid file at PATH eg. -D/var/run/webcit.pid

- **-iIP\_ADDR**

  Specify IP address to listen on as web server eg -i192.168.9.1; default is 0.0.0.0

- **-pPORT**

  Specify port to listen on eg. -p80; default is 2000

- **-tPATH**

  Specify trace file (where to put the log file) eg -t/var/log/webcit

- **-T VAL**

  0 (default; recommended for production systems) 1: Parse template on each request .TP **-xVAL** How much info to put in the trace file (or to stdout) eg -x9

- **-f**

  Follow X-Forwarded-For: headers.

- **-c**

  Use a server cookie.

- **-s**

  use SSL (turns the -p default to 443)

- **remotehost**

  if the citserver lives on another box, its name / ip (remember to add your webserver IP to the citadel servers public\_clients - Configfile.); else the path to the unix-domain-socket. Defaults to the compiled in unix domain socket

- **remoteport**

  If you want to connect to citserver via TCP specify its port here; usualy 504

## DEFAULTS

The default for remotehost is to connect localy via Unix Domain Socket. The default TCP port is 504. **webcit** will open Port 2000 serving HTTP requests and bind 0.0.0.0 if not other specified.

## FILES

The location of the files may vary depending on configure options. .TP */usr/share/citadel-webcit/static/***/**  WebCits template files

- */usr/share/citadel-webcit/static.local/***/** Your customized

  templates

- */usr/share/tinymce/www/***/** the TinyMCE

  \[http://tinymce.moxiecode.com/\] Javascript Editor

- */etc/init.d/webcit***/**

  The initscript usually used to start this binary. Add Options here

- */etc/default/webcit***/**

  Parameters to */etc/init.d/webcit*/ in the LHFS ified installations **dpkg-reconfigure**citadel-webcit**will**modify**this**file.

## HISTORY

1998 - Now the Uncensored Communication Group