Documentation
Error Codes

Error Codes

This article summarizes error codes in the Jan application, categorized by application feature. Each error includes a unique code and a Prefix indicating its category. The following sections detail the error categories, their descriptions, and the error types.

See the Solution column for error troubleshooting.

Error Code Categories

1. Installation Errors

These errors relate to issues encountered during installation, including desktop and server setups.

  • Prefix: INST

2. Hardware Setup Errors

These errors relate to configuring and setting up hardware components.

  • Prefix: HW

Error Types

Error CodeCauseSolution
HW-1The CUDA toolkit may be unavailable.Troubleshooting Nvidia GPU
HW-2Problem with Nvidia drivers.Troubleshooting Nvidia GPU

3. Architecture Errors

These errors relate to problems with the overall system architecture and configuration setups.

  • Prefix: ARCH

4. Basic Usage Errors

These errors occur during the basic usage of the application, including issues with models, assistants, and tools.

  • Prefix: USG

Error Types

Error CodeCauseSolution
USG-1Model is currently unavailable.How to Use Model

5. Advanced Settings Errors

These errors relate to advanced settings and configurations within the application.

  • Prefix: ADV

6. Inference Engine Errors

These errors relate to inference engines, both local and remote.

  • Prefix: IE

Error Types

Error CodeCauseSolution
IE-2The OpenAI model's API key is invalid.How to Integrate OpenAI API
IE-3The Groq model's API key is invalid.How to Integrate Groq API
IE-4The Mistral model's API key is invalid.How to Integrate Mistral API
IE-5The OpenRouter model's API key is invalid.How to Integrate OpenRouter API

7. Local API Server Errors

These errors relate to the local API server's functionality.

  • Prefix: API

Error Types

Error CodeCauseSolution
API-1Port 3928 is currently unavailable.Local API Server Guide

8. Extensions and Integration Errors

These errors relate to integrating the application with external systems or extensions.

  • Prefix: EXT

9. Troubleshooting Errors

These errors occur during the troubleshooting processes and procedures.

  • Prefix: TRO

10. Unclear Errors

These errors don't classify into the standard categories above, making their causes difficult to identify.

Error Codes

Error TitleSolution
Something’s AmissTroubleshooting Something’s Amiss
Undefined IssueTroubleshooting Undefined Issue