Skip to content

Desktop Application Guide

Installation Options

LLMInspect provides desktop applications for multiple operating systems:

  • Linux: Available as .deb package and AppImage format
  • macOS: Available as .dmg format
  • Windows: Available as .exe format

Application Architecture

The desktop application is a packaged frontend that communicates with your backend server through an API. Here's how it works:

  1. The frontend runs as a desktop application on your computer
  2. The backend runs on your server
  3. Communication happens via API calls between the frontend and backend

Backend Configuration

Default Settings

By default, the backend URL is configured as: 

http://localhost:3080/api/

The configuration is stored in config.json with the following structure: 

{
  "backendUrl": "http://localhost:3080/api/"
}

Changing Backend URL

You can modify the backend URL by following these steps:

  1. Locate your config.json file based on your operating system:

    Linux

    ~/.config/InspectChat/config.json

    Windows

    %APPDATA%\InspectChat\config.json

    macOS

    ~/Library/Application Support/InspectChat/config.json

  2. Edit the backend URL in the config file

  3. Save the file
  4. Restart the application for changes to take effect

Viewing Current Configuration

To check your current backend configuration:

  1. Click on Help in the menubar
  2. Select Backend Information
  3. A dialog will appear showing:
    • Current backend URL
    • Config file location
Image title
Backend Configuration Dialog

Troubleshooting Tips

Before using the application:

  • Important: Ensure the backend server is running and accessible before starting the application
  • Verify your network connection
  • Check if the configured port (default: 3080) is accessible

Common issues and solutions:

Issue Solution
App won't connect Check if backend server is running
Changes not appearing Restart the application
Wrong backend URL Verify config.json and restart
Connection refused Check firewall settings and port accessibility

Additional troubleshooting steps:

  • Verify the URL in your config file is correct
  • Ensure you've restarted the app after config changes
  • Check your firewall settings allow the connection
  • Verify the port specified in the URL is accessible

Need Help?

If you encounter any issues:

  • Visit our support forum
  • Contact your system administrator for backend-related issues