winIDEA Help

Quick start

Set up a Linux host to run winIDEA from a Flatpak by installing Flatpak, adding the required host configuration, installing the external runtime dependency, and launching winIDEA.

 

1.Install the flatpak package.

2.Register the udev rule for BlueBox devices.

3.Install the required Flathub runtime dependency.

4.(optinal) Apply the RHEL-9 SELinux setting and configure firewalld when applicable.

 

Result: winIDEA is installed and available from the desktop application launcher or via terminal with the flatpak run command.

 

 

Overview

This guide explains how to prepare a Linux host for the Flatpak version of winIDEA. Use it for a single winIDEA installation when you want Flatpak to manage the application and its runtime dependencies.

The setup process involves installing necessary dependencies and configuring the Linux operating system.

 

After completing the guide, you can install and launch winIDEA as the current user or you can adapt the installation command for a system-wide installation by removing the --user option.

 

 

Before you start

Make sure you have:

•Linux host

•Administrative privileges for installing packages and creating the udev rule

•winIDEA version 9.26.11 or newer

 

 

 

Customize operating system

Step 1: Install Flatpak

Install the flatpak package using your Linux distribution's package manager. This step requires administrative privileges.

 

 

Step 2: Register the hardware debugger udev rule

The udev rule gives the Flatpak version of winIDEA access to hardware debugger device connected over USB.

 

Run the following command with administrative privileges for e.g., TASKING BlueBox Hardware Debugger:

$ echo 'ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="06f9", MODE="0666"' | sudo tee /etc/udev/rules.d/bluebox-usb.rules

 

 

Step 3: Install the external Flatpak dependency

The current winIDEA Flatpak package does not install all required external Flatpaks automatically. Add the Flathub repository for the current user, then install the 32-bit compatibility runtime.

 

Run:

$ flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

$ flatpak install --user --assumeyes flathub org.freedesktop.Platform.Compat.i386//25.08

 

If the dependency of the flatpak package org.freedesktop.Platform.Compat.i386 is not installed, winIDEA breaks execution with a runtime error:

/lib/ld-linux.so.2: could not open

 

The required compatibility runtime is now installed for the current user.

 

 

Step 4 (for RHEL-9): Configure SELinux on RHEL-9

Skip this step unless you are running RHEL-9 and its default SELinux enforcing policy prevents the Wine environment from accessing required system resources.

 

Enable the required SELinux boolean permanently:

$ sudo setsebool -P selinuxuser_execmod 1

 

Result: The SELinux setting remains enabled after a reboot.

 

 

Step 5: Configure the firewall when remote access is required

Linux firewall rules can prevent remote access. Several firewall implementations are available, so first determine which firewall your host uses.

 

1. For firewalld, check the current default zone:

$ sudo firewall-cmd --get-default-zone

 

If the result is public and your security policy allows it, change the default zone to trusted:

$ sudo firewall-cmd --set-default-zone=trusted

 

Confirm the new zone:

$ sudo firewall-cmd --get-default-zone

 

Expected output:

trusted

 

Result: The host uses the trusted default zone for firewalld, which allows the remote access required by your setup.

 

 

 

Get started with winIDEA

Step 1: Download and install winIDEA

1. Download the portable winIDEA Flatpak archive from the winIDEA Download page.

 

2. Install the archive for the current user:

$ flatpak install --user --assumeyes *winIDEA-<version>.flatpak

 

3. (optional) For a system-wide installation, remove the --user option from the command. Use the downloaded archive name in place of *winIDEA-<version>.flatpak if shell expansion does not select it.

 

 

Step 2: Launch winIDEA

Flatpak integrates the installed application into the desktop environment or terminal:

 

•Open the Application launcher (press <Meta> key), search for winidea; and start it from the Development group.

•Start winIDEA from a terminal

owith no additional command-line arguments:

$ flatpak run --command=winidea com.tasking.winIDEA

 

owith custom arguments, append them to the command:

$ flatpak run --command=winidea com.tasking.winIDEA <optional args>

 

 

 

Result

After completing the steps, you have:

•Configured Linux host: Flatpak and the required external compatibility runtime are installed.

•Hardware debugger USB access, e.g. for BlueBox USB access - the udev rule is registered for the winIDEA Flatpak environment.

•Installed winIDEA application: winIDEA is installed for the current user or system-wide, depending on the command you used.

•Launch method: You can start winIDEA from the application launcher or with flatpak run.

 

 

Validation

Start winIDEA from the terminal and run:

$ flatpak run --command=winidea com.tasking.winIDEA

 

Result: The winIDEA application opens. If you use a BlueBox device, confirm that it is available to winIDEA after connecting it to the Linux host.