mirror of
https://github.com/Part-DB/Part-DB-server.git
synced 2025-12-06 11:09:29 +00:00
0000cd7a02
Some checks failed
Build assets artifact / Build assets artifact (push) Has been cancelled
Docker Image Build / docker (push) Has been cancelled
Docker Image Build (FrankenPHP) / docker (push) Has been cancelled
Static analysis / Static analysis (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.2, mysql) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.3, mysql) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.4, mysql) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.5, mysql) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.2, postgres) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.3, postgres) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.4, postgres) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.5, postgres) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.2, sqlite) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.3, sqlite) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.4, sqlite) (push) Has been cancelled
PHPUnit Tests / PHPUnit and coverage Test (PHP 8.5, sqlite) (push) Has been cancelled
* Initial plan * Fix spelling and grammar mistakes in documentation Co-authored-by: jbtronics <5410681+jbtronics@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: jbtronics <5410681+jbtronics@users.noreply.github.com>
55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
---
|
|
layout: default
|
|
title: Troubleshooting
|
|
---
|
|
|
|
# Troubleshooting
|
|
|
|
Sometimes things go wrong and Part-DB shows an error message. This page should help you to solve the problem.
|
|
|
|
## Error messages
|
|
|
|
When a common, easily fixable error occurs (like a non-up-to-date database), Part-DB will show you some short instructions
|
|
on how to fix the problem. If you have a problem that is not listed here, please open an issue on GitHub.
|
|
|
|
## General procedure
|
|
|
|
If you encounter an error, try the following steps:
|
|
|
|
* Clear the cache of Part-DB with the console command:
|
|
|
|
```bash
|
|
php bin/console cache:clear
|
|
```
|
|
|
|
* Check if the database needs an update (and perform it when needed) with the console command:
|
|
|
|
```bash
|
|
php bin/console doctrine:migrations:migrate
|
|
```
|
|
|
|
If this does not help, please [open an issue on GitHub](https://github.com/Part-DB/Part-DB-symfony).
|
|
|
|
## Search for the user and reset the password:
|
|
|
|
You can list all users with the following command: `php bin/console partdb:users:list`
|
|
To reset the password of a user you can use the following
|
|
command: `php bin/console partdb:users:set-password [username]`
|
|
|
|
## Error logs
|
|
|
|
Detailed error logs can be found in the `var/log` directory.
|
|
When Part-DB is installed directly, the errors are written to the `var/log/prod.log` file.
|
|
|
|
When Part-DB is installed with Docker, the errors are written directly to the console output.
|
|
You can see the logs with the following command, when you are in the folder with the `docker-compose.yml` file
|
|
|
|
```bash
|
|
docker-compose logs -f
|
|
```
|
|
|
|
Please include the error logs in your issue on GitHub, if you open an issue.
|
|
|
|
## Report Issue
|
|
|
|
If an error occurs, or you found a bug, please [open an issue on GitHub](https://github.com/Part-DB/Part-DB-symfony).
|