Welcome to Tengine!

If you see this page, the Tengine web server is running and configured. You may now place your application or static files in the document root.

For additional information about Tengine please visit tengine.taobao.org.


About Tengine

Tengine is a fork of nginx maintained by the Taobao team. It keeps tight compatibility with upstream nginx while adding modules for dynamic upstream resolution, request limiting and concurrency tuning that grew out of large-scale e-commerce traffic patterns.

Most nginx configuration syntax works without modification, so existing sites can usually be moved across with no changes. Modules that exist only in Tengine produce a warning if you switch back to upstream nginx, but the rest of the config remains valid.

If you are coming from upstream nginx, start by enabling the reqstat module to get per-zone request counters out of the box.

Common configuration changes

  1. Replace the file in /usr/share/tengine/html/index.html with your own.
  2. Add a server block under /etc/tengine/conf.d/ describing your site.
  3. Validate with tengine -t.
  4. Reload with sudo systemctl reload tengine.
  5. Inspect the access log to confirm requests reach the new site.

Modules worth knowing

tengine-edge-12 · default site · pid 14002