Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

docs(guide): fix the RDP session recipe and mirror-mode steps

ExTved056be9e906
diff --git a/docs/guide/desktop.html b/docs/guide/desktop.html
index e4b5dd4..2318cbf 100644
--- a/docs/guide/desktop.html
+++ b/docs/guide/desktop.html
@@ -136,9 +136,13 @@
<span class="p">#</span> sed -i 's/^autorun=$/autorun=Xvnc/' /etc/xrdp/xrdp.ini
<span class="c"># tell the session what to start. On Alpine, xrdp runs the system xinitrc,</span>
-<span class="c"># which reads ~/.xinitrc; it never looks at ~/.xsession.</span>
-<span class="p">#</span> echo 'xterm &amp;' &gt; /root/.xinitrc
-<span class="p">#</span> echo 'exec openbox-session' &gt;&gt; /root/.xinitrc
+<span class="c"># which reads ~/.xinitrc; it never looks at ~/.xsession. Start the window</span>
+<span class="c"># manager FIRST and let it launch the terminal: a program started before</span>
+<span class="c"># openbox is up can end up permanently invisible, which reads as a black</span>
+<span class="c"># or empty desktop.</span>
+<span class="p">#</span> echo 'exec openbox-session' &gt; /root/.xinitrc
+<span class="p">#</span> mkdir -p /root/.config/openbox
+<span class="p">#</span> echo 'xterm &amp;' &gt; /root/.config/openbox/autostart
<span class="c"># both services are required: xrdp speaks the protocol, sesman logs you in</span>
<span class="p">#</span> rc-service xrdp-sesman start
@@ -146,7 +150,7 @@
<span class="p">#</span> rc-update add xrdp-sesman
<span class="p">#</span> rc-update add xrdp</code></pre>
- <p>Then add a port forward in <strong>Settings &rarr; Port forwards</strong> from host port <code>3389</code> to VM port <code>3389</code>, and connect from the PC to <code>phone-address:3389</code> with the guest's own credentials: user <code>root</code>, password <code>podroid</code> unless you changed it. The desktop can look blank for the first moment while the session is still starting; it fills in as soon as anything draws, and opening a window from the window manager's menu is enough to force it.</p>
+ <p>Then add a port forward in <strong>Settings &rarr; Port forwards</strong> from host port <code>3389</code> to VM port <code>3389</code>, and connect from the PC to <code>phone-address:3389</code> with the guest's own credentials: user <code>root</code>, password <code>podroid</code> unless you changed it. Be patient on the first login: on the QEMU backend the session can take a minute or more to start, and until openbox is up the screen is plain black with only a mouse cursor. The dark gray desktop appearing means the session is ready; the terminal from the autostart follows, and the right-click menu works from that point on.</p>
<div class="callout note">
<span class="label">On an older VM image, one more line</span>
@@ -168,6 +172,8 @@ port=5900
username=na
password=na</code></pre>
+ <p>Two things trip people up here. First, <code>xrdp.ini</code> is read by the xrdp daemon itself, so the change is not live until you run <code>rc-service xrdp restart</code>; restarting only <code>xrdp-sesman</code> does nothing for it. Second, this mirrors whatever the phone's own session is currently showing: if the in-app desktop has nothing running, the mirror is an empty black screen. Open the in-app desktop (or start something on it) and the mirror shows the same picture.</p>
+
<p>That variant inherits the in-app session's lack of a password, so it hands the desktop to anyone who can reach port 3389. Use it over an SSH tunnel, or on a network you control, and prefer the authenticated login above otherwise.</p>
<h2>Viewer settings reference</h2>