After installation, Appweb is normally started automatically as a system service or system daemon. You can change this behavior and only start Appweb manually if you wish.

This page gives information about starting and stopping Appweb manually. Before you can run Appweb manually, you must first stop it running as a system service. See Running as a service for how to stop Appweb running as a system service.

Appweb Programs

The appweb program may be run in the foreground or in the background as a system service (daemon). On Windows, Appweb normally runs as a windows application or a system service, however it may run also be run explicitly as a console application via the "-c" switch.

Appweb Command Line

Both the appweb and appweb programs may be invoked from the command line. The command syntax is:

Appweb Command Options

Option	Description
-A	Auto-scan for a free port. Port scanning starts with the port specified by the -a switch or from 80 if running as super-user (administrator), or 1080 if running unprivileged.
-a IP:PORT	Specify the IP and port address to listen on. You may omit the IP or the port portion. If the IP portion is omitted, then all interfaces will be listened to. If the port portion is omitted, then port 80 will be used.
-b	Run appweb as a daemon in the background.
-D	Set DEBUG mode on. This will disable all timeouts and is useful for single-step debugging.
-d docRootDir	Specify the directory holding the web documents to serve.
-f configFile	Specifies an alternative configuration file instead of appweb.conf.
-k	Kill a currently running appweb.
-l logSpec	Specify a file to log messages. This will override the ErrorLog directive in the configuration file. The syntax is: -l logName[,moduleName][:logLevel][.maxSize]. When the maximum size is exceeded, the log file will be rotated to logName.old and a new log file will be started.
-r serverRootDir	Specify the starting directory for the root of the server. This directory contains Appweb configuration file.
-t numPoolThreads	Specify the number of threads to allocate for the appweb thread pool. This overrides the ThreadLimit configuration file directive.
-v	Display the appweb version number

Windows Specific Command Options

On Windows, the appweb program also supports the following options:

-c	Run as a console application. This will create a console window. Currently this does not work when invoked directly from a CYGWIN window.
-i "service command line"	Install appweb as a windows service. The argument to the -i option is a appweb set of options to use when the Windows service control manager starts appweb. The argument to -i is normal "-d" to instruct appweb to run as a windows service.
-g	Instruct appweb to go (start).
-s	Stop appweb.
-u	Uninstall appweb as a system service.