Welcome to the Embedthis Appweb™ installation release notes. This document provides release-specific information for Appweb. This package contains a pre-built stand-alone (binary) web server and the development libraries and headers needed to embed Appweb in a device or application.
This software is copyrighted and distributed under license. It is available under a GPLv2 open source license and an optional commercial license. Please read LICENSE.md for details.
Appweb includes support for several external packages such as OpenSSL and PHP. These packages have their own licenses. Make sure you check the relevant package license details to ensure you are complying with their licenses.
Binary releases are supplied for the following operating systems.
- Windows (x86)
- Mac OS X (Mountain Lion-x64)
The following operating systems may be supported by recompiling Appweb from source.
- FreeBSD 10.X
- Linux 2.6 and later
- Mac OS X 10.9 and later
- VxWorks 6.X
- Windows 7 and later
The following CPU architectures are supported: arm, mips, ppc, xscale, x86, x64, sparc.
Run-time System Requirements
To deploy Appweb in an embedded environment, you will need at least the following:
- 1-2 MB Disk/ROM space — depending on the application size
- 1-4 MB RAM
Build and Tool Requirements
If you are building the software from source or using Expansive to render web applications you may require:
- MakeMe version 0.8.6 or later to build with MakeMe.
- Pak version 0.10.0 or later to install packages.
- Expansive version 0.5.0 or later to render web sites.
Development Environment Hardware Platform Support
If you wish to build Appweb from source code, you will need to use a "C" compiler and associated development tools. Several development environments are supported. You may choose any of the following to compile and build samples and source code.
- Linux GNU tools
- Mac Xcode 6.4 and later
- Windows Visual Studio 2013 and later
- WindRiver Tornado Development Tools.
Debug Trace and Logging
Appweb has logging and request trace facilities that can help when debugging configuration issues or developing your application code that uses Appweb. You can vary the level of logging via the --log logfile command line switch for the appweb commands. The log command line switch has the format:
appweb --log logFile:logLevel
Use the -v switch to trace to the standard output at level 2.
The log level can be from 0 to 5, with 5 being the most verbose level.
Similarly you can emit HTTP request trace using the --trace switch.
appweb --trace traceFile:traceLevel
The -v switch will emit request trace to the standard output at level 2 combined with the error log.