« Close

Datasheets and User Guides

App Notes

Software & Driver


Kipling Troubleshooting

These are some troubleshooting strategies broken down by platform.


Windows XP

Kipling version 3.1.x currently does not run on Windows XP machines. It is recommended to use an old version of the installer to get Kipling version 3.0.x and then upgrade the LJM driver. The other applications that get installed work on Windows XP, just not Kipling.

Mac OS X

When starting Kipling, if it hangs showing only the splash screen and the text "Extracting Static_files", you need to ensure you have permission to write to /usr/local/share/LabJack/ and /usr/local/share/LabJack/K3. A quick fix is to open a terminal window and type the following to make the folder readable and writable:

sudo chmod -R a+rw /usr/local/share/LabJack


Running the command labjack_kipling may give the following error:

/usr/local/bin/labjack_kipling: 10: /usr/local/bin/labjack_kipling: Syntax error: "fi" unexpected

In this case you need to open /usr/local/bin/labjack_kipling and edit it as necessary—you can uncomment line 9 (echo 'Waiting for Kipling to shut down'):

sudo gedit /usr/local/bin/labjack_kipling

Ubuntu 18.04

Ubuntu 18.04 requires a few additional commands to be run before the application will work. If Kipling won't start, try starting it using the command below to get additional debugging information:


  • You may need to install libgconf by running the command below according to this GitHub issue:

    sudo apt -y install libgconf2-4

  • There is a font issue related to libfreetype. There is another GitHub issue here. To fix, run the commands:

    sudo add-apt-repository "deb http://us.archive.ubuntu.com/ubuntu/ artful-updates main"
    sudo apt-get update
    sudo apt-get install libfreetype6=2.8-0.2ubuntu2.1
    sudo apt-mark hold libfreetype6

  • Additionally, if there is an issue loading the "canberra-gtk-module" which is an optional fix. To fix, run the command:

    sudo apt install libcanberra-gtk0 libcanberra-gtk-module

Getting stuck at the Splash Screen?

If the message "Finishing Installation" or "Failed to start IO manager..." is being displayed, please try deleting the K3 folder (see "Temporary File Paths by Operating System" below) and then re-start Kipling. If this doesn't work, please try the latest beta installer as we may have already fixed your issue. If this still doesn't work, please email [email protected].

Temporary File Paths by Operating System:

  • Windows Vista, 7, 8, and 10: C:\ProgramData\LabJack\K3
  • Mac OS X and Linux: /usr/local/share/LabJack/K3

On Windows, the ProgramData folder is hidden by default and you may need to adjust your system settings to show hidden files using the Windows file explorer.

The K3 folder can be deleted by running the following command in a Windows command prompt window:

RMDIR /s C:\ProgramData\LabJack\K3

On Mac and Linux, the temporary directory can be deleted by running the command:

rm -r /usr/local/share/LabJack/K3/*