# selenium-standalone

> installs a `selenium-standalone` command line to install and start a standalone selenium server

Latest version **10.0.2** (published 2025-07-17) · MIT license · 103.6K weekly downloads

## Install

```sh
npm install selenium-standalone
pnpm add selenium-standalone
yarn add selenium-standalone
bun add selenium-standalone
```

Provides the command `selenium-standalone`.

## Health

**Score 48/100 (D)** — status: maintenance-mode.

Positive: moderate downloads; has types package; no vulnerabilities; high quality score.

Warnings: no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 10.0.2 |
| Published | 2025-07-17 |
| First published | 2013-09-25 |
| Weekly downloads | 103.6K |
| License | MIT |
| TypeScript types | separate (@types/selenium-standalone) |
| Module format | CommonJS |
| Node | >=14 |
| Dependencies | 19 |
| Unpacked size | 107.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 917 |
| Author | Vincent Voyer |
| Maintainers | devpaul, serbanghita, nolanlawson, vvo, azakus, c2c, stephenash, mgrybyk, wdio-user, kylewhitaker |

## Links

- npm: https://www.npmjs.com/package/selenium-standalone
- Repository: https://github.com/webdriverio/selenium-standalone
- Issues: https://github.com/webdriverio/selenium-standalone/issues
- npm.io page: https://npm.io/package/selenium-standalone

## Dependencies (19)

- [got](https://npm.io/package/got.md) ^11.8.6
- [md5](https://npm.io/package/md5.md) ^2.3.0
- [debug](https://npm.io/package/debug.md) ^4.3.1
- [execa](https://npm.io/package/execa.md) ^5.1.1
- [fkill](https://npm.io/package/fkill.md) ^7.2.1
- [which](https://npm.io/package/which.md) ^2.0.2
- [yauzl](https://npm.io/package/yauzl.md) ^3.1.2
- [mkdirp](https://npm.io/package/mkdirp.md) ^2.1.3
- [minimist](https://npm.io/package/minimist.md) ^1.2.5
- [progress](https://npm.io/package/progress.md) 2.0.3
- [commander](https://npm.io/package/commander.md) ^8.3.0
- [tar-stream](https://npm.io/package/tar-stream.md) 3.1.7
- [cross-spawn](https://npm.io/package/cross-spawn.md) ^7.0.3
- [find-process](https://npm.io/package/find-process.md) 1.4.7
- [lodash.merge](https://npm.io/package/lodash.merge.md) ^4.6.2
- [http-proxy-agent](https://npm.io/package/http-proxy-agent.md) ^7.0.2
- [lodash.mapvalues](https://npm.io/package/lodash.mapvalues.md) ^4.6.0
- [https-proxy-agent](https://npm.io/package/https-proxy-agent.md) ^7.0.4
- [is-port-reachable](https://npm.io/package/is-port-reachable.md) ^3.0.0

## Recent versions

- 10.0.2 (latest) — 2025-07-17
- 10.0.1 — 2025-01-16
- 10.0.0 — 2024-06-25
- 9.5.0 — 2024-04-02
- 9.4.0 — 2024-03-24
- 9.3.3 — 2024-02-16
- 9.3.2 — 2024-01-24
- 9.3.1 — 2023-12-13
- 9.3.0 — 2023-10-23
- 9.2.2 — 2023-10-14
- 9.2.1 — 2023-10-13
- 9.2.0 — 2023-10-02
- 9.1.2 — 2023-09-17
- 9.1.1 — 2023-08-28
- 9.1.0 — 2023-08-28
- … 156 more at https://npm.io/package/selenium-standalone/versions

## README

Node.js Selenium Standalone [![Test](https://github.com/webdriverio/selenium-standalone/actions/workflows/test.yml/badge.svg?branch=main&event=push)](https://github.com/webdriverio/selenium-standalone/actions/workflows/test.yml) ![Supported node versions](https://img.shields.io/badge/node-%2014%2C%2016%2C%2018%2C%2020-green)
===========================

> A node based CLI library for launching [Selenium](http://www.seleniumhq.org/download/) with [WebDriver](https://w3c.github.io/webdriver/) support.

Supported Drivers:

 * [ChromeDriver](https://github.com/SeleniumHQ/selenium/wiki/ChromeDriver)
 * [geckodriver](https://github.com/mozilla/geckodriver/releases) (Firefox)
 * [IEDriver](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)
 * [Edge WebDriver](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/#downloads)
 * [Chromium Edge WebDriver](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/#downloads)

## Available browsers

By default, Google Chrome, Firefox and Microsoft Edge are available when installed on the host system.

Starting from `v6.22` chrome, edgechromium, and geckodriver support `latest` as version.

Starting from `v9.0.6` supported changes regarding new storage for `latest` versions of chromedriver.

Starting from `v9.2.0` added new feature 'onlyDriver'

## Install & Run

### As Global NPM Package

```shell
npm install selenium-standalone -g
selenium-standalone install && selenium-standalone start
```

### As a Local NPM Package

```shell
npm install selenium-standalone --save-dev
npx selenium-standalone install && npx selenium-standalone start
```

### As a Docker Service

```shell
docker run -it -p 4444:4444 webdriverio/selenium-standalone
```

If you run Chrome or Firefox tests within a Docker container make sure you set capabilities so that the session is headless, e.g.:

```js
capabilities: {
  browserName: 'chrome',
  'goog:chromeOptions': {
    args: ['--no-sandbox', '--headless']
  }
}
```

or Firefox:

```js
capabilities: {
  browserName: 'firefox',
  'moz:firefoxOptions': {
    args: ['-headless']
  }
}
```

If you are looking for more sophisticated Docker container that allows you to run browser, check out the [Docker Selenium](https://github.com/SeleniumHQ/docker-selenium) project.

## Command line interface ([CLI](./docs/CLI.md))

See [CLI](./docs/CLI.md) docs

## Application Programming Interface ([API](./docs/API.md))

See [API](./docs/API.md) docs

## Tips

- [Start Selenium whenever your (ubuntu) machine starts!](./docs/run-when-system-starts.md)
- [Ensure you have the minimum required Java version](./docs/java-versions.md)
- [Logging](./docs/logging.md)
- [`Error: unable to get local issuer certificate`](./docs/issuer-cerificate.md)
- [Running headlessly with xvfb](./docs/xvfb.md)

### Examples of combining with other tools

- [WebdriverIO + Jasmine](https://github.com/mgrybyk/wdio-jasmine-boilerplate) in CircleCI
- [WebdriverIO + Cucumber](https://gitlab.com/bar_foo/wdio-cucumber-typescript) in GitLab

## :woman_technologist: :man_technologist: Contributing

You like this project and want to help making it better? Awesome! Have a look into our [Contributor Documentation](CONTRIBUTING.md) to get started with setting up the repo.

If you're looking for issues to help out with, check out [the issues labelled "good first pick"](https://github.com/webdriverio/selenium-standalone/issues?q=is%3Aopen+is%3Aissue+label%3A"good+first+pick"). You can also reach out in on [Discord](https://discord.webdriver.io) if you have question on where to start contributing.

---
_Source: https://npm.io/package/selenium-standalone · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
