Skip to content

Getting Started in UserLAnd

corbinlc edited this page Jul 8, 2019 · 2 revisions

How to get started using UserLAnd:

There are two ways to use UserLAnd: single-click apps and user-defined custom sessions.

Using single-click apps:

  1. Click an app.
  2. Fill out the required information.
  3. You're good to go!

Using user-defined custom sessions:

  1. Define a session - This describes what filesystem you are going to use, and what kind of service you want to use when connecting to it (ssh or vnc).
  2. Define a filesystem - This describes what distribution of Linux you want to install.
  3. Once defined, just tap on the session to start up. This will download necessary assets, setup the filesystem, start the server, and connect to it. This will take several minutes for the first start up, but will be quicker afterwards.

Managing Packages

UserLAnd installs very minimal filesystems. As such, the program that you want to run, even if it is normally included in a standard install of the distro may not be included. Luckily, that is normally fairly easy to fix. The Linux distros come with a package managers. These are used to install, update or remove packages. Normally, if the program you want to run is missing you can do an internet search for "How do I install and run ______?". The instructions found will normally tell you to interact with your package manager. See below for some very basic instructions.

Debian, Ubuntu, And Kali:

-> Update: sudo apt-get update && sudo apt-get upgrade

-> Install Packages: sudo apt-get install <package name>

-> Remove Packages: sudo apt-get remove <package name>

Archlinux:

-> Update: sudo pacman -Syu

-> Install Packages: sudo pacman -S <package name>

-> Remove Packages: sudo pacman -R <package name>

Installing A Desktop

Debian, Ubuntu, And Kali:

-> Install Lxde: sudo apt-get install lxde (default desktop)

-> Install X Server Client: Download on the Play store

-> Launch XSDL

-> In UserLAnd Type: export DISPLAY=:0 PULSE_SERVER=tcp:127.0.0.1:<PORT NUMBER>

-> Then Type: startlxde

-> Then Go Back To XSDL And The Desktop Will Show Up

ArchLinux:

-> Install Lxde: sudo pacman -S lxde

-> Install X Server Client: Download on the Play store

-> Launch XSDL

-> In UserLAnd Type: export DISPLAY=:0 PULSE_SERVER=tcp:127.0.0.1:<PORT NUMBER>

-> Then Type: startlxde

-> Then Go Back To XSDL And The Desktop Will Show Up



But you can do so much more than that. Your phone isn't just a play thing any more!