Welcome to The Uniform Server and this documentation, which is for the Zero series. The Uniform Server is a free and open source Windows Apache-MySQL-PHP-Perl server suite. The Uniform Server is an excellent system for both beginning webmasters and experienced developers. It is a full-power web-server suitable for production use, but small enough to carry on a USB memory stick, or even a camera's flash drive. Covered in this document is the pre-configured server (UniServer Zero 11_x_x_ZeroXI) and modules required to assemble your own bespoke server.
Uniform Zero takes a fresh look at Apache, MySQL, PHP and Perl portability. Uniform server has been redesigned from the ground up; emphasis is given to reducing code size. This is achieved through a modular implementation using plugins. Install only the plugins you require this avoids the dreaded bloat-ware scenario. Server control is provided by UniController a Pascal application written and compiled using Lazarus.
For new users creating a bespoke server can be daunting to address this UniServer Zero releases 11_x_x_ZeroXI are versions with pre-installed Zero XI modules (plugins) producing a standard WAMP (Windows, Apache, MySQL and PHP) server package. This package is fully portable allowing you to run servers from a USB memory stick.
In the context of this documentation portability is defined as an application that does not install data in the registry on a host PC. Generally applications ported to Windows from a Unix environment are inherently portable for example Apache, MySQL, PHP and Perl. These require just a few minor tweaks to run them in a portable mode
Applications can be run either as a standard program or as a service Uniform Server Zero supports both methods. Running an application as a standard program requires that application to be manually restarted after powering-up a PC and logging in. This disadvantage is resolved by optionally placing an entry in the start-up menu to provide automatic restarting after logging in. Although not portable it is a small concession for users that require this functionality. In contrast applications run as a service automatically start after powering-up a PC, this is the preferred method when running a production server. Again this is not portable remember to uninstall services before moving servers.
Similarly, editing the Windows hosts file is not a portable operation. That said Uniform Server Zero provides support to manually and automatically add and delete entries in this file.
We strongly suggest that you check over the points on this page as they provide important information that may help you avoid common problems. The following two sections “installation pre-configured server” and “installation bespoke server” will have you up and running in seconds. A more detailed step-by-step guide is provided on the quick start guide page.
Installation - pre-configured server
Installing is a misnomer! Nothing is installed to your PCs registry, all files are extracted to their appropriate location within the UniServer folder structure. To install the pre-configured server proceed as follows:
Installation - bespoke server
Again installing is a misnomer! Nothing is installed to your PCs registry all files are extracted to their appropriate location within the UniServer folder structure. Unlike a pre-configured server a bespoke server requires more work on your part, it is assembled from individual plugin modules as follows:
The Uniform Server Zeros base component is the controller application. Download and extract this base compont first as follows:
The Uniform Server Zero design is modular. Install only the plugins (modules) that you require. Each server requires a controller (covered above), which automatically detects installed plugins.
The extraction procedure is identical for all plugins and applies to both pre-configured and bespoke servers , proceed as follows:
Note: Full plugin details refer to Plugins - Modules page. The default list on this page contains modules for installing PHP an Apache module. While the alternative lists contains modules for running PHP as fast cgi for details refer to page Plugins - CGI
There is one aspect that needs to be validated. This is especially true if you have been unable to start the servers.
The installation (extraction) defaults to creating "C:\UniServerZ". The documentation examples assume this default. You can install The Uniform Server Zero in nearly any location, with the exception that the path to folder UniServerZ must not contain spaces. Do not use "C:\Program Files", for example (which has other problems as well, such as restricted permissions and system restore inconsistencies). We recommend installing to the drive root, such as "C:\" or "D:\" for simplicity, but other locations, such as "C:\test1\appserver" work just as well.
Note: The space character restriction is generic and applies to other WAMP stacks as well. Many applications that will be hosted on the server do not tolerate spaces in paths. The system restore issue applies mainly to individual component installs.
If the current installation is on a faulty path, the situation can eaily be resolved by just moving the UniServerZ directory to a proper location. You do not have to delete the directory and reinstall. For example, just rename "D:\bad path\UniServerZ" to "D:\good_loc\UniServerZ".
Two levels of help are provided, local help as instant pop-up message boxes and detailed help in this documentation directly linked by the Documentation controller button.
The security of your server is one of our primary concerns and for that reason the default settings are oriented for production. We take this seriously, and ask that if you believe that a setting is not right for production, you send us an email or post it in the forum. We will look into it and see if it should be changed.
In this light, before you can run the servers, several nag screens are presented. Initially you can click "no" to each of these. See the Quick start guide for further details.
In order to allow access to your server by other users (Internet or Intranet), you must manually enable the required functions. See Apache dropdown menu option Access and Passwords
This section covers the basics a new user should be aware of.
If you are using Windows XP as the OS platform, please be aware that you may need to install the Microsoft Visual C++ 2008 runtime library. This can be found at Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package ATL Security Update. Be sure to select the package appropriate for your OS and hardware (x86, x64 or IA64).
If you do not have the VC9 library, when you attempt to start the servers, you will get a runtime error popup.
The MySQL server supports IPv4 and IPv6; localhost resolves to 127.0.0.1 and ::1 respectively.
You can bypass the resolver by using an IP address; for example, you can force an IPv4 address by replacing localhost with 127.0.0.1.
Windows 7,8, Vista and UACThe startup executables have been marked as requiring Administrator privilege. When you start these programs, you must authorize this access in order to continue.
When you initially start the servers, your firewall will sense the programs' requests for IP access, and (typically) will require your authorization to change the security. If you have a third-party firewall activated (Symantic, ZoneAlarm, etc.), be sure to set the port access as required, since it may not display a message.
Apache and Skype both use standard port 80. If you have Skype running it will clash with your local server. To prevent Apache and Skype clashing you need to adjust the Skype settings as follows:
Where to next