This plugin allows you to index your wiki and ticket data in a full text search engine and search it from a button in the main navbar.

trac, plugin, search, full-text-search
pip install TracAdvancedSearch==0.6.0


Trac Advanced Search Plugin

An advanced search plugin for the open source Trac project ( This Trac plugin allows you to use a full-text search engine (such as Apache Solr) as the search backend for performing search in Trac. This plugin also includes a backend for Apache Solr (, but other plugins can use the extension point provided by this plugin to query a different backend.

This plugin is known to be compatible with Trac 0.12 with Solr 3.1, as well as Trac 1.0.1 with Solr 4.3.1.

See the interface in plugin-src/advsearch/ for details about which methods to implement.

See for more information about developing a Trac plugin.

Advanced Search Plugin Screenshot

How it works

Once your existing tickets/wiki documents are indexed in the backend you can make requests using the Advanced Search form. These searches will be handled by the search backend you have configured in trac.ini. When new documents or tickets are added upsert_document() will be called on each search backend to update the index immediately.

Project Status

Stable, and active.


The following python packages are required for the solr backend.

pysolr (


This assumes you already have a Trac environment setup.

  1. Build and install the plugin
cd plugin-src
python bdist_egg
cp ./dist/TracAdvancedSearch-*.egg <trac_environment_home>/plugins
  1. Setup the search backend. If you're using solr, copy and modify the configuration files provided.
cp ./solr/conf/* <solr_home>/conf
  1. Index your current tickets and wiki pages in the search backend. If you're using solr, see ./solr/conf/data-config.xml

  2. Configure your trac.ini (see the Configuration section below).

  3. Restart the trac server. This will differ based on how you are running trac (apache, tracd, etc).

That's it. You should see an Advanced Search button in the main navbar.


In trac.ini you'll need to configure whichever search backend you're using. If you're using the default pysolr backend, add something like this:

solr_url = http://localhost:8983/solr/
timeout = 30

menu_label = Real Search

button_label and timeout are both optional.

The default pysolr backend queries to solr for indexing synchronously. If you want to do indexing asynchronously, add like this:

async_indexing = true
async_queue_maxsize = 10000  # if 0, the queue size is infinity

You'll also need to enable the components.

tracadvsearch.advsearch.* = enabled
tracadvsearch.backend.* = enabled

Remove Search button

To disable the old search add the following to <project_env>/conf/trac.ini. Your trac.ini may already have a components section.

[components] = disabled