Flatpak applications can be installed on a wide variety of Linux variants. We are experimenting with a flatpak build of ChimeraX to make ChimeraX more widely available. But we are new to the flatpak ecosystem, so any feedback you have will be helpful. Please send feedback by using ChimeraX's "Report a Bug" dialog (preferred because it tells us about your computer's configuration), or send feedback directly to Greg Couch.
You need system administrator priviledges to install the flatpak package. Go to flatpak.org, click on Get Setup, select the icon for your variant of Linux, and follow those instructions.
If you didn't configure flatpak to use the flathub repository during the previous step, do it now:
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
The default instructions from flathub.org are for installing for all users. If you are going to install ChimeraX just for yourself, you need to add a per-user flathub repository with:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
During this test phase, download ChimeraX.flatpak. It corresponds to a release candidate build from 14 December 2023. Later you will get the ChimeraX flatpak from the Linux sections of the download page.
For all users:
sudo flatpak install Chimerax.flatpakFor just yourself (assuming per-user flathub repository is installed as shown above):
flatpak install --user Chimerax.flatpak
flatpak run edu.ucsf.rbvi.ChimeraXAnd if you do that a lot, create an alias. For example, for sh and bash:
alias chimerax='flatpak run edu.ucsf.rbvi.ChimeraX'Then to run ChimeraX, simply give the command chimerax.
The test ChimeraX.flatpak is not binary compatible with the regular Linux builds. That will be fixed when the flatpak builds are integrated with our build system. If you need binary compatibility or a newer daily build, you can replace the chimerax directory, app/edu.ucsf.rbvi.ChimeraX/current/active/files/lib/python3.11/site-packages/chimerax, with the version from any Linux daily build from July 13, 2023 or later. For per-user installations, that directory is ~/.local/share/flatpak. The system location varies depending on the Linux variant, and is given by the output from flatpak --installations. How to extract the chimerax directory from a .deb or .rpm package is left as an exercise for the user.
ChimeraX uses:
ChimeraX's virtual reality code has not been tested in the flatpak environment and may require additional permissions.
This means that flatpak hasn't been configured to use the flathub repository yet. See the installation instructions.
libQt6Core.so is part of the ChimeraX release, but it is not loaded if the system's Linux kernel is too old. ChimeraX uses the Qt user interface toolkit, which requires that the Linux kernel be version 3.11 or newer. The kernel version is shown by the output from the uname -r command.