Troubleshooting Settings

Get help, troubleshoot issues, view app information, and contact support. Access support resources, documentation links, version details, and feedback channels to resolve issues and get the most out of Pieces.

To access Troubleshooting settings, click your User Profile in the top left, then hover over Settings and select Troubleshooting.

Troubleshooting settings showing Online Resources, Get In Touch, PiecesOS Information, and Desktop App Information sections

Online Resources

Access documentation and community resources to find answers and solutions to common issues.

Product Documentation

Access Pieces' official documentation to learn how to use features, configure settings, and get the most out of Pieces.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Online Resources* section. Click the `Product Documentation` option (book icon) to open Pieces' official documentation in your browser.

GitHub Issues

Report bugs, request features, and track known issues on GitHub. The GitHub issues page is a great place to see what others are experiencing and contribute to improving Pieces.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Online Resources* section. Click the `GitHub Issues` option (GitHub Octocat logo icon) to open the Pieces GitHub issues page in your browser.

Get In Touch

Contact the Pieces team directly for personalized support, feedback, or additional help resources.

Book a Support Call

Schedule a one-on-one support call with our team to get personalized assistance with any issues or questions you have.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Get In Touch* section. Click the `Book a Support Call` option (calendar icon) to schedule a support call with the Pieces team.

Contact Us

Send us a message and our team will get back to you. Use this option for general questions, feedback, or issues that don't require immediate attention.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Get In Touch* section. Click the `Contact Us` option (envelope icon) to send a message to the Pieces support team.

More Options

Visit our support hub for additional resources, FAQs, and community support. This provides access to a comprehensive knowledge base and community forums.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Get In Touch* section. Click the `More Options` option (external link icon) to visit the support hub with additional resources, FAQs, and community support.

PiecesOS Information

View information about your installed PiecesOS version, check for updates, and see what port PiecesOS is using. PiecesOS is the core engine that powers all Pieces functionality.

Viewing PiecesOS Version

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *PiecesOS Information* section. Find the "Version" field showing your installed PiecesOS version (e.g., "12.3.5"). Click the `Copy Icon` next to the PiecesOS version to copy the version number to your clipboard.

Viewing PiecesOS Port

View the port number that PiecesOS is currently using. This information is useful for troubleshooting connection issues or configuring integrations.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *PiecesOS Information* section. Find the "Port" field showing the current port (e.g., "39300"). Click the `Copy Icon` next to the PiecesOS port to copy the port number to your clipboard.

Checking for PiecesOS Updates

Manually check if a new version of PiecesOS is available. Updates may include bug fixes, performance improvements, and new features.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *PiecesOS Information* section. Click the `Check for PiecesOS Updates` link (server rack with refresh arrow icon) to manually trigger an update check. If an update is available, you'll be prompted to install it.

Desktop App Information

View information about your installed Pieces Desktop App version, check for updates, and see your platform details. The Desktop App provides the user interface and features built on top of PiecesOS.

Viewing Desktop App Version

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Desktop App Information* section. Find the "Version" field showing your installed Desktop App version (e.g., "5.0.6-staging"). Click the `Copy Icon` next to the Desktop App version to copy the version number to your clipboard.

Viewing Platform Information

View your operating system and platform details. This information is useful for troubleshooting or when seeking support.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Desktop App Information* section. Find the "Platform" field showing your OS version and build information (e.g., "MacOS Version 15.7.3 (Build 24G419)"). Click the `Copy Icon` next to the Platform information to copy the platform details to your clipboard.

Checking for Desktop App Updates

Manually check if a new version of the Pieces Desktop App is available. Updates may include new features, UI improvements, and bug fixes.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Scroll to the *Desktop App Information* section. Click the `Check for Desktop App Updates` link to manually trigger an update check. If an update is available, you'll be prompted to install it. You can also check for Desktop App updates using the keyboard shortcut `shift+U` (macOS) or `shift+U` (Windows/Linux) from anywhere in Pieces.

Keyboard Shortcuts

View all available keyboard shortcuts for Pieces Desktop. Learn shortcuts to navigate faster, perform actions quickly, and improve your workflow efficiency.

Click your `User Profile` in the top left, then hover over `Settings` and select `Troubleshooting`. Find the keyboard shortcuts option or use the keyboard shortcut `⌘+;` (macOS) or `ctrl+;` (Windows/Linux) from anywhere in Pieces.

For a complete reference guide of all keyboard shortcuts, see the Keyboard Shortcuts documentation.

Quick Links

Access common resources and documentation quickly:

Next Steps

Now that you understand how to access troubleshooting resources, learn about Account settings to manage your account and cloud settings, or explore Models to configure AI models and processing modes.