Guides/Linux Installation

From J Wiki
Jump to: navigation, search

Initial installation of J901

For any linux distribution, the starting point is to install J901 in your home folder. To install J901 with the qtide, download the linux zip from the jsofware website and extract it to your home folder.

For the full version, start jconsole and run the following:

load'pacman'
'install'jpkg'*'

For the slim version, start jconsole and run

load'pacman'
je_update_jpacman_''
install'slim'

Before running jqt, you will need to make sure that the necessary Qt libraries are installed on your system. The required libraries are listed below for various linux distributions. Note that the instructions below specify installing the development libraries, which include the necessary runtime libraries. If you never plan to build jqt, you could just install the equivalent runtime libraries, but you won't really be saving much disk space.

The jqt binaries installed using the above commands were built on Debian 9. They will work on many but not all linux distributions and you may need to build new binaries as described below. When all of the necessary libraries (and the correct jqt binaries) are installed, you can run jqt.sh from the J901 installation folder.

The 'install' jpkg '*' command will also place shortcuts to jqt, jconsole, and jhs on your desktop. These shortcut files may be found in the Desktop folder in your home directory. Whether they appear on your desktop depends on your system settings. You may need to enable that feature using the gnome tweak tool or other methods, enable the launcher by right clicking the desktop shortcut, or edit the content of the .desktop file. Google "desktop shortcuts" for your distribution. If you installed the slim version as above, you can generate the shortcuts by loading pacman and executing shortcut_jpacman_.

Building jqt

In order to build jqt from source, you will need to ensure that the necessary development tools (g++, make, etc.) as well as the development versions of the Qt libraries are installed.

Use git to clone the qtide source.

git clone https://github.com/jsoftware/qtide.git

Running makeall.sh in the source directory will build the full jqt binaries. To build the slim version,

export JQTSLIM=JQTSLIM

prior to running makeall.sh.

Copy the files in bin/linux-x86_64/release to the bin directory of your j901 folder, replacing the files that are there. Running jqt.sh from the j901 folder should now start the ide.

A more detailed discussion of building jqt on Linux is available at Guides/Compiling Jqt/Linux.

Distribution specific information

For all the distributions below, the most recent (LTS if available) release was installed as a development workstation in a VMware VM. In general, development packages for the Qt libraries are installed to facilitate building jqt, if desired. Note that you could also download the latest Qt sdk for linux and build the jqt binaries using those libraries. The current jqt code works fine when compiled with the Qt 5.14.1 sdk.

Debian 10/Ubuntu 18.04/Linux Mint 19.3/MX 19.1

The instructions below should apply to the many Ubuntu-based distributions. For these distros, the jqt binaries (built on Debian 9) available on the jsoftware website will work well.

The following Qt packages need to be installed for the full version of jqt. Only the first line is required to run the slim version; both lines are required for the full version of jqt.

sudo apt install qt5-default libqt5websockets5-dev libqt5svg5-dev
sudo apt install qtwebengine5-dev qtmultimedia5-dev libqt5multimedia5-plugins

In either case, you should now have a working version of j901/qtide. Start jqt by running jqt.sh in the j901 directory.

Ubuntu 20.04

The slim jqt binaries from the jsoftware website will work on Ubuntu 20.04. However, building the jqt binaries is advised for the slim version and required for the full version. Install the Qt libraries as described above for Ubuntu 18.04, then build the required jqt binaries.

CentOS 8.1/RHEL 8.1

Workstation and development packages are installed. Both the PowerTools and EPEL repos need to be available.

sudo yum config-manager --set-enabled PowerTools
sudo dnf install epel-release

The slim jqt binaries from the jsoftware website will work on CentOS/RHEL 8.1. However, building the jqt binaries is advised for the slim version and required for the full version. To install the Qt development libraries,

sudo dnf install qt5-devel.noarch
sudo dnf install qt5-qtwebengine-devel

The second package is not needed for the slim version of jqt.

CentOS 7.7/RHEL 7.7

The EPEL repo needs to be available.

sudo yum install epel-release

Next make sure that the necessary Qt libraries are installed (only the first line is required for slim jqt, both required for the full jqt version):

sudo yum install qt5-qtbase-devel qt5-qtsvg-devel qt5-qtwebsockets-devel
sudo yum install qt5-qtwebkit-devel qt5-qtmultimedia-devel

CentOS 7.7 does not support webengine. You need to export JQTWEBKIT=JQTWEBKIT in order to use webkit rather than webengine. Then running the makeall.sh script will build the full jqt binaries.

Fedora 31

Install the required Qt libraries (only the first line is required for slim jqt, both for full jqt):

sudo dnf install qt5-devel
sudo dnf install qt5-qtwebengine-devel

The slim jqt binaries from the jsoftware website will work on Fedora. However, building the jqt binaries is advised for the slim version and required for the full version.

Recent Fedora distributions use Wayland by default for displaying Qt applications. This display leads to artifacts for some of the web related demos (webd3, webgl, webview). To use the X11 platform instead, export QT_QPA_PLATFORM=xcb. You could add that command to jqt.sh. With this setting, the demos appear as intended.

Manjaro 18.1

Install Qt libraries using

sudo pacman -S qt5

The slim jqt binaries from the jsoftware website will work on Manjaro. However, building the jqt binaries is advised for the slim version and required for the full version.


OpenSUSE 15.1

Install Qt libraries using

zypper install -t pattern devel_qt5

Both the slim and full jqt binaries from the jsoftware website will work on openSUSE. You may wish to build qtide using the newer Qt libraries in openSUSE 15.1.

Solus 4.1

Install Qt libraries (only the first line is required for slim jqt, both for full jqt):

sudo eopkg install qt5-base-devel qt5-websockets-devel qt5-svg-devel
sudo eopkg install qt5-webengine-devel qt5-multimedia-devel

The slim jqt binaries from the jsoftware website will work on Solus. However, building the jqt binaries is advised for the slim version and required for the full version.

Make sure that the development tools are installed:

sudo eopkg install -c system.devel
sudo eopkg install git