title: install parent: Command Reference grand_parent: Reference nav_order: 55

install

Installs a local Solr node for use with the start and stop commands. This is a low-level provisioning command for when you want manual control over the Solr lifecycle rather than having run manage it automatically.

Syntax

solr-orbit install [OPTIONS]

Options

Distribution

OptionDefaultDescription
--distribution-versionSolr version to install (e.g., 9.10.1)
--distribution-repositoryreleaseRepository to download Solr from
--revisionSource code revision for the from-sources pipeline

Runtime

OptionDefaultDescription
--runtime-jdkMajor JDK version to use (e.g., 21)
--solr-modulesComma-separated Solr modules to enable (e.g., extraction)
--plugin-paramsComma-separated key:value pairs passed to all configured plugins

Cluster configuration

OptionDefaultDescription
--cluster-configdefaultsCluster config preset to apply
--cluster-config-paramsComma-separated key:value variable overrides for the cluster config
--cluster-config-pathLocal path to a cluster configuration directory
--cluster-config-repositoryGit URL for a custom cluster-config repository
--cluster-config-revisionGit revision of the cluster-config repository

Node placement

OptionDefaultDescription
--network-host127.0.0.1Host address for Solr to bind to
--http-port38983HTTP port for the Solr node
--node-namebenchmark-node-0Name for the installed node
--master-nodesComma-separated list of master node names (for multi-node setups)
--seed-hostsComma-separated seed host addresses for cluster discovery

Example

Install Solr 9.10.1 locally on the default port:

solr-orbit install \
  --distribution-version 9.10.1 \
  --cluster-config defaults

Install on a custom port with a specific JDK:

solr-orbit install \
  --distribution-version 9.10.1 \
  --runtime-jdk 21 \
  --http-port 18983 \
  --node-name my-node

After installation, use the printed installation ID with the start command.

See also