Install Guide
The Logos Linux Installer program can be used to install and maintain a Logos Bible Software installation on a Linux distribution. The installer has three different interfaces: a Command Line Interface (CLI), a Text User Interface (TUI), and a Graphical User Interface (GUI). This page is provided as a walk-through for getting Logos Bible Software up and running.
First you will need to download the program. You can find releases on the following page.
https://github.com/FaithLife-Community/LogosLinuxInstaller/releases
The program includes a self-update utility so that after you download it once, you can keep it up-to-date without having to return to GitHub.
When you download the program, you need to make it executable. This can be done on the CLI as follows.
chmod 700 ~/Downloads/LogosLinuxInstaller.py
Alternatively you can do this through your desktop's GUI, usually by right clicking the downloaded binary and then enabling the executable bit. On KDE Plasma, you find this in the Permissions tab.
The CLI can initiate an install by executing the script as follows:
./LogosLinuxInstaller --install-app
For all other intents and purposes, the program will operate as if it were the TUI from here out. The TUI and the CLI differ in that the TUI presents a persistent interface. When an option is run from the TUI, the user will be returned to the TUI menu system. The CLI executes a command and then returns the user to their CLI.
For this reason, installing the app is best done through the TUI or the GUI. The CLI is helpful if you want to override some specific functionality. For instance, you can use the -c flag to declare a specific config file, or the -K and -F flags can be used to skip checking dependencies and installing the Microsoft core fonts. These flags can also be used when running the TUI and the GUI.
You can launch the TUI by executing the program from a CLI:
./LogosLinuxInstaller
On running the program, you will be presented with a basic menu.
Select Install Logos Bible Software.
Select your FaithLife product: Logos or Verbum.
Select the version of the product you want to install.
NOTE: Support for Logos 9 will be removed in a future update.
After you select your release version, the program will then begin checking your system to verify it has all dependencies associated with your distribution.
NOTE: Not all distributions may be supported.
The program will attempt to install the dependencies automatically.
Now choose the release version you want to install. The most recent is at the top.
NOTE: Linux cannot currently run Logos 30+ due to needing some new Wine configuration. See this issue.
After this, the program will then scan your system for available Wine binaries. Wine is the key piece of software that allows us to run Logos Bible Software on Linux.
Now choose the Wine binary you wish to use. The program will strip unusable binaries from the list. The topmost item is an AppImage that can be downloaded from the Internet. This is our recommended AppImage. You can find these at the following repository.
https://github.com/FaithLife-Community/wine-appimages
The program will attempt to reuse anything it downloads to save on data usage.
Once you have navigated these menus, the program will begin working in the background. You will be presented with one more menu.
Now you must choose the source of winetricks. Winetricks is a helper script for easily maintaining Wine and modifying the Wine bottle. A Wine bottle is the name for referring to a Wine installation created from the Wine binary. If your local winetricks will suffice, the script will indicate you can use it, as the screenshot above.
Now the script will begin doing more configuration of the Wine bottle. Besides checking your distribution's dependencies, this is the longest part of the install. Here the program will begin installing needed Microsoft fonts, Windows library files, setting necessary registry files, setting font smoothing, and setting the renderer.
After this, the script will download the Logos Bible Software executable and then it will begin the Logos installation by executing the MSI file. You should now see the following window.
Proceed with your Logos Bible Software installation as normal.
Once done, the TUI will return to the control panel menu. You will now have a bunch of new options available to you.
The installer will place shortcuts on your system, one for launching Logos and one for launching the control panel. You can also launch Logos from the control panel by choosing Run Logos.
You can run the GUI version of the program either by double-clicking it or by running the following in the CLI:
DIALOG=tk ./LogosLinuxInstaller
When you run the program and do not have an existing install, you will see something like the following in the control panel.
Click the Install button.
When you do, a new panel will appear: this is the installer panel.
The installer panel requires selecting numerous fields. Fill in each field.
Before you can choose the release, you will need to hit the Get Release List button.
Once you select a release, hit the Get EXE List button.
Once you are satisfied with your selections, click the Install button.
Once you hit the install button, you will see the Status Bar begin reporting the program's ongoing work. Various things will be done in the background, such as installing needed Microsoft fonts, Windows library files, setting necessary registry files, setting font smoothing, and setting the renderer.
After this, the script will download the Logos Bible Software executable and then it will begin the Logos installation by executing the MSI file. You should now see the following window.
Proceed with your Logos Bible Software installation as normal.
Once done, the GUI will return to the control panel menu. You will now have a bunch of new options available to you.
The installer will place shortcuts on your system, one for launching Logos and one for launching the control panel. You can also launch Logos from the control panel by choosing Run Logos.