Issues | Linux

Find out what troubleshooting steps to take if the Pieces Desktop App isn't working properly on your Linux device.

Versions & Updates

Many issues can stem from running outdated versions of Pieces Desktop App on Linux.

Updating Pieces Desktop

On Linux, the Pieces Desktop App is distributed via snaps (for Ubuntu-based systems).

To updated the Pieces Desktop App on Linux:

1

Check the Current Version

Running snap info pieces-for-developers to check the current version

2

Check for Updates

Running sudo snap refresh to apply any available updates

Common Installation Issues

Official support is for Ubuntu 22+ and Ubuntu-based distributions. Other distributions might work but aren’t guaranteed.

Checking Distribution Compatibility

Ensure you’re running a supported Ubuntu-based distribution.

If not, consider switching to a supported environment, as installation on non-Ubuntu distributions isn’t guaranteed.

Updating Snapd

Snap-based installations require an up-to-date snap daemon:

  • Run sudo snap refresh to ensure snapd and its packages are current

Adjusting Graphics & Display Settings

If installation or UI issues persist, consider the following:

  • Switch Between x11 and Wayland: Some applications may work better on one display protocol than the other. Try switching to x11 for compatibility or Wayland for newer features. You can usually select this at the login screen.

  • Update GPU Drivers: Ensure your GPU drivers are up to date. For NVIDIA, check for proprietary driver updates. AMD and Intel users should verify that open-source drivers are current.

  • Optimize Graphics Configurations: Use tools like nvidia-settings, radeon-profile, or similar utilities to adjust your GPU settings for better performance and stability.

These adjustments can resolve many graphical and display-related issues that you may experience while you use Pieces for Developers.

Checking System Information

Verify your system's hardware configuration and ensure it meets the recommended specifications by running specific commands in your terminal.

Checking CPU Information

To determine your CPU type and find other important information, type lscpu in your terminal and press Enter.

Checking GPU Information

To determine your GPU type and find other important information, lspci | grep -i vga in your terminal and press Enter.

Confirm that your CPU, GPU, and memory resources are sufficient for running PiecesOS and local AI models (if applicable).

Checking Ubuntu Version

If the Pieces Installer is not working as intended, you could have an outdated version of Ubuntu. The minimum Ubuntu version that Pieces will run on is Ubuntu 18.

To check what version of Ubuntu you’re running:

1

Open Settings

Open the Settings on Ubuntu by clicking the options bar in the top right

2

Find the System Section

Locate the System section at the bottom of the left-hand side menu and click it

3

Open the About Section

Open the About section and locate the Operating System label

This section will will display your Ubuntu version information.

Consulting Online Resources

If you encounter persistent installation issues, consult online forums or community guides related to snap and Ubuntu-specific troubleshooting steps.

Restart & Retry

If you've updated components, checked hardware, and adjusted configurations without success, restart your machine and try again.

If the problem persists, please open a GitHub issue for further assistance, or book a call with our engineers.

Updated on
Windows
Core Dependencies