About This Guide

The default port when running Solr is 8983. The samples, URLs and screenshots in this guide may show different ports, because the port number that Solr uses is configurable.

If you have not customized your installation of Solr, please make sure that you use port 8983 when following the examples, or configure your own installation to use the port numbers shown in the examples.

Similarly, URL examples use localhost throughout; if you are accessing Solr from a location remote to the server hosting Solr, replace localhost with the proper domain or IP where Solr is running.

For example, we might provide a sample query like:

http://localhost:8983/solr/gettingstarted/select?q=brown+cow

There are several items in this URL you might need to change locally. First, if your server is running at "www.example.com", you’ll replace "localhost" with the proper domain. If you aren’t using port 8983, you’ll replace that also. Finally, you’ll want to replace "gettingstarted" (the collection or core name) with the proper one in use in your implementation. The URL would then become:

http://www.example.com/solr/mycollection/select?q=brown+cow

Path information is given relative to solr.home, which is the location under the main Solr installation where Solr’s collections and their conf and data directories are stored.

In many cases, this is in the server/solr directory of your installation. However, there can be exceptions, particularly if your installation has customized this.

In several cases of this Guide, our examples are built from the "techproducts" example (i.e., you have started Solr with the command bin/solr -e techproducts). In this case, solr.home will be a sub-directory of the example/ directory created for you automatically.

See also the section Solr Home for further details on what is contained in this directory.

Solr has two styles of APIs that currently co-exist. The first has grown somewhat organically as Solr has developed over time, but the second, referred to as the "V2 API", redesigns many of the original APIs with a modernized and self-documenting API interface.

In many cases, but not all, the parameters and outputs of API calls are the same between the two styles. In all cases the paths and endpoints used are different.

Throughout this Guide, we have added examples of both styles with sections labeled "V1 API" and "V2 API". As of the 7.2 version of this Guide, these examples are not yet complete - more coverage will be added as future versions of the Guide are released.

The section v2 API provides more information about how to work with the new API structure, including how to disable it if you choose to do so.

All APIs return a response header that includes the status of the request and the time to process it. Some APIs will also include the parameters used for the request. Many of the examples in this Guide omit this header information, which you can do locally by adding the parameter omitHeader=true to any request.

Special notes are included throughout these pages. There are several types of notes: