---
title: "Desktop Mode & Device Configuration · Unlighthouse"
meta:
  "og:description": "Run Unlighthouse in desktop mode with --desktop flag or device: 'desktop' config. Configure mobile/desktop emulation, viewports, and throttling."
  "og:title": "Desktop Mode & Device Configuration · Unlighthouse"
  description: "Run Unlighthouse in desktop mode with --desktop flag or device: 'desktop' config. Configure mobile/desktop emulation, viewports, and throttling."
---

**Guides**

# **Desktop Mode & Device Configuration**

[Copy for LLMs](https://unlighthouse.dev/guide/guides/device.md)

Test performance across different screen sizes and network conditions. Configure mobile, desktop, or custom viewport settings with optional network throttling for realistic performance testing.

## [Device Types](#device-types)

### [Desktop Scanning](#desktop-scanning)

```
import { defineUnlighthouseConfig } from 'unlighthouse/config'

export default defineUnlighthouseConfig({
  scanner: {
    device: 'desktop',
  },
})
```

### [Mobile Scanning (Default)](#mobile-scanning-default)

```
export default defineUnlighthouseConfig({
  scanner: {
    device: 'mobile',
  },
})
```

## [Custom Dimensions](#custom-dimensions)

Test specific viewport sizes for responsive breakpoints:

```
export default defineUnlighthouseConfig({
  lighthouseOptions: {
    screenEmulation: {
      width: 1800,
      height: 1000,
    },
  },
})
```

## [Network Throttling](#network-throttling)

Throttling simulates slower network and CPU conditions for more realistic performance testing:

```
export default defineUnlighthouseConfig({
  scanner: {
    throttle: true,
  },
})
```

Throttling is automatically enabled for production sites and disabled for localhost by default.

[Edit this page](https://github.com/harlan-zw/unlighthouse/edit/main/docs/1.guide/guides/device.md)

[Markdown For LLMs](https://unlighthouse.dev/guide/guides/device.md)

**Did this page help you? **

Anything that could be done better? :)

Help us improve this page. You can [edit this page](https://github.com/harlan-zw/unlighthouse/edit/main/docs/1.guide/guides/device.md) on GitHub or provide anonymous feedback below.

[**Common Errors** Troubleshoot common issues encountered when running Unlighthouse scans, including browser connection and environment problems.](https://unlighthouse.dev/guide/guides/common-errors) [**Docker** Run Unlighthouse site-wide Lighthouse scans in Docker containers. Dockerfile examples and CI/CD configuration.](https://unlighthouse.dev/guide/guides/docker)

**On this page **

- [Device Types](#device-types)
- [Custom Dimensions](#custom-dimensions)
- [Network Throttling](#network-throttling)