OS Manuals

/opt/bin/start-selenium-standalone.sh

From docker-selenium-standalone 4.44.0.20260505-r0 (os), captured 2026-11-05 by running start-selenium-standalone.sh --help (exit 0). permalink

Selenium Grid Standalone configuration:
cat: '': No such file or directory
Starting Selenium Grid Standalone...
Appending Selenium option: --tracing false
Tracing is disabled
Using JAVA_OPTS:  -Dwebdriver.remote.enableTracing=false
"--session-request-timeout": couldn't convert "--session-retry-interval" to an integer
Usage: standalone [options]
  Options:
    --allow-cors
      Whether the Selenium server should allow web browser connections from
      any host
      Default: false
    --bind-bus
      Whether the connection string should be bound or connected. When true,
      the component will be bound to the Event Bus (as in the Event Bus will
      also be started by the component, typically by the Distributor and the
      Hub). When false, the component will connect to the Event Bus.
    --bind-host
      Whether the server should bind to the host address/name, or only use it
      to report its reachable url. Helpful in complex network topologies where
      the server cannot report itself with the current IP/hostname but rather
      an external IP or hostname (e.g. inside a Docker container).
      Default: true
    --config
      Config file to read from (may be specified more than once)
    --config-help
      Output detailed information about config options
      Default: false
    --connection-limit-per-session
      Let X be the maximum number of concurrent websocket connections per
      session. This will ensure one session is not able to exhaust the
      connection limit of the host
      Default: 10
    --delete-session-on-ui
      Enable capability to support deleting session on Grid UI. False by
      default
      Default: false
    --detect-drivers
      Autodetect which drivers are available on the current system, and add
      them to the Node.
      Default: true
    --disable-ui
      Disable the Grid UI
      Default: false
    -d, --distributor
      Url of the distributor.
    --distributor-backend-url
      Backend datastore URL for the Distributor implementation. Used by
      Redis-backed and other external implementations loaded via --ext.
      Example: redis://localhost:6379
    --distributor-host
      Host on which the distributor is listening.
    --distributor-implementation
      Full classname of non-default distributor implementation
      Default: org.openqa.selenium.grid.distributor.local.LocalDistributor
    --distributor-port
      Port on which the distributor is listening.
    --docker, -D
      Docker configs which map image name to stereotype capabilities (example:
      -D selenium/standalone-firefox:latest '{"browserName": "firefox"}')
    --docker-api-version
      Docker API version to use. Pin an API version instead of auto-detecting
      by implementation
    --docker-assets-path
      Absolute path where assets will be stored
    --docker-devices
      Exposes devices to a container. Each device mapping declaration must
      have  at least the path of the device in both host and container
      separated by a colon like in this example:
      /device/path/in/host:/device/path/in/container
    --docker-grouping-labels
      Users to specify custom labels for grouping dynamic containers. This
      will make the system more flexible for different platforms and use cases
    --docker-host
      Host name where the docker daemon is running
    --docker-host-config-keys
      Specify which docker host configuration keys should be passed to browser
      containers. Keys name can be found in the Docker API documentation, or
      by running `docker inspect` the node-docker container.
    --docker-port
      Port where the docker daemon is running
    --docker-server-start-timeout
      Max time (in seconds) to wait for the server to successfully start up,
      before cancelling the process.
    --docker-stop-grace-period
      Grace period (in seconds) to wait for browser and video containers to
      stop gracefully before they are forcibly terminated.
    --docker-url
      URL for connecting to the docker daemon
    --docker-video-image
      Docker image to be used when video recording is enabled
      Default: false
    --drain-after-session-count
      Drain and shutdown the Node after X sessions have been executed. Useful
      for environments like Kubernetes. A value higher than zero enables this
      feature.
      Default: 0
    --driver-configuration
      List of configured drivers a Node supports. It is recommended to provide
      this type of configuration through a toml config file to improve
      readability. Command line example: --driver-configuration
      display-name="Firefox Nightly" max-sessions=2
      webdriver-executable="/usr/local/bin/geckodriver"
      stereotype="{\"browserName\": \"firefox\", \"browserVersion\": \"86\",
      \"moz:firefoxOptions\": {\"binary":"/Applications/Firefox
      Nightly.app/Contents/MacOS/firefox\"}}"
    --driver-factory
      Mapping of fully qualified class name to a browser configuration that
      this matches against. --driver-factory
      org.openqa.selenium.example.LynxDriverFactory '{"browserName": "lynx"}'
    -I, --driver-implementation
      Drivers that should be checked. If specified, will skip
      autoconfiguration. Example: -I "firefox" -I "chrome"
      Default: []
    --enable-bidi
      Enable BiDi proxying in Grid. A Grid admin can disable BiDi if the
      network does not allow websockets. True by default
      Default: true
    --enable-cdp
      Enable CDP proxying in Grid. A Grid admin can disable CDP if the network
      does not allow websockets. True by default
      Default: true
    --enable-managed-downloads
      When enabled, the Grid node will automatically do the following: 1.
      Creates a temporary directory which will now represent the directory
      into which files downloaded by Chrome/Firefox/Edge browser will be
      under. 2. For every new session, a sub-directory will be created/deleted
      so that all files that were downloaded for a given session are stored
      in.
    --eventbus-heartbeat-period
      How often, in seconds, will the EventBus socket send heartbeats
      Default: 0
    --events-implementation
      Full classname of non-default event bus implementation
    --external-url
      External URL where component is generally available. Useful on complex
      network topologies when components are on different networks and proxy
      servers are involved.
    --grid-url
      Public URL of the Grid as a whole (typically the address of the Hub or
      the Router)
    --healthcheck-interval
      How often, in seconds, will the health check run for all Nodes.This
      ensures the server can ping all the Nodes successfully.
      Default: 120
    --heartbeat-period
      How often, in seconds, will the Node send heartbeat events to the
      Distributor to inform it that the Node is up.
      Default: 60
    --host
      Server IP or hostname: usually determined automatically.
    --http-logs
      Enable http logging. Tracing should be enabled to log http logs.
      Default: false
    --https-certificate
      Server certificate for https. Get more detailed information by running
      "java -jar selenium-server.jar info security"
    --https-private-key
      Private key for https. Get more detailed information by running "java
      -jar selenium-server.jar info security"
    --hub
      The address of the Hub in a Hub-and-Node configuration. This can be a
      plain hostname or IP address (`hostname`), in which case the Hub will be
      assumed to be `http://hostname:4444`, the `--grid-url` will be the same,
      `--publish-events` will be `tcp://hostname:4442` and
      `--subscribe-events` will be `tcp://hostname:4443`. If `hostname`
      contains a port number, that will be used for `--grid-url` but the URIs
      for the event bus will remain the same. Any of these default values may
      be overridden but setting the correct flags. If the hostname has  a
      protocol (such as `https`) that will be used too.
    --kubernetes-assets-path
      Absolute path where session assets will be stored
    --kubernetes-configs, -K
      Kubernetes configs which map image name to stereotype capabilities
      (example: -K selenium/standalone-firefox:latest '{"browserName":
      "firefox"}')
    --kubernetes-image-pull-policy
      Override image pull policy for browser containers (Always, IfNotPresent,
      Never). Auto-inherited from the Node Pod when running in K8s.
    --kubernetes-label-inherit-prefix
      Prefix filter for inheriting labels/annotations from the Node Pod to
      browser Jobs. Only labels/annotations starting with this prefix are
      inherited. Empty string inherits all.
      Default: se/
    --kubernetes-namespace
      Kubernetes namespace to create browser Jobs in
    --kubernetes-node-selector
      Override node selector for scheduling browser Pods (example:
      disktype=ssd,region=us-west). Auto-inherited from the Node Pod when
      running in K8s.
    --kubernetes-resource-limits
      Override resource limits for browser containers (example:
      cpu=1,memory=1Gi). Auto-inherited from the Node Pod when running in K8s.
    --kubernetes-resource-requests
      Override resource requests for browser containers (example:
      cpu=500m,memory=512Mi). Auto-inherited from the Node Pod when running in
      K8s.
    --kubernetes-server-start-timeout
      Max time (in seconds) to wait for the browser server to start up in the
      K8s Pod
    --kubernetes-service-account
      Override service account for browser Jobs. Auto-inherited from the Node
      Pod when running in K8s.
    --kubernetes-termination-grace-period
      Seconds to wait for containers to shut down gracefully before
      force-killing them
    --kubernetes-url
      Kubernetes API server URL. When set, connects to a remote cluster
      instead of using in-cluster or kubeconfig auto-discovery.
    --kubernetes-video-image
      Container image to use as a video recording sidecar
      Default: false
    --log
      File to write out logs. Ensure the file path is compatible with the
      operating system's file path. Windows path example:
      \\path\to\file\gridlog.log OR C:\path\path\to\file\gridlog.log
      Linux/Unix/MacOS path example: /path/to/file/gridlog.log
    --log-encoding
      Log encoding
    --log-level
      Log level. Default logging level is INFO. Log levels are described here
      https://docs.oracle.com/javase/7/docs/api/java/util/logging/Level.html
      Default: INFO
    --log-timestamp-format
      Format of the timestamp in log output
    --max-sessions
      Maximum number of concurrent sessions. Default value is the number of
      available processors.
      Default: 64
    --max-threads
      Maximum number of listener threads. Default value is: (available
      processors) * 3.
      Default: 0
    --newsession-threadpool-size
      The Distributor uses a fixed-sized thread pool to create new sessions as
      it consumes new session requests from the queue.This allows configuring
      the size of the thread pool. The default value is no. of available
      processors * 3. Note: If the no. of threads is way greater than the
      available processors it will not always increase the performance. A high
      number of threads causes more context switching which is an expensive
      operation.
      Default: 192
    --no-vnc-port
      If VNC is available, sets the port where the local noVNC stream can be
      obtained
      Default: 7900
    --node-down-failure-threshold
      Maximum number of consecutive session creation failures before the Node
      is marked as DOWN. This helps detect and isolate unhealthy Nodes that
      consistently fail to create sessions. A value of 0 (default) disables
      this feature, allowing unlimited retries. A value higher than zero
      enables this feature.
      Default: 0
    --node-implementation
      Full classname of non-default Node implementation. This is used to
      manage a session's lifecycle.
      Default: org.openqa.selenium.grid.node.local.LocalNodeFactory
    --override-max-sessions
      The # of available processors is the recommended max sessions value (1
      browser session per processor). Setting this flag to true allows the
      recommended max value to be overwritten. Session stability and
      reliability might suffer as the host could run out of resources.
      Default: false
    --password
      Password clients must use to connect to the server. Both this and the
      username need to be set in order to be used.
    --plain-logs
      Use plain log lines
      Default: true
    -p, --port
      Port to listen on. There is no default as this parameter is used by
      different components, for example Router/Hub/Standalone will use 4444
      and Node will use 5555.
    --publish-events
      Connection string for publishing events to the event bus
    --purge-nodes-interval
      How often, in seconds, will the Distributor purge Nodes that have been
      down for a while. This is calculated based on the heartbeat received
      from a particular node.
      Default: 30
    --register-cycle
      How often, in seconds, the Node will try to register itself for the
      first time to the Distributor.
      Default: 10
    --register-period
      How long, in seconds, will the Node try to register to the Distributor
      for the first time. After this period is completed, the Node will not
      attempt to register again.
      Default: 120
    --register-shutdown-on-failure
      If this flag is enabled, the Node will shut down after the register
      period is completed. This is useful for container environments to
      restart and register again. If restarted multiple times, the Node
      container status will be CrashLoopBackOff.
      Default: false
    --registration-secret
      Node registration secret
    --reject-unsupported-caps
      Allow the Distributor to reject a request immediately if the Grid does
      not support the requested capability.Rejecting requests immediately is
      suitable for Grid set up that does not spin up Nodes on demand.
      Default: false
    --relax-checks
      Relax checks on origin header and content type of incoming requests, in
      contravention of strict W3C spec compliance.
      Default: false
    --selenium-manager
      When drivers are not available on the current system, use, Selenium
      Manager.
      Default: false
    --service-configuration
      Configuration for the service where calls will be relayed to. It is
      recommended to provide this type of configuration through a toml config
      file to improve readability. Command line example:
      --service-configuration max-sessions=2 stereotype='{"browserName":
      "safari", "platformName": "iOS", "appium:platformVersion": "14.5"}}'
    --service-host
      Host name where the service that supports WebDriver commands is running
    --service-port
      Port where the service that supports WebDriver commands is running
    --service-protocol-version
      Enforce a specific protocol version in HttpClient when communicating
      with the endpoint service status
    --service-status-endpoint
      Endpoint to query the WebDriver service status, an HTTP 200 response is
      expected
    --service-url
      URL for connecting to the service that supports WebDriver commands, like
      an Appium server or a cloud service.
    --session-request-timeout
      Timeout in seconds. New incoming session request is added to the queue.
      Requests sitting in the queue for longer than the configured time will
      timeout.
      Default: 300
    --session-request-timeout-period
      In seconds, how often the timeout for new session requests is checked.
      Default: 10
    --session-retry-interval
      Session creation interval in milliseconds. If all slots are busy, new
      session request will be retried after the given interval.
      Default: 15
    --session-timeout
      Let X be the session-timeout in seconds. The Node will automatically
      kill a session that has not had any activity in the last X seconds. This
      will release the slot for other tests.
      Default: 300
    --sq, --sessionqueue
      Address of the session queue server.
    --sessionqueue-backend-url
      Backend datastore URL for the SessionQueue implementation. Used by
      Redis-backed and other external implementations loaded via --ext.
      Example: redis://localhost:6379
    --sessionqueue-batch-size
      Maximum batch size that can consumed from queue based on the available
      slots.
      Default: 192
    --sessionqueue-host
      Host on which the session queue server is listening.
    --sessionqueue-implementation
      Full classname of the non-default session queue implementation.
    --sessionqueue-port
      Port on which the session queue server is listening.
    --slot-matcher
      Full classname of non-default slot matcher to use. This is used to
      determine whether a Node can support a particular session.
      Default: org.openqa.selenium.grid.data.DefaultSlotMatcher
    --slot-selector
      Full classname of non-default slot selector. This is used to select a
      slot in a Node once the Node has been matched.
      Default: org.openqa.selenium.grid.distributor.selector.DefaultSlotSelector
    --structured-logs
      Use structured logs
      Default: false
    --sub-path
      A sub-path that should be considered for all user facing routes on the
      Hub/Router/Standalone
    --subscribe-events
      Connection string for subscribing to events from the event bus
    --tcp-tunnel
      Enable the transparent TCP tunnel for WebSocket connections (BiDi, CDP).
      When disabled, all WebSocket traffic is routed through
      ProxyWebsocketsIntoGrid instead of the direct byte-bridge. Disable for
      benchmarking the proxy path or in network topologies where the Router
      cannot open direct TCP connections to Nodes (e.g. Kubernetes
      port-forward setups).
      Default: true
    --tracing
      Enable trace collection
      Default: true
    --username
      User name clients must use to connect to the server. Both this and
      password need to be set in order to be used.
    --version
      Displays the version and exits.
      Default: false
    --vnc-env-var
      Environment variable to check in order to determine if a vnc stream is
      available or not.
      Default: [SE_START_XVFB, SE_START_VNC, SE_START_NO_VNC]
Options (106)
OptionDescriptionSource
--allow-corsWhether the Selenium server should allow web browser connections from any host Default: falsehelp
--bind-busWhether the connection string should be bound or connected.help
--bind-hostWhether the server should bind to the host address/name, or only use it to report its reachable url.help
--configConfig file to read from (may be specified more than once)help
--config-helpOutput detailed information about config options Default: falsehelp
--connection-limit-per-sessionLet X be the maximum number of concurrent websocket connections per session.help
--delete-session-on-uiEnable capability to support deleting session on Grid UI.help
--detect-driversAutodetect which drivers are available on the current system, and add them to the Node.help
--disable-uiDisable the Grid UI Default: falsehelp
-d, --distributorUrl of the distributor.help
--distributor-backend-urlBackend datastore URL for the Distributor implementation.help
--distributor-hostHost on which the distributor is listening.help
--distributor-implementationFull classname of non-default distributor implementation Default: org.openqa.selenium.grid.distributor.local.LocalDistributorhelp
--distributor-portPort on which the distributor is listening.help
--docker, -DDocker configs which map image name to stereotype capabilities (example:help
--docker-api-versionDocker API version to use.help
--docker-assets-pathAbsolute path where assets will be storedhelp
--docker-devicesExposes devices to a container.help
--docker-grouping-labelsUsers to specify custom labels for grouping dynamic containers.help
--docker-hostHost name where the docker daemon is runninghelp
--docker-host-config-keysSpecify which docker host configuration keys should be passed to browser containers.help
--docker-portPort where the docker daemon is runninghelp
--docker-server-start-timeoutMax time (in seconds) to wait for the server to successfully start up, before cancelling the process.help
--docker-stop-grace-periodGrace period (in seconds) to wait for browser and video containers to stop gracefully before they are forcibly terminated.help
--docker-urlURL for connecting to the docker daemonhelp
--docker-video-imageDocker image to be used when video recording is enabled Default: falsehelp
--drain-after-session-countDrain and shutdown the Node after X sessions have been executed.help
--driver-configurationList of configured drivers a Node supports.help
--driver-factoryMapping of fully qualified class name to a browser configuration that this matches against.help
-I, --driver-implementationDrivers that should be checked.help
--enable-bidiEnable BiDi proxying in Grid.help
--enable-cdpEnable CDP proxying in Grid.help
--enable-managed-downloadsWhen enabled, the Grid node will automatically do the following: 1.help
--eventbus-heartbeat-periodHow often, in seconds, will the EventBus socket send heartbeats Default: 0help
--events-implementationFull classname of non-default event bus implementationhelp
--external-urlExternal URL where component is generally available.help
--grid-urlPublic URL of the Grid as a whole (typically the address of the Hub or the Router)help
--healthcheck-intervalHow often, in seconds, will the health check run for all Nodes.This ensures the server can ping all the Nodes successfully.help
--heartbeat-periodHow often, in seconds, will the Node send heartbeat events to the Distributor to inform it that the Node is up.help
--hostServer IP or hostname: usually determined automatically.help
--http-logsEnable http logging.help
--https-certificateServer certificate for https.help
--https-private-keyPrivate key for https.help
--hubThe address of the Hub in a Hub-and-Node configuration.help
--kubernetes-assets-pathAbsolute path where session assets will be storedhelp
--kubernetes-configs, -KKubernetes configs which map image name to stereotype capabilities (example: -K selenium/standalone-firefox:latest '{"browserName": "firefox"}')help
--kubernetes-image-pull-policyOverride image pull policy for browser containers (Always, IfNotPresent, Never).help
--kubernetes-label-inherit-prefixPrefix filter for inheriting labels/annotations from the Node Pod to browser Jobs.help
--kubernetes-namespaceKubernetes namespace to create browser Jobs inhelp
--kubernetes-node-selectorOverride node selector for scheduling browser Pods (example: disktype=ssd,region=us-west).help
--kubernetes-resource-limitsOverride resource limits for browser containers (example: cpu=1,memory=1Gi).help
--kubernetes-resource-requestsOverride resource requests for browser containers (example: cpu=500m,memory=512Mi).help
--kubernetes-server-start-timeoutMax time (in seconds) to wait for the browser server to start up in the K8s Podhelp
--kubernetes-service-accountOverride service account for browser Jobs.help
--kubernetes-termination-grace-periodSeconds to wait for containers to shut down gracefully before force-killing themhelp
--kubernetes-urlKubernetes API server URL.help
--kubernetes-video-imageContainer image to use as a video recording sidecar Default: falsehelp
--logFile to write out logs.help
--log-encodingLog encodinghelp
--log-levelLog level.help
--log-timestamp-formatFormat of the timestamp in log outputhelp
--max-sessionsMaximum number of concurrent sessions.help
--max-threadsMaximum number of listener threads.help
--newsession-threadpool-sizeThe Distributor uses a fixed-sized thread pool to create new sessions as it consumes new session requests from the queue.This allows configuring the size of the thread pool.help
--no-vnc-portIf VNC is available, sets the port where the local noVNC stream can be obtained Default: 7900help
--node-down-failure-thresholdMaximum number of consecutive session creation failures before the Node is marked as DOWN.help
--node-implementationFull classname of non-default Node implementation.help
--override-max-sessionsThe # of available processors is the recommended max sessions value (1 browser session per processor).help
--passwordPassword clients must use to connect to the server.help
--plain-logsUse plain log lines Default: truehelp
-p, --portPort to listen on.help
--publish-eventsConnection string for publishing events to the event bushelp
--purge-nodes-intervalHow often, in seconds, will the Distributor purge Nodes that have been down for a while.help
--register-cycleHow often, in seconds, the Node will try to register itself for the first time to the Distributor.help
--register-periodHow long, in seconds, will the Node try to register to the Distributor for the first time.help
--register-shutdown-on-failureIf this flag is enabled, the Node will shut down after the register period is completed.help
--registration-secretNode registration secrethelp
--reject-unsupported-capsAllow the Distributor to reject a request immediately if the Grid does not support the requested capability.Rejecting requests immediately is suitable for Grid set up that does not spin up Nodes on…help
--relax-checksRelax checks on origin header and content type of incoming requests, in contravention of strict W3C spec compliance.help
--selenium-managerWhen drivers are not available on the current system, use, Selenium Manager.help
--service-configurationConfiguration for the service where calls will be relayed to.help
--service-hostHost name where the service that supports WebDriver commands is runninghelp
--service-portPort where the service that supports WebDriver commands is runninghelp
--service-protocol-versionEnforce a specific protocol version in HttpClient when communicating with the endpoint service statushelp
--service-status-endpointEndpoint to query the WebDriver service status, an HTTP 200 response is expectedhelp
--service-urlURL for connecting to the service that supports WebDriver commands, like an Appium server or a cloud service.help
--session-request-timeoutTimeout in seconds.help
--session-request-timeout-periodIn seconds, how often the timeout for new session requests is checked.help
--session-retry-intervalSession creation interval in milliseconds.help
--session-timeoutLet X be the session-timeout in seconds.help
--sq, --sessionqueueAddress of the session queue server.help
--sessionqueue-backend-urlBackend datastore URL for the SessionQueue implementation.help
--sessionqueue-batch-sizeMaximum batch size that can consumed from queue based on the available slots.help
--sessionqueue-hostHost on which the session queue server is listening.help
--sessionqueue-implementationFull classname of the non-default session queue implementation.help
--sessionqueue-portPort on which the session queue server is listening.help
--slot-matcherFull classname of non-default slot matcher to use.help
--slot-selectorFull classname of non-default slot selector.help
--structured-logsUse structured logs Default: falsehelp
--sub-pathA sub-path that should be considered for all user facing routes on the Hub/Router/Standalonehelp
--subscribe-eventsConnection string for subscribing to events from the event bushelp
--tcp-tunnelEnable the transparent TCP tunnel for WebSocket connections (BiDi, CDP).help
--tracingEnable trace collection Default: truehelp
--usernameUser name clients must use to connect to the server.help
--versionDisplays the version and exits.help
--vnc-env-varEnvironment variable to check in order to determine if a vnc stream is available or not.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.