APPWEB(1) User Commands APPWEB(1)
NAME
appweb- Embedded HTTP Web Server
SYNOPSIS
appweb [options]
appweb [options] [IP][:port] [documentRoot]
appweb [--config configFile] [--chroot directory] [--debug] [--ejs app-
Spec] [--log logSpec] [--home directory] [--threads threads] [--ver-
sion] [--verbose]
DESCRIPTION
Appweb is a compact embedded HTTP web server. It is a fast, small-
footprint, multi-threaded, standards-based, portable server developed
for use by embedded devices and applications. It can run as a stand-
alone web server or the Appweb library can be embedded in applications.
Appweb supports HTTP/1.1, SSL, digest and basic authentication, virtual
hosting, ranged requests, chunked transfers, file upload and security
limits. Appweb has an Apache style configuration file and supports the
PHP and Ejscript web frameworks.
Appweb normally reads the appweb.conf file for configuration direc-
tives. However, if appweb is invoked with an IP address or port number
on the command line, Appweb will not read the configuration file.
Rather it will listen for requests on the specified IP:PORT address. If
the PORT component is omitted, Appweb will listen on port 80. If the IP
address is omitted and a port is supplied, Appweb will listen on all
network interfaces.
OPTIONS
--config filename
Define the name of the Appweb configuration file. This is by
default appweb.
--chroot directory
Change the system root directory for Appweb. This creates a
chroot jail so that the Appweb process cannot access any files
outside the given directory.
--debug
Run Appweb in debug mode and disable all timeouts. This disables
request and session timeouts. The -d option is an alias for
--debug.
--ejs name:directory
Define an Ejscript application by name at the specified direc-
tory. The name is the application name and is used as a URL pre-
fix. When a request arrives which matches this URL prefix, it is
routed to the application to service. For example:
appweb --ejs /carmen/:/var/www/apps/carmen/
--log logSpec
Name the Appweb log file. This will override the ErrorLog direc-
tive in the configuration file. When the maximum size is
exceeded, the log file will be rotated to logName.old and a new
log file will be started. The -l option is an alias for --log.
The syntax is:
--log logName[:logLevel][.maxSize]
--home directory
Define the server home directory for Appweb.
--threads numThreads
Specify the maximum number of threads to use for the appweb
thread pool. This overrides the ThreadLimit configuration file
directive.
--verbose
Shorthand for --log stdout:4. The -v option is an alias for
--verbose.
--version
Output the product version number.
FILES
/etc/appweb/appweb.conf
/var/www/appweb-default
/usr/lib/appweb
/var/log/appweb
REPORTING BUGS
Report bugs to <dev@embedthis.com>.
COPYRIGHT
Copyright (C) 2003-2012 Embedthis Software.
SEE ALSO
http
appweb March 2012 APPWEB(1)