mod_proxy_html is an output filter to rewrite HTML links in a proxy situation, to ensure that links work for users outside the proxy. It serves the same purpose as Apache's ProxyPassReverse directive does for HTTP headers, and is an essential component of a reverse proxy.

For example, if a company has an application server at that is only visible from within the company's internal network, and a public webserver, they may wish to provide a gateway to the application server at When the application server links to itself, those links need to be rewritten to work through the gateway. mod_proxy_html serves to rewrite <a href="">foobar</a> to <a href="">foobar</a> making it accessible from outside.

April 2006 Added a new FAQ to deal with some of the questions people commonly mail me with.

Origins and History

The current version is 3.0.1. Features that are new in Version 3 are highlighted in these pages.. The previous stable and widely-used version 2.5.2 (April 7th 2006) is also available.

The origins and history of mod_proxy_html are documented in a separate page.

Related Modules


The original capabilities of mod_proxy_html are:

Important changes from 1.x to 2.x include:

Important changes from 2.x to 3.x include:

With these new features, mod_proxy_html might find applications outside a proxy context. But reverse-proxying remains its primary purpose, while mod_publisher offers a far wider range of capabilities for other applications.

How to use it

We now have three documents: a tutorial on reverse proxying (including basic use of mod_proxy_html), a user guide, and a configuration guide. Please read the tutorial first, unless you already know it all!

Tutorial: Reverse Proxying

A tutorial on reverse proxying with Apache by the author of this module is available at ApacheTutor. This offers an in-depth overview of the problem solved by this module, in context.

Configuration Guide

Reference documentation for the configuration directives implemented by mod_proxy_html.

Technical Guide

This focuses on the module itself, separate from the context of the problem it solves.

Frequently Asked Questions

Some questions come up repeatedly (sometimes in the form of bug reports, feature requests, or patches). Please see the FAQ before mailing anything.


Please don't just email with support questions. If you need more help than is provided in the documentation, you may register for support. If you don't want to register, you may also ask questions in a public forum such as the apache users mailinglist, where your question and any responses will be on record for others to see.


mod_proxy_html.c source code is available under the GNU General Public License (GPL) Version 2. As with other opensource modules, we can consider alternative licenses by request.

Registered Users may request binaries for any available platform: there is no charge to upgrade from earlier versions. Since April 2004, binaries have been supplied to registered users for Linux, FreeBSD, Windows, Solaris and MacOSX. If you need it for another platform, please ask.


Users of the FreeBSD port of mod_proxy_html, please see this fix.