Full linux distros on Sailfish OS - maemo.org

edp17 | # 1 | 2020-07-29, 13:55 | Report

This topic is created to discuss any questions and thoughts regarding the harbour-containers. This app makes it possible to easily install full Linux distributions onto Sailfish OS and use that distro as any other Sailfish app.

The harbour-containers and lxc-templates-desktop are Illyria's project and he was inspired by the work of Preflex' and Elros34 on chroot.

More info (requirements, downloads and install instructions) is available here:

(Note: Once the container is started you can close the command line, and the container will stay running.)

Requirements:

harbour-containers requirements
Kernel requirements
install the lxc and lxc-templates packages with pkcon
Additional kernel requirements. All the following must be on in the kernel:
CONFIG_DEVPTS_MULTIPLE_INSTANCES
CONFIG_NAMESPACES
CONFIG_UTS_NS
CONFIG_IPC_NS
CONFIG_PID_NS
CONFIG_NET_NS
CONFIG_CGROUPS
CONFIG_CGROUP_DEVICE
CONFIG_CPUSETS

(You can double-check these on the device. e.g. zcat /proc/config.gz | grep CONFIG_DEVPTS_MULTIPLE_INSTANCES)

Downloads:

harbour-containers
lxc-templates-desktop
qxdisplay (I recommend using qxcompositor because that supports auto-rotation)

===========================================
Mouse and cursor support:
Important!: From SFOS4.4 qxcompositor with mouse cursor is not available.
(The cursor support is in an experimental stage, however, that works fine in portrait mode)

Add the -plugin evdevmouse parameter into "/var/lib/environment/compositor/droid-hal-device.conf"
Then install the qxcompositor package. (An older build can be downloaded from here:
qxcompositor-0.0.5+cursor_test2.20200817210502 but I do recommend to install it from the proper repo.)

For SFOS4.4, the qxcompositor can be installed from Elros's repo. As root do the following:

Code:

ssu ar elros34 https://repo.sailfishos.org/obs/home:/elros34:/sailfishapps/sailfishos_4.4.0.64/

Code:
```
zypper ref
```
Code:
```
zypper in qxcompositor
```

Unfortunately, if you install Debian Sid fresh under SFOS4.4, the installation cannot build the Xwayland binary. If no window appears and on the console, you get this error: "/etc/X11/xinit/xserverrc: 4: exec: /opt/bin/Xwayland: not found", do the following:

download the latest build (Xwayland.xxx.libc-2.29.bin) from github https://github.com/sailfish-containe...rver/releases/
rename it to Xwayland
set it to be executable
Code:
```
chmod +x Xwayland
```
then copy into /home/.lxc/<container_name>/opt/bin/

If the window starts but there is an error message "Unable to contact settings server" "Failed to execute child process "dbus-launch" (No such file or directory)", then you need to attach the container and install the dbus-x11 package

Some useful scripts:
(You can download and edit as you wish.

)

Start LXC and desktop in landscape/portrait/auto-rotation mode with mouse support: debian-mouse.sh
(two parameters:
$1 - container name;
$2 - p or l or a for portrait/landscape/auto-rotate mode
Please note: if it is called WITHOUT the second parameter, it starts with auto-rotate)
Start LXC and desktop without mouse support: debian.sh

(Note: Once the container is started with one of the scripts above, you can close the command line, and the container will remain running.)
(Note2 03/11/2021: I've amended the scripts to handle if waydroid is also installed on the device. I also incorporated the landscape/portrait/auto-rotate modes into one script.)

===========================================

If the GUI doesn't work (for some unofficial ports, this is the case), this can be done manually from a command line. Here are the steps:

sudo lxc-create -t sfos-download -n <container-name>
sudo lxc-start -n <container-name>
Manually change the the /usr/share/sailfish-containers/guest to /usr/share/harbour-containers/scripts/guest in the /var/lib/lxc/<container_name>/config
sudo lxc-attach -n <container-name>
then within the container:
- /mnt/guest/setup_desktop.sh
- /mnt/guest/setups/debian.sh
Start 2! command lines and in one of them issue this as nemo:
/usr/bin/qxdisplay --wayland-socket-name "../../display/wayland-container-0"
(or to start with mouse cursor support use this:
/usr/bin/qxcompositor -o portrait --wayland-socket-name "../../display/wayland-container-0")
In the other command-line attach the container, then:
/mnt/guest/start_desktop.sh 0
Done.

Note: If you don't have the /mnt/guest/ folder within the container, try to use this content in the /var/lib/lxc/<container_name>/config: config
In this config, there are some container-specific lines so we would like to copy them among the containers, we need to adjust these two lines accordingly:

Code:

# Container specific configuration
lxc.rootfs.path = dir:/home/.lxc/<container_name>
lxc.uts.name = <container_name>

where replace the <container_name> with your name of the container.

===========================================
V I D E O S:

Kabouik has created some very useful and impressive videos on how to use LXC with desktop Linux distributions on Sailfish OS. Many thanks for him!

LXC containers are now working in the Sailfish OS demo:
- First demo
Desktop Linux (xfce & i3) on Pro1 qwerty slider without sacrificing telephony:
- LBRY for good connections (big file)
- Youtube for slower connections

They're rather long so check the description to jump to any chapter that might be more interesting to you.

Last edited by edp17; 2022-08-22 at 15:25.

The Following 24 Users Say Thank You to edp17 For This Useful Post:
Bundyo, DA5, elvarr, Fellfrosch, J4ZZ, Jordi, juiceme, Kabouik, Kalatti, klinglerware, lal, levone1, max_power, meemorph, mosen, mscion, nonsuch, olf, peterleinchen, preflex, rcolistete, reinob, robthebold, xman

mscion | # 2 | 2020-07-29, 18:16 | Report

Will this work on the original jolla phone?

The Following 2 Users Say Thank You to mscion For This Useful Post:
juiceme, mosen

mosen | # 3 | 2020-07-29, 18:51 | Report

copied from the lxc instructions:

Code:

It is possible to check if your kernel support containers with:
ls -lha /dev/pts/
LXC enabled devices should see a /dev/pts/ptmx entry.

On Jolla 1, memory might be a little few.

The Following 2 Users Say Thank You to mosen For This Useful Post:
juiceme, mscion

mscion | # 4 | 2020-07-29, 19:02 | Report

Originally Posted by mosen View Post

copied from the lxc instructions:

Code:

It is possible to check if your kernel support containers with:
ls -lha /dev/pts/
LXC enabled devices should see a /dev/pts/ptmx entry.

On Jolla 1, memory might be a little few.

Would be fun to try. Maybe there is a decent light weight distribution.

https://itsfoss.com/lightweight-linux-beginners/

The Following 2 Users Say Thank You to mscion For This Useful Post:
juiceme, mosen

edp17 | # 5 | 2020-07-30, 07:02 | Report

Originally Posted by mscion View Post

Will this work on the original jolla phone?

Well, my experience so far is that even if the device meets with all the requirements, there can be some issues. Examples:

on my XA2, it works out of the box
on my Note 4 (treltexx) port (CM14.1 base) it only works/starts from the command line (not a biggie as I created a script for that and everything else work fine)
on my Nexus 5 (hammerhead) port (CM12.1 base) it starts but immediately stops (probably there are some other missing bits and bobs, the investigation is ongoing)
on my S2 (i9100) port (CM12.1 base) it doesn't start either from GUI or from the command line (I think it is similar to the hammerhead and it is also under investigation)

So, it worth a try.

The Following 5 Users Say Thank You to edp17 For This Useful Post:
Fellfrosch, juiceme, mosen, mscion, nonsuch

edp17 | # 6 | 2020-07-30, 07:04 | Report

I have updated the main post with adding a video to watch it in action.

The Following 2 Users Say Thank You to edp17 For This Useful Post:
juiceme, mscion

mscion | # 7 | 2020-07-30, 07:42 | Report

As an alternative, is there a way to boot up a Linux distribution from a sd card?

The Following 2 Users Say Thank You to mscion For This Useful Post:
edp17, juiceme

edp17 | # 8 | 2020-07-30, 08:38 | Report

Originally Posted by mscion View Post

As an alternative, is there a way to boot up a Linux distribution from a sd card?

I don't know whether the path is hardcoded into the compiled executables. There are scripts but I have not checked them. So it might be possible, but in the current state that would surely require some manual preparation.

The Following 3 Users Say Thank You to edp17 For This Useful Post:
juiceme, mscion, nonsuch

edp17 | # 9 | 2020-07-30, 09:19 | Report

My question is how can I mount/attach folders outside of the container e.g. the phone's internal and external sd card, network drive, etc...?

The Following 3 Users Say Thank You to edp17 For This Useful Post:
juiceme, mscion, nonsuch

illyria | # 10 | 2020-07-30, 10:50 | Report

hello guys,
i'm the app's developer, and a long time TMO lurker.
I'm a bit surprised to see a topic here so early

First of all, i'd like to point out that this project is heavily inspired on previous works done by preflex on "XWayland Victory!" and elros34 "sailfish_linux_chroot".

As edp17 already stated, LXC and harbour-containers usually works out-of-the-box on XA2's generation devices (android base >=9), since AlienDalvik works within a container as well.

Probably the wiki's requirements page needs some updates since community ports seems to require more than just "CONFIG_DEVPTS_MULTIPLE_INSTANCES" on kernel's defconfig, as i excepted.
Unfortunately i don't own other sailfishos devices than my Pro1 to work on, i'm happy anyway to help porters to bring containers on community ports.

The Following 19 Users Say Thank You to illyria For This Useful Post:
Bundyo, edp17, elvarr, Fellfrosch, Jordi, juiceme, Kabouik, klinglerware, lal, linuxunux, meemorph, mosen, mscion, nonsuch, olf, peterleinchen, reinob, robthebold, vaskas