[proxy] github.com — ← back | site home | direct (HTTPS) ↗ | proxy home | ◑ dark◐ light

Supported Linux distros

RedBearAK

This is a list of Linux distributions and desktop environment (or window manager) variants where I've been able to test Toshy. For those distros with release versions provided, that is just what I happened to download and test. Older or newer versions of the same distro, within reason, may also work. Or they may have major incompatibilities (each major RHEL/CentOS version has needed different special handling methods, and Debian/Ubuntu are requiring some quirks handling lately).

In some cases, like Fedora Asahi Remix, the support was reported by users.

Testing has almost entirely been on 64-bit versions of the listed Linux distros, but some 32-bit distros can still be made to work, and there should normally be no problem running Toshy on the equivalent ARM version of the same distro, on something like a Raspberry Pi. Though you will probably want a Pi 4B+ or later and at least 4GB of RAM as a minimum, unless you have an extremely lightweight desktop environment like IceWM, JWM or similar.

As noted in the main README, there is no Windows version of Toshy, unlike Kinto. But most of the popular or common desktop Linux distros should work at this point. Search the page for your distro name if you don't know what original distro it's based on.

◊

Quick Links / Table of Contents

◊

Fedora and Fedora Variants

◊

Red Hat Enterprise Linux (RHEL), Clones, CentOS Stream

Important

CentOS Stream 8 is now beyond end of builds (May 31, 2024).
Red Hat has disabled the mirrorlist.centos.org URL, so in order to install anything, the repo files have to be updated to change the URLs to point to the CentOS Vault. The ./prep_centos_before_setup.sh shell script will do this automatically on an existing CentOS Stream 8 system, and then will refresh the yum and/or dnf cache(s). Run the main Toshy setup afterward.

Important

CentOS 7 is now beyond end of life (June 30, 2024).
Red Hat has disabled the mirrorlist.centos.org URL, so in order to install anything, the repo files have to be updated to change the URLs to point to the CentOS Vault. The ./prep_centos_before_setup.sh shell script will do this automatically on an existing CentOS 7 system, and then will refresh the yum and/or dnf cache(s). Run the main Toshy setup afterward.

◊

openSUSE (RPM-based packaging system)

◊

Mageia (From Mandriva/Mandrake, DNF/RPM)

◊

OpenMandriva (From Mandriva/Mandrake, DNF/RPM)

◊

Ubuntu variants and Ubuntu-based distros

◊

Ubuntu Kylin issues

Toshy can finally be installed on Ubuntu Kylin 24.04, unlike the earlier 23.10 release, which had a fatal package version conflict that I couldn't resolve (see further notes about this in the section just below this). But the UKUI desktop environment (at least in the tested 24.04 beta release) seems to have some strange issues with task switching, and with transferring keyboard focus properly after task switching. Since keymaps for an app like Peony (the default UKUI/Kylin file manager) are specific to the app class of peony-qt, the correct keymap only activates after clicking on the Peony window, even if it appears to already be the focused app (watch the highlights on the window controls).

Using Cmd+Tab to switch from another app currently results in the keyboard focus (and the app class) remaining with the previous app. So if the previous app was Mate-terminal, the keyboard shortcuts will respond as if you are still in the Mate-terminal window, until you click on the Peony window. This probably affects other apps after task switching with the keyboard.

Task switching is also broken with the 24.04 beta UKUI desktop, in the sense that you can't switch beyond the last app with the keyboard. The task switcher dialog doesn't respond to holding the modifier key and hitting Tab multiple times. This has nothing to do with Toshy (it's broken even before installing Toshy or when Toshy is disabled) and is similar to a longstanding bug in task switching on the Budgie desktop enironment. If you have any idea where to report these issues to the Ubuntu Kylin developers, please do so if you care about getting them fixed.

◊

Dependency conflicts in Debian/Ubuntu-based distros

I have recently (starting around mid-2024) started encountering fatal (i.e., unfixable by me) dependency conflicts in repos of these Debian/Ubuntu-based distros:

What has been observed has generally been packages (like libsystemd0) that have a dependency referenced with an equal sign (=) instead of greater than or equal to (>=), such that a minor variation of another package (slightly later version or just a distro-specific tag in the package version) would cause the dependency to not be met, so one or more of the necessary Toshy support packages were uninstallable. You will see the problem when attempting to install Toshy.

As far as I know, there's nothing I can do with broken dependencies between packages in a repo. Trying to force-install packages with APT while ignoring dependency conflicts would just result in a broken mess. These distros need to fix the broken dependencies in their repos. Which they do not appear to be doing on any reasonable timeline.

Earlier in the Zorin OS 16.x cycle, the Toshy installer worked fine, and Deepin 23 also worked (haven't tested since, it may be broken now). But currently Zorin OS 16.x is broken (while 17.x works) and Deepin 25 (alpha and preview) is broken in a similar way [UPDATE: Deepin 25 beta and the stable release are working]. Ubuntu Kylin, as noted above, was broken in 23.10, but 24.04 works.

I don't know that there is a central cause for these issues, but I've only ever encountered this kind of problem in recent Debian/Ubuntu-based distros, not on any other distro type supported by the Toshy installer. If you know how and where to notify repo maintainers to get any of this fixed, please do so or let me know the right way/place to notify someone.

Tip

A problem like this was observed on a clean, updated install of Linux Lite 7.2 (and now in 7.4 as well). However in that case I was able to individually apt upgrade the zenity-common and zenity packages on Linux Lite 7.2 (and 7.4), and then the Toshy setup script was able to operate without errors and complete the install.

◊

Debian and Debian-based distros

◊

Arch, Arch-based and related distros

◊

Independent distros

◊

Unsupportable distros?

Some Linux distros will probably never work with Toshy in its current form, or will be very difficult to support due to circumstances like certain dependencies being completely unavailable, or requiring everything to run from a container, or other reasons. Oh, and Toshy is really only focused on "desktop" distros, it's not really intended to be run on something like a headless "server" with no graphical environment involved. All of the environment detection and app-specific keymapping is sort of pointless if there's no window context to be found because you're just in a TTY.

Here's a list of some distros that have given me particular difficulties.

§