Funnelback logo


Configuring Funnelback's embedded web server


Funnelback includes an embedded web server which is used to provide access to the administration and search interfaces. While it is sometimes recommended that a native web server (Apache or IIS) be used for serving the classic search interface, Funnelback's embedded web server (Jetty) is used and recommended for most installations.

Jetty is required for access to the Funnelback administration interface and for access to the Funnelback modern UI.

Restarting the web server

On Microsoft Windows the web server can be restarted through the Windows Services control panel (the service is called Funnelback). On other platforms, the web server can be controlled with with the ./etc/init.d/funnelback-jetty-webserver script.

Configuration files

The configuration files for the web server are located at INSTALL_DIR/web/conf/

  • funnelback-jetty-http.xml controls the display of the search interface (via http)
  • funnelback-jetty-https.xml controls the display of the administration interface (via https)

These configuration files allow the internal web server to be configured as described in the Jetty web server documentation at Note that when changing properties such at the port or hostname on which Funnelback is provided, Jetty automatically reads the configuration from Funnelback's INSTALL_DIR/conf/global.cfg file, so that file must be changed instead.

Jetty permissions

The user and group that Funnelback runs as can be configured using the funnelback-daemon-setuid.xml configuration file in INSTALL_DIR/web/conf. This allows the specification of a uid (not username) in the <Set name="uid"> element and a gid in the <Set name="gid"> element. Restarting Funnelback after this will apply the changes.

Note: The selected user must be given permission to read, modify and execute files within the Funnelback install directory.

Configuring the server ports

Jetty's ports are configured when Funnelback is installed. The default ports used by Funnelback are port 80 for the Jetty http service and port 8443 for the Jetty https service (used by the administration console).

The ports can be changed by editing the jetty.search_port and jetty.admin_port in INSTALL_DIR/conf/global.cfg. jetty.search_port sets the http port used by Funnelback and jetty.admin_port sets the https port.

See also:

top ⇑