# Error "libwebkitgtk-1.0-0 not found" on Linux

The `libwebkitgtk-1.0-0 not found` error can appear when you run client tools, like Spoon, on Linux (for example, Ubuntu 20.04 and later). The error occurs because some graphical components, such as the embedded browser in Spoon, depend on the `libwebkitgtk-1.0-0` library.

Symptoms of the error include graphical components not opening because the internal web viewer component does not render well and the log showing errors that reference the `libwebkitgtk-1.0-0` library. The `libwebkitgtk-1.0-0 not found` error occurs because the required library isn't available in the default Ubuntu repositories for Ubuntu 20.04 and later.

{% hint style="info" %}
**Note:** If you use PDI command-line tools (Kitchen, Pan, or Carte), you can safely ignore the `libwebkitgtk-1.0-0 not found` error because it affects only the graphical user interface (Spoon).
{% endhint %}

To resolve the `libwebkitgtk-1.0-0 not found` error, add the legacy repository and install the `libwebkitgtk-1.0-0`  library:

1. Open the `/etc/apt/sources.list` file in a text editor with root permissions by running

   `sudo vim /etc/apt/sources.list`.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If vim isn't installed on your system, use another editor, or install vim by running <code>sudo apt install vim</code>.</p></div>
2. Add the following lines to the `sources.list` file:

   ```
   # Add entry to repository that contains the old lib
   deb http://cz.archive.ubuntu.com/ubuntu bionic main universe

   # Alternative link if upper does not work
   #deb http://mirrors.kernel.org/ubuntu bionic main universe
   ```
3. Save the `sources.list` file.
4. Update the repository cache by running `sudo apt-get update`.
5. Install the `libwebkitgtk-1.0-0` library by running `sudo apt-get install libwebkitgtk-1.0-0 -y`.
6. Restart Spoon by running `restart spoon.sh`.

If you encounter the following errors, see the instructions for resolving each error:

* ["GPG error: repository not signed" error](#gpg-error-repository-not-signed-error-appears-when-you-update-apt)
* ["Failed to load module canberra-gtk-module" error](#failed-to-load-module-canberra-gtk-module-error-appears)

## "GPG error: repository not signed" error <a href="#gpg-error-repository-not-signed-error-appears-when-you-update-apt" id="gpg-error-repository-not-signed-error-appears-when-you-update-apt"></a>

After you add the bionic repository, the `apt-get update` might return a GPG key error that indicates the repository isn't signed. To resolve this issue, add the missing public key:

1. Add the public key to your keystore, by running the following command, replacing the example hex identifier (`3B4FE6ACC0B21F32)` with the hex identifier from your error message:

   `sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32`
2. Update the repository cache by running `sudo apt-get update`.
3. Install the `libwebkitgtk-1.0-0` library by running `sudo apt-get install libwebkitgtk-1.0-0 -y`.
4. Restart Spoon by running `restart spoon.sh`.

## "Failed to load module canberra-gtk-module" error  <a href="#failed-to-load-module-canberra-gtk-module-error-appears" id="failed-to-load-module-canberra-gtk-module-error-appears"></a>

After you install the `libwebkitgtk-1.0-0` library, you might see the `Failed to load module canberra-gtk-module` error. This error typically doesn't prevent PDI from running, but you can resolve it by installing the missing modules:

1. Install the missing modules by running

   `sudo apt install libcanberra-gtk-module libcanberra-gtk3-module`.
2. Restart Spoon by running `restart spoon.sh`.

## Workarounds for error libwebkitgtk-1.0-0 not found <a href="#alternative-skip-the-internal-browser-or-use-webkit2" id="alternative-skip-the-internal-browser-or-use-webkit2"></a>

If you don't need the internal Welcome page or Marketplace browser, or if the previous solution doesn't resolve your issue, try one of the following alternatives.

### **Skip the browser**&#x20;

Configure Spoon to ignore the missing `libwebkitgtk-1.0-0` library. The main ETL canvas works normally.

1. Open `spoon.sh` in a text editor.
2. Add the following flag to the `PENTAHO_DI_JAVA_OPTIONS` variable:

   `"-Dorg.eclipse.swt.browser.DefaultType=mozilla"`
3. Save the file.
4. Restart Spoon by running `spoon.sh`.
5. (Optional) If the error persists, replace the flag you added to the `PENTAHO_DI_JAVA_OPTIONS` variable in step 2 with:

   `"-Dorg.eclipse.swt.browser.UseWebKitGTK=false"`
6. Save the `spoon.sh` file.
7. Start Spoon by running `spoon.sh`.&#x20;
8. Confirm that Spoon ignores the missing `libwebkitgtk-1.0-0` library by checking the following results:
   1. The `libwebkitgtk-1.0-0 not found` error does not appear because the JVM no longer scans the system for the `libwebkitgtk-1.0` library during startup.
   2. The Welcome screen is blank, containing an empty gray or white box instead of links or news. The empty box might display an error message.
   3. The Canvas is fully functional with drag-and-drop capabilities.

**What to do next:** You can click **File** > **New** > **Transformation** and start working.

### **Use WebKit2**

Some SWT versions can communicate with `webkit2gtk-4.x`. You can set an environment variable to use the newer library version.

1. Open the `spoon.sh` file in a text editor.
2. Add the following line near the top of the `spoon.sh` file:

   `export SW_GTK_LIB=webkit2`
3. Save the `spoon.sh` file
4. Restart Spoon by running `spoon.sh`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pdia-data-integration/9.3-data-integration/data-integration-issues/error-libwebkitgtk-1.0-0-not-found-on-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
