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, or Resin
Although Solr strives to be agnostic of the Locale where the server is running, some code paths may inadvertently be depending on the System default Locale, or Charset. (In particular, there are known bugs in Sun's JVM dealing with XSLTs in non English locales) It is recommended that when running Solr you set the following system properties: -Duser.language=en -Duser.country=US
- 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
- 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.