SOLR bulk indexing utility for the command line.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 4 commits behind miku:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Sometimes you need to index a bunch of documents really, really fast. Even with Solr 4.0 and soft commits, if you send one document at a time you will be limited by the network. The solution is two-fold: batching and multi-threading.

solrbulk expects as input a file with line-delimited JSON. Each line represents a single document. solrbulk takes care of reformatting the documents into the bulk JSON format, that SOLR understands.

solrbulk will send documents in batches and in parallel. The number of documents per batch can be set via -size, the number of workers with -w.


$ go get

There are also DEB and RPM packages available:


$ solrbulk
Usage of solrbulk:
  -commit int
    	commit after this many docs (default 1000000)
  -cpuprofile string
    	write cpu profile to file
  -memprofile string
    	write heap profile to file
    	optimize index
    	remove documents from index before indexing (use purge-query to selectively clean)
  -purge-pause duration
    	insert a short pause after purge (default 2s)
  -purge-query string
    	query to use, when purging (default "*:*")
  -server string
    	url to SOLR server, including host, port and path to collection
  -size int
    	bulk batch size (default 1000)
  -v	prints current program version
    	output basic progress
  -w int
    	number of workers to use (default 4)
  -z	unzip gz'd file on the fly


$ cat file.ldj
{"id": "1", "state": "Alaska"}
{"id": "2", "state": "California"}
{"id": "3", "state": "Oregon"}

$ solrbulk -verbose -server file.ldj

Some performance observations

  • Having as many workers as core is generally a good idea. However the returns seem to diminish fast with more cores.
  • Disable autoCommit, autoSoftCommit and the transaction log in solrconfig.xml.
  • Use some high number for -commit. solrbulk will issue a final commit request at the end of the processing anyway.
  • For some use cases, the bulk indexing approach is about twice as fast as a standard request to /solr/update.
  • On machines with more cores, try to increase maxIndexingThreads.


Try esbulk.