# Static Server Service

Some projects are front-end assets only, and don't run on more than a static server. This service helps you to run a static file server during testing.

## Installation[​](#installation "Direct link to Installation")

The easiest way is to add `@wdio/static-server-service` as a `devDependency` in your `package.json`, via:

```
npm install @wdio/static-server-service --save-dev
```

Instructions on how to install `WebdriverIO` can be found [here](https://webdriver.io/docs/gettingstarted).

## Configuration[​](#configuration "Direct link to Configuration")

To use the static server service, add `static-server` to your service array:

```
// wdio.conf.js
export const config = {
    // ...
    services: ['static-server'],
    // ...
};
```

## Options[​](#options "Direct link to Options")

### `folders` (required)[​](#folders-required "Direct link to folders-required")

Array of folder paths and mount points.

Type: `Array<Object>` Props:

* mount `{String}` - URL endpoint where folder will be mounted.
* path `{String}` - Path to the folder to mount.

```
 // wdio.conf.js
 export const config = {
    // ...
    services: [
        ['static-server', {
            folders: [
                { mount: '/fixtures', path: './tests/fixtures' },
                { mount: '/dist', path: './dist' },
            ]
        }]
    ],
    // ...
 };
```

### `port`[​](#port "Direct link to port")

Port to bind the server.

Type: `Number`

Default: `4567`

### `middleware`[​](#middleware "Direct link to middleware")

Array of middleware objects. Load and instatiate these in the config, and pass them in for the static server to use.

Type: `Array<Object>` Props:

* mount `{String}` - URL endpoint where middleware will be mounted.
* middleware `<Object>` - Middleware function callback.

Default: `[]`

```
// wdio.conf.js
import middleware from 'middleware-package'

export const config = {
    // ...
    services: [
        ['static-server', {
            middleware: [{
                mount: '/',
                middleware: middleware(/* middleware options */),
            }],
        }]
    ],
    // ...
};
```

***

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