-
Notifications
You must be signed in to change notification settings - Fork 17
Home
This page is for running Logos on x86_64 desktop Linux. For other installs, see:
- Logos / Verbum 10 Install Guide. Note that this guide is slightly outdated.
- Logos on ARM/AARCH64 Linux
- Logos on Mobile Linux
Linux remains officially unsupported but we are moving in the right direction! For support use Telegram or Matrix. Telegram and Matrix are bridged.
Our recommended install is to use Logos 10 with Wine 7.18+ or with Proton.
Note there are issues with Wine 7.19–22 with using the .exe installer. The script uses the .msi installer and should bypass this issue. The latest work in Logos and Wine 8.0+ should make the .exe installer work well again.
There is a bug in Wine 8.0 that prevents Logos from launching. Use 8.1+.
Uninstalling is as simple as deleting the wine bottle (e.g., ~/LogosBible10). Likewise you should be able to rsync the directory between different installs if need be.
If you wish to backup or maintain recently indexed data, the needed Logos data is stored in the following directories. Please note these are standard for the script; if you have moved them around, adjust the $HOME variable:
$HOME/LogosBible10/data/wine64_bottle/drive_c/users/$USER/Local\ Settings/Application\ Data/Logos/Data
$HOME/LogosBible10/data/wine64_bottle/drive_c/users/$USER/Local\ Settings/Application\ Data/Logos/Documents
$HOME/LogosBible10/data/wine64_bottle/drive_c/users/$USER/Local\ Settings/Application\ Data/Logos/Users
Snap is package management tool developed by Canonical, who maintains the Ubuntu distribution. While multiple distributions can use Snap, Ubuntu pushes it heavily. You can find install instructions for Logos using Snap here:
Bottles is a management interface for wine, which installs its software in "bottles".
Please see the Git Issues tracker. Also note:
- Media Playback (enhancement): https://bugs.winehq.org/show_bug.cgi?id=47905 patch which prevents crash but functionality needs to be created in wine, developer aware and helping. See https://github.com/ferion11/LogosLinuxInstaller/issues/87.
- Speech (enhancement): https://bugs.winehq.org/show_bug.cgi?id=47922 Frank and John working on.
- Printing (enhancement): Doesn’t work if win version is set to win10. Doesn’t print to all printers. Some characters in the footers are missing.
- Faithlife Assistant: https://bugs.winehq.org/show_bug.cgi?id=52379 Fix already in staging… will track through to completion.
- Error in Async Work. See https://github.com/ferion11/LogosLinuxInstaller/issues/105.
- Logos becomes unresponsive after a time. See https://github.com/ferion11/LogosLinuxInstaller/issues/101.
- Updating (regression): https://bugs.winehq.org/show_bug.cgi?id=49767 Don’t know how to address this. Data loss occurs sometimes on update (this has always been the case, but the regression is that no updates happen at all. Logos reports no updates available but can download new resources and data sets. It is still possible to update manually.). See https://github.com/ferion11/LogosLinuxInstaller/issues/120.
- Menus (regression): https://bugs.winehq.org/show_bug.cgi?id=52380 Not technically a regression in wine since this issue appears from Logos 9.10 onwards, it reveals a bug in wine.
Please see the Bug Fixing Guide in order to help improve Logos on Wine.
If you discover an issue with your distro, please add it here.
Logos can be run using Valve's Steam Proton fork of wine. The binary should be located in the following directory, unless you have moved it or are using a different library location:
/home/$USER/.local/share/Steam/steamapps/common/Proton - Experimental/files/bin/wine64
/home/$USER/.local/share/Steam/steamapps/common/Proton - Experimental/files/bin/wineserver
Replace any calls to wine64 or wineserver with these binaries. NOTE: Linux requires that paths with whitespaces in them be quoted, either with single or double quotes. A whitespace is viewed as a breaking character and your system will likely tell you that Proton is a directory if you do not quote.
The steam deck has a locked down filesystem. There are some missing dependencies which cause irregular crashes in Logos. These can be installed following this sequence: update there is now a steam deck dependency script https://github.com/ferion11/LogosLinuxInstaller/issues/203
- Enter Desktop Mode
- Use
passwd
to create a password for the deck user, unless you already did this. - Disable read-only mode:
sudo steamos-readonly disable
- Initialize pacman keyring:
sudo pacman-key --init
- Populate pacman keyring with the default Arch Linux keys:
sudo pacman-key --populate archlinux
- Get package lists:
sudo pacman -Fy
- Fix locale issues
sudo pacman -Syu glibc
- then
sudo locale-gen
- Install dependencies: `sudo pacman -S samba winbind cabextract appmenu-gtk-module patch bc lib32-libjpeg-turbo
Packages you install may be overwritten by the next Steam OS update, but you can easily reinstall them if that happens.
After these steps you can go ahead and run the your install script but choose to use the appImage rather than any other wine or proton installed on the system. The appImage is tested and reliable, proton gets frequent updates which can break compatibility.
These instructions assume the default Crostini (Debian) container is used.
- Turn on the Linux environment in Settings > Advanced > Developers > Linux development environment. Set the size of the container large enough to hold your entire Logos library and space for indexing.
- Update the Crostini container from the Crostini terminal with sudo apt update and sudo apt upgrade.
- Install Wine staging from winehq.org, or alternatively just use the appimage option when you run the Logos installation script.
- Satisfy the dependencies to run the Logos installation script from the Crostini terminal by sudo apt install patch lsof wget sed grep gawk winbind cabextract x11-apps bc libxml2-utils curl.
- Install a dialog program from the Crostini terminal with sudo apt install dialog, sudo apt install zenity, or sudo apt install whiptail.
- Download the LogosLinuxInstaller.sh script, move it to your Linux files using the ChromeOS Files app, make the script executable (chmod +x LogosLinuxInstaller.sh), and run the script (./LogosLinuxInstaller.sh).
- While running Logos in a Crostini container on ChromeOS will not have the same performance as running it on bare metal, try changing the default book font in the Logos program settings to default sans serif if scrolling is laggy (YMMV).
A known issue with Logos in Crostini is that there are black boxes surrounding certain graphical elements such as the login box, start up splash screen, library box, and interlinear boxes. The fix is for ChromeOS users to open their Chrome browser, type chrome//flags in the search box and search for Crostini GPU support, and change the value from Default to Disabled.
- Mods to the scripted install.
- Offer to update Logos. See https://github.com/ferion11/LogosLinuxInstaller/issues/130.
- Possibly check Logos version somehow against installer version
- If updating
- Rename to _temp
- Install as usual
- Copy user dirs and shortcut dir back into new install before first run
- Offer to create the shortcut
- Offer to update Logos. See https://github.com/ferion11/LogosLinuxInstaller/issues/130.
- Create a Bottles installer. Effort ongoing: (https://github.com/jg00dman/programs)