[NANOWEB DOCUMENTATION]

NANOWEB, the aEGiS PHP web server

Installing nanoweb

Installation of the nanoweb web server should be fairly easy, as the commandline tool install-sh will do the work for most of you.
For Windows you may wish to use the install.bat (which should be customized to your needs before running it). Please have a look into the README about Windows installation also.

Compiling PHP

Nanoweb requires the interpreter of the PHP scripting language to be present on your system. You can get the source code from www.php.net, but it is often much better to use a precompiled package (for Windows especially!) if there is one in your distributions CD set. However the precompiled ones often miss the pcntl extensions which gives mcuh more speed on UNIX systems, so you're encouraged to compile PHP yourself and to adopt it to your needs:

To compile it for »CGI« or »CLI« support (the latter one is often better suited for standalone scripts like nanoweb) all you need to do is to execute the configure program from the unpacked source tarball this way:

./configure --with-cgi --enable-cli --enable-sockets --enable-pcntl

You may want to add other very common configure options like --with-zlib to use mod_gzip, and --with-mysql to have MySQL-support compiled in (but see ./configure --help for a complete list).

make will start the build process, the binary should afterwards be installed using make install.

If compilation with the above instructions fails, then you should have a look into the README from the PHP tarball, which starts with a »quick install guide«.

Install nanoweb

Run ./install-sh and follow instructions ...
Starting from nanoweb 2.0 the install-sh will appear with a nice text or graphical user interface if you installed one of the "dialog" utilites (namely cdialog, Xdialog, whiptail or the one of the linux kernel tarball), so the installation or update should be much easier.

Type 'nanoctl start' to start the server and connect to http://localhost/ to see if it works.

install-sh commandline options


Installing under user-account

If you're not root you'll need to take special care for installtion and configuration (you can not run it on TCP port 80 as ordinary user). The best way to install it is then doing it by hand. You could just copy everything into one one directory under your home directory, this however requires to configure the directory names correctly inside the configuration files.



NANOWEB, the aEGiS PHP web server