Embedthis Appweb 4.3.4
Home > Users Guide > Running as a System Service

# Quick Nav

# See Also

# Running as a System Service or Daemon

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

This page gives generic and windows -specific information about starting and stopping the Appweb service.

- Generic Instructions
- Windows Instructions

## Generic Instructions

Appweb includes a manager program called appman. This program is used to configure the running of Appweb as service. Appman provides a generic way to install/uninstall, enable/disable, start/stop, and run the Appweb service regardless of the Operating System.

The Appman command takes the form:

    appman commands...

Where commands can be:

Command | Details
--- | ---
install | Install Appweb service
uninstall | Uninstall Appweb service
enable | Enable Appweb to start automatically on system boot
disable | Disable Appweb from automatically starting
start | Start Appweb manually
stop | Stop Appweb
run | Run Appweb and monitor its execution. Restart if it fails.

### Stopping Appweb as a Service

Use the following command to stop Appweb running as a service permanently:

    appman disable

Run the following commands to restore Appweb running as a service:

    appman enable
    appman start

## Windows Instructions

On Windows, Appweb is managed by two programs:

- The Appweb Manager
- The Appweb Monitor

The Appman manager program is installed as a windows service that starts, manages and restarts Appweb. If Appweb fails, Appman will automatically restart it.

Windows services run in the background with little interaction with the user. So to provide more convenient access to manage Appweb, the Appweb Monitor program runs and is accessible from the windows system tray (taskbar notification area). You can start and stop Appweb using either the manager or Monitor programs.

### Appman — Appweb Manager Service

You can interface with the Appman program via the Windows Services Applet. To invoke the applet select:

    Start -> Control Panel -> Administrative Tools -> Services

Then select and double click on the Embedthis Appweb service. A dialog panel will be displayed from which you can start and stop the manager (appman) process.

When started or stopped, the manager will first do the same operation on the real Appweb instance. Pausing the manager will have no effect on Appweb, but will pause the manager itself.

Once installed, you will need to start the service via the Services control applet.

### Appweb Monitor

The Windows Appweb Monitor is launched when you log in. It a quick and easy way to start, stop, and restart Appweb. You can also launch a browser to display the documentation or the Appweb management console (future feature).

When you select 'stop' Appweb, you actually stop the manager process which in turn stops Appweb. Similarly, when you select 'start' Appweb, you are really starting the manager which detects that Appweb is not running and automatically launches it.

© Embedthis Software LLC, 2003-2013. All rights reserved. Embedthis, Appweb, ESP, Ejscript and Embedthis GoAhead are trademarks of Embedthis Software LLC.