Error Codes
Error Codes¶
InvenTree is starting to use error codes to help identify and diagnose issues. These are increasingly being added to the codebase. Error messages missing an error code should be reported on GitHub.
Error codes are prefixed with INVE- and are followed by a letter to indicate the type of error and a number to indicate the specific error. Once a code is used it might not be reassigned to a different error, it can be marked as stricken from the list.
INVE-E (InvenTree Error)¶
Errors - These are critical errors which should be addressed as soon as possible.
INVE-E1¶
No frontend included - Backend/web
Only stable / production releases of InvenTree include the frontend panel. This is both a measure of resource-saving and attack surface reduction. If you want to use the frontend panel, you can either:″
- use a docker image that is version-tagged or the stable version
- use a package version that is from the stable or version stream
- install node and yarn on the server to build the frontend with the invoke task int.frontend-build
Raise an issue if none of these options work.
INVE-E2¶
Wrong Invoke Path
The used invoke executable is the wrong one. InvenTree needs to have
You probably have a reference to invoke or a directory with invoke in your PATH variable that is not in InvenTrees virtual environment. You can check this by running which invoke and which python in your installations base directory and compare the output. If they are not the same, you need to adjust your PATH variable to point to the correct virtual environment before it lists other directories with invoke.
INVE-E3¶
Report Context use custom QuerySet
As the django.db.models.QuerySet is not a generic class, we would loose type information without django-stubs. Therefore use the report.mixins.QuerySet generic class when typing a report context.
INVE-E4¶
Model missing report_context return type annotation
Models that implement the InvenTreeReportMixin must have an explicit return type annotation for the report_context function.
INVE-E5¶
Rulesets have issues - Backend
The rulesets used for managing user/group/oAuth permissions have an issue. This might be caused by an addition or removal of models to the code base. Running the test suit should surface more logs with the error code indicating the exact infractions.
INVE-E6¶
Scopes have issues - Backend
The scopes used for oAuth permissions have an issue and do not match the rulesets. This might be caused by an addition or removal of models to the code base or changes to the rulesets. Running the test suit should surface more logs with the error code indicating the exact infractions.
INVE-W (InvenTree Warning)¶
Warnings - These are non-critical errors which should be addressed when possible.
INVE-W1¶
Current branch could not be detected - Backend
During startup of the backend InvenTree tries to detect branch, commit hash and commit date to surface on various points in the UI, through tags and in the API. This information is not needed for operation but very helpful for debugging and support. These issues might be caused by running a deployment version that delivers without git information, not having git installed or not having dulwich installed. You can ignore this warning if you are not interested in the git information.
INVE-W2¶
Dulwich module not found - Backend
See INVE-W1
INVE-W3¶
Could not detect git information - Backend
See INVE-W1
INVE-W4¶
Server is running in debug mode - Backend
InvenTree is running in debug mode. This is not recommended for production use, as it exposes sensitive information and makes the server more vulnerable to attacks. Debug mode is not intended for production/exposed instances, even for short duration.
It is recommended to run InvenTree in production mode for better security and performance. See Debug Mode Information.
INVE-W5¶
Background worker process not running - Backend
The background worker seems to not be running. This is detected by a heartbeat that runs all 5 minutes - this error triggers after not being run in the last 10 minutes. Check if the process for background workers is running and reaching the database. Steps vary between deployment methods. See Background Worker Information.
INVE-W6¶
Server restart required - Backend
The server needs a restart due to changes in settings. Steps very between deployment methods.
INVE-W7¶
Email settings not configured - Backend
Not all required settings for sending emails are configured. Not having an email provider configured might lead to degraded processes as password reset, update notifications and user notifications can not work. Setting up email is recommended. See Email information.
INVE-W8¶
Database Migrations required - Backend
There are database migrations waiting to be applied. This might lead to integrity and availability issues. Applying migrations as soon as possible is recommended.
Some deployment methods support auto applying of updates. See also Perform Database Migrations. Steps very between deployment methods.
INVE-I (InvenTree Information)¶
Information — These are not errors but information messages. They might point out potential issues or just provide information.
INVE-M (InvenTree Miscellaneous)¶
Miscellaneous — These are information messages that might be used to mark debug information or other messages helpful for the InvenTree team to understand behaviour.