Note: Solr already includes a working demo server in the example directory that you may use as a template. See the tutorial for more info.

These instructions are for setting up Solr in a different servlet container.


  • Java 1.5 or greater installed. (Note: starting with Solr 4, Java 1.6 will be required)
  • A servlet container such as Tomcat, Jetty, WildFly, or a stand alone runner (see configuration for each below)
  • A Solr distribution
  • For full international charset support, please make sure you use a full Java JDK, as opposed to the default JRE which is pre-installed on many computers

General Setup

  • Stop your servlet container
  • From the Solr distribution, copy the Solr war to the webapps directory of your servlet container as solr.war
  • From the Solr distribution, copy the example Solr home example/solr as a template for your Solr home.
  • Start the servlet container, passing the location of your Solr home. This may be done in a number of ways:
    • Set the java system property solr.solr.home to your Solr home. (ie: using the example jetty setup: java -Dsolr.solr.home=/some/dir -jar start.jar
    • Configure the servlet container such that a JNDI lookup of "java:comp/env/solr/home" by the Solr webapp will point to the Solr home.
    • The default Solr home is "solr" under the JVM's current working directory ($CWD/solr), so start the servlet container in the directory containing ./solr
  • Go to the Solr admin page to verify that the installation is working. It will be at http://localhost:8080/solr/admin
    • The servlet container may have started on a port other than 8080... check the servlet containers documentation if you don't know what this is.
    • If there is already a servlet container running at that port, yours may fail to start. Shut down the other one or change the port that yours is running at.

For information on working with more then one index, or more then one instance of Solr, please see MultipleIndexes.

Servlet Container or Environment Specific Tips

The following wiki pages provide helpful tips for using Solr in various Servlet Containers...

The following wiki pages provide helpful tips on using Solr in some specific environments...

Live CD/ Software Appliances for Solr

Here is a ready to deploy software appliance for Solr available in Live CD, HDD/USB Stick Image, Virtual Image for Vistualbox/Vmware/Xen/Amazon EC2 formats. Saves you time to install and configure Solr and lets you get started within minutes.

  • No labels