Skip to content

Bug report - Describe the bug #2343

@V3XAM

Description

@V3XAM

I am a beta tester and a paid Pro/GUI user. I paid 22.50 PLN for the graphical environment and I am testing Ubuntu XFCE on Android using UserLAnd.

The main issue is that the VNC/GUI session becomes unstable during longer terminal operations. The bug occurs after entering a VNC/GUI session.

During commands such as:

sudo apt-get install
sudo dpkg --configure -a
sudo apt-get -f install

the graphical session can disconnect and show errors such as:

Connection refused
ECONNREFUSED
127.0.0.1:5951

In many cases, the Linux process seems to continue in the background, and the installation may even finish successfully. However, the user gets kicked out of the GUI/VNC session. For a beginner, this looks like the whole Linux environment crashed, even if only the VNC layer failed.

Expected behavior: UserLAnd should either keep the VNC connection stable during longer terminal operations or provide a clear recovery option, such as auto-reconnect, reconnect attempt, or a “Restart VNC session” button.

I also noticed browser-related problems in the GUI environment:

  • Chromium on Ubuntu tries to use Snap.
  • Snap does not work properly in UserLAnd/proot.
  • NetSurf opens, but it does not support modern websites well because of limited JavaScript support.
  • Epiphany/WebKit may fail with sandbox/dbus/bwrap-related errors.

It would be very helpful to have an official recommendation for which browser is actually supported in Ubuntu XFCE under UserLAnd.

Steps to reproduce the behavior:

  1. Install or open UserLAnd.

  2. Select Ubuntu with XFCE / graphical environment.

  3. Start the VNC/GUI session.

  4. Open the terminal inside Ubuntu XFCE.

  5. Run longer package-management commands, for example:

sudo apt-get update
sudo apt-get install -y --no-install-recommends ca-certificates curl wget nano tmux git python3 python3-pip python3-venv

  1. Wait during package installation/configuration.

  2. The VNC/GUI session may disconnect and show a connection error such as "ECONNREFUSED" or "127.0.0.1:5951".

  3. After returning to UserLAnd, the Linux session may still exist, but the GUI connection is broken or needs to be restarted.

Browser-related reproduction:

  1. Start Ubuntu XFCE in UserLAnd.

  2. Try to run Chromium.

  3. Chromium requires Snap.

  4. Snap cannot communicate with "snapd" in UserLAnd/proot.

  5. Try NetSurf.

  6. NetSurf opens, but modern Google/Google Skills pages ask for JavaScript support.

  7. Try Epiphany.

  8. Epiphany may fail with sandbox/dbus/bwrap-related errors.

Screenshots

I can provide screenshots showing:

  • VNC connection failure / "ECONNREFUSED".
  • "127.0.0.1:5951" connection error.
  • Chromium requiring Snap.
  • NetSurf showing JavaScript limitations.
  • Epiphany/WebKit sandbox/dbus/bwrap errors.
  • Terminal output during package installation.

Device Information

Device: Samsung Galaxy A57 5G.
Android Version: Android 16.
UserLAnd Version: 26.05.22.
Whether the device is rooted: No.
Whether the device is running LineageOS: No.

Please add any other context you think might help us resolve your issue.

I am using UserLAnd as a mobile Linux/developer environment. The terminal side works quite well. I was able to use tools such as:

curl
wget
nano
tmux
git
python3
python3-pip
python3-venv

The biggest problem is not the terminal itself, but GUI/VNC stability and browser compatibility.

Suggestions that may help improve the app:

  1. Add VNC auto-reconnect.
  2. Add a visible “Restart VNC session” button.
  3. Show clearer error messages explaining whether only VNC failed or whether the Linux session actually stopped.
  4. Add a first-run checklist for Android battery optimization:
    • set UserLAnd battery mode to unrestricted,
    • add UserLAnd to “never sleeping apps”,
    • lock UserLAnd in recent apps / “Keep open”,
    • recommend using "tmux" for long-running commands.
  5. Add a “Developer setup” mode that installs a minimal toolkit without a full system upgrade:

sudo apt-get update
sudo apt-get install -y --no-install-recommends ca-certificates curl wget nano tmux git python3 python3-pip python3-venv

  1. Add an official list of supported browsers per distribution.
  2. Add a note that Chromium on Ubuntu may require Snap, which may not work in UserLAnd/proot.
  3. Add basic diagnostics showing:
    • whether the filesystem is running,
    • whether VNC is running,
    • active VNC port,
    • last VNC error,
    • quick actions: reconnect / restart VNC / stop session.

UserLAnd has strong potential as a mobile Linux environment. My main request as a paid Pro/GUI user is better VNC recovery, clearer diagnostics, and official guidance about browser support.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions