# Lib Directories and Directives

Here we describe two simple and effective methods to make the `.jar` files for Solr plugins visible to Solr.

Such files are sometimes called "libraries" or "libs" for short. Essentially you can put them in some special places or explicitly tell Solr about them from your config.

If there is overlap or inter-dependencies between libraries, then pay attention to the order. You can think of it like a stack that is searched top-down. At the top are the lib directives in reverse order, then Solr core’s lib, then Solr home’s lib, then Solr itself.

## Lib Directories

There are several special places you can place Solr plugin `.jar` files:

• `<solr_home>/lib/`: The `.jar` files placed here are available to all Solr cores running on the node, and to node level plugins referenced in `solr.xml` — so basically everything. This directory is not present by default so create it. See Solr home directory.

• `<core_instance>/lib/`: In standalone Solr, you may want to add plugins just for a specific Solr core. Create this adjacent to the `conf/` directory; it’s not present by default.

• `<solr_install>/server/solr-webapp/webapp/WEB-INF/lib/`: The `.jar` files for Solr itself and it’s dependencies live here. Certain plugins or add-ons to plugins require placement here. They will document themselves to say so.

Solr incorporates Jetty for providing HTTP server functionality. Jetty has some directories that contain `.jar` files for itself and its own plugins / modules or JVM level plugins (e.g., loggers). Solr plugins won’t work in these locations.

## Lib Directives in SolrConfig

Both plugin and resource file paths are configurable via `<lib/>` directives in `solrconfig.xml`. When a directive matches a directory, then resources can be resolved from it. When a directive matches a `.jar` file, Solr plugins and their dependencies are resolved from it. Resources can be placed in a `.jar` too but that’s unusual. It’s erroneous to refer to any other type of file.

A `<lib/>` directive must have one (not both) of these two attributes:

• `path`: used to refer to a single directory (for resources) or file (for a plugin `.jar`)

• `dir`: used to refer to all direct descendants of the specified directory. Optionally supply a `regex` attribute to filter these to those matching the regular expression.

All directories are resolved as relative to the Solr core’s `instanceDir`.

These examples show how to load contrib modules into Solr:

``````  <lib dir="${solr.install.dir:../../../..}/contrib/extraction/lib" regex=".*\.jar" /> <lib dir="${solr.install.dir:../../../..}/dist/" regex="solr-cell-\d.*\.jar" />

<lib dir="${solr.install.dir:../../../..}/contrib/clustering/lib/" regex=".*\.jar" /> <lib dir="${solr.install.dir:../../../..}/dist/" regex="solr-clustering-\d.*\.jar" />

<lib dir="${solr.install.dir:../../../..}/contrib/langid/lib/" regex=".*\.jar" /> <lib dir="${solr.install.dir:../../../..}/dist/" regex="solr-langid-\d.*\.jar" />

<lib dir="${solr.install.dir:../../../..}/contrib/velocity/lib" regex=".*\.jar" /> <lib dir="${solr.install.dir:../../../..}/dist/" regex="solr-velocity-\d.*\.jar" />
<lib dir="\${solr.install.dir:../../../..}/dist/" regex="solr-ltr-\d.*\.jar" />``````