# Is it possible to run RealityScan fully headless on Linux?

**URL:** <https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867>\
**Category:** Feedback & Requests\
**Tags:** question, realityscan, realityscan-mobile\
**Created:** [April 6, 2026, 2:56pm UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867 "2026-04-06T14:56:22Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![bnoreus](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@bnoreus](https://forums.unrealengine.com/u/bnoreus)\
**Post date:** [April 6, 2026, 2:56pm UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867/1 "2026-04-06T14:56:22Z")

</div>

Is it possible to actually run the CLI headlessly on Linux? The offical documentation insists that we should use the CLI and not the GUI, but when running the CLI the system will open up a UI window and it will fail if it can’t. Sometimes I’m asked to sign in to Epic Games in the UI. Is it possible to due this via the CLI so I don’t have to click anything in the UI?

---

<div class="post-metadata">

**Author:** ![JakubVanko](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/jakubvanko/32/1215548_2.png) [@JakubVanko](https://forums.unrealengine.com/u/JakubVanko)\
**Post date:** [April 7, 2026, 6:22am UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867/2 "2026-04-07T06:22:15Z")

</div>

Yes, it is possible with the `-headless` flag.

Check out this thread and the solution:

> [@RealityScan - Fully Headless Linux](https://forums.unrealengine.com/t/realityscan-fully-headless-linux/2682217):
>
> Hi all, So I’m trying to get RealityScan running on Linux on an Amazon Ubuntu server (g6.xlarge). I can get it running when I RDP into the machine, however, when running fully headless (i.e. SSH into the box, no display), RealityScan doesn’t do anything. Multiple minor issues as well: -stdConsole does not return anything on Linux (either RDP or SSH) Linux based paths (e.g. /home/ubuntu/) do not work - I needed to replace /home/ubuntu/ with Y:/ Example command: /usr/bin/realityscan -stdCon…

---

<div class="post-metadata">

**Author:** ![bnoreus](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@bnoreus](https://forums.unrealengine.com/u/bnoreus)\
**Post date:** [April 8, 2026, 9:46pm UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867/3 "2026-04-08T21:46:51Z")

</div>

@JakubVanko Thanks for your answer, but the -headless flag won’t actually prevent the software from trying to open a UI. If no display is available, the program will fail. I am able to get around this by creating a virtual display but the problem is that most errors show up as popups in the virtual display instead of error messages in the terminal. This causes the CLI to just fail silently, if I’m not looking at the virtual display.

If the CLI could work like a true CLI, it would help massively.

---

<div class="post-metadata">

**Author:** ![JakubVanko](https://d1ap1mz92jnks1.cloudfront.net/user_avatar/forums.unrealengine.com/jakubvanko/32/1215548_2.png) [@JakubVanko](https://forums.unrealengine.com/u/JakubVanko)\
**Post date:** [April 9, 2026, 9:02am UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867/4 "2026-04-09T09:02:12Z")

</div>

@bnoreus The fact about the need for a virtual display is true. I’ll forward the feedback about a true CLI. For now, try to combine `-headless` with the `-silent` command to suppress any possible popups.

---

<div class="post-metadata">

**Author:** ![gustypants](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@gustypants](https://forums.unrealengine.com/u/gustypants)\
**Post date:** [May 22, 2026, 4:55pm UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867/5 "2026-05-22T16:55:54Z")

</div>

Did you get this working?

Ive tried to follow all the guides in the docks, both for dockerization and with the remote control plugin but cant get it to work.  
$ . docker\_run\_container.sh  
/opt/realityscan/bin/cxmessage:239: DeprecationWarning: Gtk.MessageDialog.set\_image is deprecated  
dialog.set\_image(image)

this is all i see. i assume it is some kind of warning or interactive menu that i cant see. the thing is that i can actually get it to run headless on my desktop machine, but perhaps i clicked away a few popups on the first run…

---

<div class="post-metadata">

**Author:** ![AfraidHornet8374](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@AfraidHornet8374](https://forums.unrealengine.com/u/AfraidHornet8374)\
**Post date:** [August 10, 2026, 1:11pm UTC](https://forums.unrealengine.com/t/is-it-possible-to-run-realityscan-fully-headless-on-linux/2711867/6 "2026-08-10T13:11:03Z")

</div>

It can run now.
