GoAhead Web Server
Clone or download


Embedthis GoAhead Enterprise Edition

The most popular little embedded web server.


The repository has several branches:

  • master - Most recent release of the software.
  • dev - Current ongoing development.
  • X.X - Archived prior release branches for maintenance.


See LICENSE.md and https://www.embedthis.com/goahead/licensing.html for details.


See https://www.embedthis.com/goahead/doc/index.html.

Building from Source

You can build GoAhead with make, Visual Studio, Xcode or MakeMe.

The IDE projects and Makefiles will build with 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


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


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:


To Build with Visual Studio

Open the solution file at:


Then select Build -> Solution.

To run the debugger, right-click on the "goahead" 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:


Set the arguments to be -v

Then start debugging.

To Build with Xcode.

Open the solution file:


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 "goahead", set the launch arguments to be "-v" and set the working directory to be an absolute path to the "./test" directory in the goahead 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/.


For a list of configure options:

./configure --help

To run

me run

To install

If you have built from source using Make or MakeMe, you can install the software using:

sudo make install


sudo me install

To uninstall

sudo make uninstall


sudo me uninstall

To test

me test