1. Home
  2. Docs
  3. DWService
  4. Troubleshoots
  5. πŸ–₯️❌ Set up a device without a monitor (headless)

πŸ–₯️❌ Set up a device without a monitor (headless)

This section shows possible solutions for the situation when there is no monitor connected to the remote device and only a black screen appears when using the Screen application.

We are aware of multipleΒ working solutions:

Hardware solution

If there is no monitor connected to the remote device, you can connect an HDMI device to it.

The device looks like this:

More information about the device is available here:

Amazon.com: FUERAN DP – DisplayPort Display Emulator EDID Emulator Plug (fit Headless 2560×1600@60Hz) : Electronics

Software solution for Windows

For Windows operating systems, it is possible to install an application that creates one or more virtual monitors.

The application is available here:

Activating a Secondary Display on Windows 10 when no Monitor is Connected – Amyuni Technologies

⚠️ Note: this solution works properly with Windows10 and Windows 11 as well.

Software solution for Linux

Multiple solutions are available for the Linux operating system.

Solution 1:
Setup Ubuntu Dummy Desktop & Remote Access – Thien-Minh Nguyen (brytsknguyen.github.io)

Solution 2:

Solution 3:

  • First, install an Xorg dummy driver:

sudo apt-get install xserver-xorg-video-dummy

  • Then write a config file for that driver that tells DWService this device is headless:

sudo nano /etc/X11/xorg.conf

  • In this new file, copy and paste the following text:

Section "Device"
Identifier "Configured Video Device"
Driver "dummy"
# Default is 4MiB, this sets it to 16MiB
VideoRam 16384

Section "Monitor"
Identifier "Configured Monitor"
HorizSync 31.5-48.5
VertRefresh 50-70

Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
Device "Configured Video Device"
DefaultDepth 24
SubSection "Display"
Depth 24
Modes "1024Γ—800"

  • When you are done, make sure you save the file and quit (Ctrl+X, then Y, then Enter).
  • Reboot the device.

βœ… You should be able to use the Screen app.

Software solution for macOS

For the macOS operating system, the following solution can be used:

GitHub – waydabber/BetterDisplay: Unlock your displays on your Mac! Smooth scaling, HiDPI unlock, XDR/HDR extra brightness upscale, DDC, brightness and dimming, virtual screens, PIP and lots more!