---
name: "miral-app"
section: "1"
platform: "linux"
package: "mir-demos"
version: "2.20.2-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/miral-app"
---

# miral-app(1)

Launch hosted miral desktop session

## NAME

miral-app - Launch hosted miral desktop session

## SYNOPSIS

**miral-app** \[*options*\] \[*shell options*\]

## DESCRIPTION

**miral-app** is handy launch script for a hosted miral "desktop session". By default, *miral-shell* session is used for that, launching *qterminal* as an initial application inside.

## OPTIONS

- **-kiosk**

  Use *miral-kiosk* instead of *miral-shell*.

- **-launcher** *\<launcher\>*

  Use *\<launcher\>* instead of the default application (*qterminal*).

- **-socket** *\<socket\>*

  Set the legacy Mir socket (default: /tmp/\<UID\_NUMBER\>-runtime-dir/miral\_socket).

- **-wayland-display** *\<socket\>*

  Set the wayland socket (default: wayland-0).

- **-bindir** *\<bindir\>*

  Path to the *miral-\** executables (default: /usr/bin).

## SEE ALSO

[miral-shell(1)](/miral-shell/1.md), [miral-kiosk(1)](/miral-kiosk/1.md), [qterminal(1)](/qterminal/1.md)

## AUTHOR

The Mir Display Server has been written by the Mir Server Team at Canonical Ltd.

This man page has been written for the Debian project by Mike Gabriel \<mike.gabriel@das-netzwerkteam.de\> and may be re-used by others.