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 published via two editions:
- Embedthis Appweb Enterprise Edition
- Embedthis Appweb Community Edition
The Enterprise edition is a royalty free, commercially licensed edition with options for commercial maintenance and support. Contact firstname.lastname@example.org for details. The Community edition is an open source licensed edition of Appweb provided under the GPL license.
You may use Appweb with either license. Please read Licensing for further 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 )
The following operating systems may be supported by recompiling Appweb from source.
- FreeBSD 10.X
- Linux 3 and later
- Mac OS 10.11 and later
- VxWorks 7.X and later (unsupported)
- Windows 8 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:
- 2-4 MB Disk/ROM space — depending on the application size
- 2-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 2017 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.