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.htmlindex 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 &' > /root/.xinitrc-<span class="p">#</span> echo 'exec openbox-session' >> /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' > /root/.xinitrc+<span class="p">#</span> mkdir -p /root/.config/openbox+<span class="p">#</span> echo 'xterm &' > /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 → 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 → 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=5900username=napassword=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>