µWeb

h1. Standalone

µWeb's standalone mode allows you to develop an application or website without installing / configuring a full-fledged webserver like apache. By keeping all of the environment the same as it would be inside a normal webserver it allows you to code once, and run on both types of install.

A default standalone server can be started by issuing a 'start' command on the router. Obviously 'stop' and 'restart' are also supported.

The default ip/port the standalone will bind to are: localhost:8082, which you can then use to connect to your server via a browser.

h2. Custom ip/port

Using a custom port and or ip can be attained by setting a config file in the router with the 'CONFIG' variable, and in that config list the following settings:

<pre>

[standalone]

port = 4001

</pre>

If you want to use 1 config file for multiple standalone servers, eg, you want to centralize certain settings, but have others on a server by server basis, you can issue a more specific block for each server using the package name as defined in the router using the 'PACKAGE' variable. For example, a demo router would look like this:

<pre>

<code class="python">

import uweb

import pages

CONFIG = '../demo.conf'

PACKAGE = 'demo'

PAGE_CLASS = pages.PageMaker

ROUTES = (

    ('/', 'requestIndex'),

    ('(/.*)', 'requestFail'))

uweb.ServerSetup()

</code>

</pre>

This would read from the ../demo.conf file (relative to the location of the router) and look for both a [standalone] and a [standalone:demo] subsection

<pre>

[standalone:demo]

port = 8080

[standalone]

access_logging = 0

error_logging = 0

</pre>

As you can see, by setting the access_logging and error_logging vars you can make sure the server doesn't log these actions and thus speeds up a bit.