Home Appweb Features Download Licensing
Getting Started Quick Start Installing Appweb Starting and Stopping Running as a Service Release Notes Building from Source Building with CGI Building with FastCGI Building with Proxy Building with OpenSSL Building with PHP
User's Guide Configuring Appweb Configuration Directives Web Frameworks Using Loadable Modules Ports and Binding Routing Requests Request Pipeline Multi-Language Content User Authentication Logging Caching Virtual Hosts Secure Sockets (SSL) Http Client Security Considerations Monitoring and Defending File Upload WebSockets Man Pages
Developer's Guide Embedding Appweb Creating Appweb Modules Creating Appweb Handlers Using the Action Handler Creating Pipeline Stages Serving Pages from ROM Migrating from Earlier Releases
Reference Guide Compatibility Native APIs Appweb Architecture Appweb Memory Allocation Multithreaded Programming HTTP References
Appweb News Appweb Web Site
Samples chroot-server cpp-handler cpp-module deploy-server esp-hosted esp-upload login-basic login-database max-server min-server secure-server simple-action simple-client simple-handler simple-module simple-server spy-filter ssl-server tiny-server typical-server websockets-chat websockets-echo websockets-output
Links Embedthis Web Site Embedthis Blog Twitter
Embedthis Appweb Site Appweb News Blog Twitter
Home
/
Getting Started
/
Building with CGI

Building Appweb with CGI Support

Appweb includes support for CGI but it is not enabled by default to minimize the security surface. If you wish to use CGI, you need to enable CGI and rebuild Appweb.

To build Appweb with CGI support:

make ME_COM_CGI=1

CGI Configuration

The following default configuration is enabled in appweb.conf once Appweb is built with CGI support. 

AddHandler cgiHandler exe cgi cgi-nph out bat cmd pl py php
ScriptAlias /cgi-bin/ "${DOCUMENTS}/../cgi-bin"
Action application/x-perl /usr/bin/perl
Action application/x-python /usr/bin/python
Action application/x-lua /usr/bin/lua
Action application/x-ruby /usr/bin/ruby
LimitProcesses 10
CgiPrefix CGI_
CgiEscape on

This configuration will run scripts and executables in the ../cgi-bin directory which should be outside the web documents directory. It is setup to handle Perl, Python, Lua and Ruby scripts. On Windows, it will run .bat and .cmd scripts. This configuration limits CGI to at most 10 simultaneous requests. CGI environment variables will be escaped for security and will have a "CGI_" prefix.

Consult the CGI Directives for more information.

FastCGI

Appweb supports FastCGI as an alternative way to run CGI programs on Unix style systems.

© Embedthis Software. All rights reserved.