Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Xzero HTTP Application Server
C++ CMake HTML Shell VimL Lua Other

README.md

Xzero HTTP Application Web Server

Build status - Travis-ci Stories in Ready

x0d is a thin low-latency and scalable HTTP web server built on-top of the Xzero C++ HTTP Framework.

It supports a very expressive and natural configuration via the Flow configuration language and a number of standard plugins to become your web application server.

Features

  • Customizable Error Pages
  • Automatic Directory Indexing
  • on-the-fly executable upgrade with gracefully finishing currently active requests.
  • Easily Extensible via the Powerful Plugin System
  • SSL connection encryption
    • SSL Server Name Indication (SNI) extension
  • Dynamic Content Compression
  • Advanced Dynamic Load Balancer
    • Supporting different backend transports (TCP/IP, and UNIX Domain Sockets).
    • Supporting different backend protocols (HTTP and FastCGI)
    • Advanced Health Monitoring
    • JSON API for retrieving state, stats, and reconfiguring clusters (including adding/updating/removing backends).
    • Client Side Routing support
    • Sticky Offline Mode
    • X-Sendfile support, full static file transmission acceleration
    • HAproxy compatible CSV output
    • Object Cache
      • fully runtime configurable
      • client-cache aware
      • life JSON stats
      • supports serving stale objects when no backend is available
      • Vary response-header Support.
      • multiple update strategies (locked, shadowed)
  • Basic Authentication
    • including PAM authentication
  • Request Path Aliasing
  • Automatic Directory Listing
  • Apache-style access logging
  • User-directory Support
  • Browser Match Support
  • Customizable Expires & Cache-Control Response Header Control
  • instant mode (configuration-less basic HTTP serving)
  • CGI/1.1 Support

Installation Requirements

  • gcc >= 4.8.0 (for building only, CLANG >= 3.4 is also supported)
  • libev >= 4.0
  • cmake (for building only)
  • tbb, Threading Building Blocks (required)
  • zlib (optional & recommended, for compression)
  • bzip2 (optional & recommended, for compression)
  • gnutls (optional & recommended, for SSL/TLS encryption)
  • gtest (optional, for unit testing)

Building from Source on Ubuntu 14.04:

# Installs required dependencies
sudo apt-get install make cmake gcc-4.8 g++-4.8 libgnutls28-dev libgcrypt11-dev \
    libmysqlclient-dev libev-dev zlib1g-dev libbz2-dev pkg-config \
    libpcre3-dev libfcgi-dev libgoogle-perftools-dev libtbb-dev libpam-dev git

# If you want to built the tests, you must install libgtest-dev and then
# built it yourself
sudo apt-get install libgtest-dev
cd /usr/src/gtest && sudo cmake . && sudo make && \
     sudo cp -vpi libgtest*.a /usr/local/lib/; cd -

# Install git and clone repository
git clone git://github.com/xzero/x0.git && cd x0

# Now run cmake to bootstrap the build
cmake .

# Now compiling should just work.
make && sudo make install

# Run web server on port 8080
./x0d/src/x0d --instant=`pwd`/www/htdocs,8080

# or try its CLI help
./x0d/src/x0d -h

# have fun hacking and don't forget to checkout the just installed man pages ;-)

Build from Sources on Ubuntu 12.04

# Ensure required GCC (version 4.8)
sudo apt-get install python-software-properties
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-4.8 g++-4.8

# Installs required dependencies
sudo apt-get install make cmake libgnutls28-dev libgcrypt11-dev \
    libmysqlclient-dev libev-dev zlib1g-dev libbz2-dev pkg-config \
    libpcre3-dev libfcgi-dev libgoogle-perftools0 libtbb-dev libpam-dev git

# If you want to built the tests, you must install libgtest-dev and then
# built it yourself
sudo apt-get install libgtest-dev
cd /usr/src/gtest && sudo cmake -DCMAKE_C_COMPILER=$CC \
        -DCMAKE_CXX_COMPILER=$CXX . && sudo make && \
    sudo cp -vpi libgtest*.a /usr/local/lib/; cd -

# Install git and clone repository
git clone git://github.com/xzero/x0.git && cd x0

# Now run cmake to bootstrap the build
cmake -DCMAKE_C_COMPILER=/usr/bin/gcc-4.8 -DCMAKE_CXX_COMPILER=/usr/bin/g++-4.8 .

# Now compiling should just work.
make && sudo make install

# Run web server on port 8080
./x0d/src/x0d --instant=`pwd`/www/htdocs,8080

# or try its CLI help
./x0d/src/x0d -h

# have fun hacking and don't forget to checkout the just installed man pages ;-)

LICENSE

Copyright (c) 2009-2014 Christian Parpart <trapni@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Something went wrong with that request. Please try again.