Apache Solr Documentation

6.2 Ref Guide (PDF Download)
Solr Tutorial
Solr Community Wiki

Older Versions of this Guide (PDF)

6.3 Draft Ref Guide Topics


This Unreleased Guide Will Cover Apache Solr 6.3

Skip to end of metadata
Go to start of metadata

This section describes how to install Solr. You can install Solr in any system where a suitable Java Runtime Environment (JRE) is available, as detailed below. Currently this includes Linux, OS X, and Microsoft Windows. The instructions in this section should work for any platform, with a few exceptions for Windows as noted.

Got Java?

You will need the Java Runtime Environment (JRE) version 1.8 or higher. At a command line, check your Java version like this:

The exact output will vary, but you need to make sure you meet the minimum version requirement. We also recommend choosing a version that is not end-of-life from its vendor. If you don't have the required version, or if the java command is not found, download and install the latest version from Oracle at http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Installing Solr

Solr is available from the Solr website at http://lucene.apache.org/solr/.

For Linux/Unix/OSX systems, download the .tgz file. For Microsoft Windows systems, download the .zip file. When getting started, all you need to do is extract the Solr distribution archive to a directory of your choosing. When you're ready to setup Solr for a production environment, please refer to the instructions provided on the Taking Solr to Production page. To keep things simple for now, extract the Solr distribution archive to your local home directory, for instance on Linux, do:

Once extracted, you are now ready to run Solr using the instructions provided in the Running Solr section.


  • No labels


  1. The directions above using the example directory provide a roughly configured and older version of Jetty running Solr from unclean directories.  For a clean install, read the SolrInstall topic linked above with topics for specific application servers, or use a stand-alone server such as Solr-Undertow (easy to configure, self-contained, high performance) for running without an application server.

  2. These instructions don't work for solr 5.3.  I had to build solr and build the server:

    cd solr-{version}

    ant compile

    cd solr

    ant server


    1. I'm puzzled about what didn't work, particularly since the instructions on this page don't say anything about compiling, they're for downloading the release distro rather than building from source. Can you tell us what specifically about the instructions failed?

      Did you perhaps download the solr-XXX-src.tgz rather than solr-xxx.tgz?  That's the source release, not the binary distro so in that case you'd have to compile things.

      BTW, it's not necessary to 'ant compile' when building from Solr, just the 'ant server' step is sufficient. I often do an 'ant dist' too especially if I'm going to be using SolrJ libs....

      1. Your 100% right it was the source.(I did not realize until you asked)
        100% My mistake.

      2. Maybe there should be a comment for people that make mistakes like me?  (if you downloaded the source you will have to build it... or something like that, just a thought, but yeah still my fault for not reading the name of the package)


  3. Can these Configurations be used for production development also?

    1. There are no configurations on this page. In future, please do not add unrelated spam links to your comments or we'll be forced to ban you.

  4. I followed instructions here to install solr-5.3.1.tgz on a Redhat server. Solr starts okay with command "./solr start -f"; and RESTful endpoint of dataimport works fine. However, when opening browser to page "http://<server-ip>:8983/solr/", it shows a partially rendered page with a message "SolrCore Initialization Failures". The console log shows a bunch of WARN like 

    268080 WARN (qtp-904474692-17) [ ] o.e.j.s.ServletHandler Error for /solr/css/styles/dashboard.css
    java.lang.NoSuchMethodError: javax/servlet/http/HttpServletRequest.isAsyncSupported()Z
    at org.eclipse.jetty.servlet.DefaultServlet.sendData(DefaultServlet.java:922)
    at org.eclipse.jetty.servlet.DefaultServlet.doGet(DefaultServlet.java:533)
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:617)
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:723)
    at org.eclipse.jetty.servlet.ServletHolder.handle(ServletHolder.java:808)
    at org.eclipse.jetty.servlet.ServletHandler$CachedChain.doFilter(ServletHandler.java:1669)
    at org.apache.solr.servlet.SolrDispatchFilter.doFilter(SolrDispatchFilter.java:206)
    at org.apache.solr.servlet.SolrDispatchFilter.doFilter(SolrDispatchFilter.java:179)
    at org.eclipse.jetty.servlet.ServletHandler$CachedChain.doFilter(ServletHandler.java:1652)
    at org.eclipse.jetty.servlet.ServletHandler.doHandle(ServletHandler.java:585)
    at org.eclipse.jetty.server.handler.ScopedHandler.handle(ScopedHandler.java:143)
    at org.eclipse.jetty.security.SecurityHandler.handle(SecurityHandler.java:577)
    at org.eclipse.jetty.server.session.SessionHandler.doHandle(SessionHandler.java:223)
    at org.eclipse.jetty.server.handler.ContextHandler.doHandle(ContextHandler.java:1127)


    Also, at the start of the console log, there is a line seems to be related,

    25783 WARN (main) [ ] o.e.j.s.SecurityHandler ServletContext@o.e.j.w.WebAppContext@45915b40{/solr,file:/root/solr-5.3.1/server/solr-webapp/webapp/,STARTING}{/root/solr-5.3.1/server/solr-webapp/webapp} has uncovered http methods for path: /

    Anyone has an idea? Thanks!!


    1. Please use the solr-user mailing list http://lucene.apache.org/solr/resources.html#community to ask questions, not the wiki.

      Exactly how did you install and start Solr? Looks like you somehow have servlet api 2.4 on your classpath instead of v 3.1. If this does not solve your issue, please continue discussion in a new solr-user mail thread and not here (smile)

      1. This is what I did ... I will check the classpathes ... thanks!

        cd ~/
        tar zxf /tmp/solr-5.3.1.tgz
        cd solr-5.3.1/bin
        ./solr start -f
  5. Navigate to the location where you have downloaded the tgz file. To keep things simple for now, extract the Solr distribution archive to your local home directory, for instance on Linux, do:

    cd ~/

    tar zxf  solr-[0-9].[0-9].[0-9].tgz