# @wdio/display-server

> A standalone utility to manage display servers (Wayland/Xvfb) for headless testing

Latest version **10.2.0** (published 2026-11-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install @wdio/display-server
pnpm add @wdio/display-server
yarn add @wdio/display-server
bun add @wdio/display-server
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 10.2.0 |
| Published | 2026-11-06 |
| First published | 2026-10-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=22.23.4 <23 \|\| >=24.22.1 <25 \|\| >=26.12.1 |
| Dependencies | 2 |
| Unpacked size | 153.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 9865 |
| Author | WebdriverIO Team |
| Maintainers | christian-bromann, wdio-user, wswebcreation-nl |
| Keywords | wayland, xvfb, headless, display, linux, testing, x11, virtual-framebuffer, electron, browser-testing |

## Links

- npm: https://www.npmjs.com/package/@wdio/display-server
- Repository: https://github.com/webdriverio/webdriverio
- Homepage: https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-display-server
- Issues: https://github.com/webdriverio/webdriverio/issues
- npm.io page: https://npm.io/package/@wdio/display-server

## Dependencies (2)

- [@wdio/types](https://npm.io/package/@wdio/types.md) 10.2.0
- [@wdio/logger](https://npm.io/package/@wdio/logger.md) 10.2.0

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads
- [aws-elasticsearch-connector](https://npm.io/package/aws-elasticsearch-connector.md) — 37.4K weekly downloads

## Recent versions

- 10.2.0 (latest) — 2026-11-06
- 10.2.0-alpha.100.sha-b38abd894 (next) — 2026-10-31
- 10.1.0 — 2026-10-18
- 10.1.0-alpha.30 — 2026-10-07
- 10.1.0-alpha.29 — 2026-10-07
- 10.0.1 — 2026-10-07
- 10.1.0-alpha.26 — 2026-10-06
- 10.1.0-alpha.25 — 2026-10-06
- 10.1.0-alpha.19 — 2026-10-06
- 10.1.0-alpha.18 — 2026-10-06
- 10.0.0 — 2026-10-05
- 10.0.0-alpha.175 — 2026-10-04
- 10.0.0-alpha.165 — 2026-10-04
- 10.0.0-alpha.163 — 2026-10-04
- 10.0.0-alpha.172 — 2026-10-04
- … 7 more at https://npm.io/package/@wdio/display-server/versions

## README

WebdriverIO Display Server
==========================

> Starts a virtual display, Weston or Xvfb, for headless testing on Linux

**Most users don't need to install this package directly.** `@wdio/local-runner` depends on it and starts a display server when a testrunner run needs one: on Linux, when neither `DISPLAY` nor `WAYLAND_DISPLAY` is set. Configure it with the `displayServer*` options at the root of your `wdio.conf.ts`. See [Headless & Display Servers](https://webdriver.io/docs/headless-and-display-servers) for how it works, its options, CI recipes and troubleshooting.

## Install

```sh
npm install @wdio/display-server
```

## Usage outside the testrunner

To start a display server from a standalone `remote()` script, see [Standalone scripts](https://webdriver.io/docs/headless-and-display-servers#standalone-scripts).

----

For more information on WebdriverIO see the [homepage](https://webdriver.io).

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