embedthis / Appweb
Programming Languages
Projects that are alternatives of or similar to Appweb
Embedthis Appweb Community Edition
Appweb is a compact, fast and secure web server for embedded applications. It supports HTTP with a web server and HTTP client utility.
This repository does not contain the Appweb Enterprise Edition source code, but it is the repository for issues and bug reports for both the Appweb Community and Enterprise editions. Contact [email protected] for access to the Enterprise Edition source code.
Branches
The repository has several branches:
- master - Most recent release of the software.
- X.X - Archived prior release branches for maintenance.
Licensing
See LICENSE.md for details.
Documentation
See https://www.embedthis.com/appweb/doc/index.html.
Building from Source
You can build Appweb with make, Visual Studio, Xcode or MakeMe.
The IDE projects and Makefiles will build with ESP and SSL using the MbedTLS TLS stack. To build with CGI, OpenSSL or other modules, read the projects/README.md for details.
To Build with Make:
Linux or MacOS
make
or to see the commands as they are invoked:
make SHOW=1
You can pass make variables to tailor the build. For a list of variables:
make help
To run
make run
Windows
First open a Windows cmd prompt window and then set your Visual Studio environment variables by running vcvarsall.bat from your Visual Studio installation folder.
Then run a Windows cmd prompt window and type:
make
To Build with Visual Studio:
Open the solution file at:
projects/appweb-windows-default.sln
Then select Build -> Solution.
To run the debugger, right-click on the "appweb" project and set it as the startup project. Then modify the project properties and set the Debugging configuration properties. Set the working directory to be:
$(ProjectDir)\..\..\test
Set the arguments to be -v
Then start debugging.
To Build with Xcode.
Open the solution file:
projects/appweb-macosx-default.sln
Choose Product -> Scheme -> Edit Scheme, and select "Build" on the left of the dialog. Click the "+" symbol at the bottom in the center and then select all targets to be built. Before leaving this dialog, set the debugger options by selecting "Run/Debug" on the left hand side. Under "Info" set the Executable to be "appweb", set the launch arguments to be "-v" and set the working directory to be an absolute path to the "./test" directory in the appweb source. The click "Close" to save.
Click Project -> Build to build.
Click Project -> Run to run.
To build with MakeMe:
To install MakeMe, download it from https://www.embedthis.com/makeme/.
./configure
me
For a list of configure options:
./configure --help
To install:
If you have built from source using Make or MakeMe, you can install the software using:
sudo make install
or
sudo me install
To uninstall
sudo make uninstall
or
sudo me uninstall
To Run:
The src/server directory contains a minimal appweb.conf suitable for production use without SSL. The test directory contains an appweb.conf that is fully configured for testing. When using the src/server/appweb.conf, change to the src/server directory to run. When using the test/appweb.conf, change to the test directory to run.
To Test:
Build with MakeMe and then:
./configure
me
me test