85 lines
2.8 KiB
Markdown
85 lines
2.8 KiB
Markdown
|
# Common errors/problems
|
||
|
|
|
||
|
|
> **Note**<br>
|
||
|
|
> The following page is based on version `1.0.0` of BrickTracker.
|
||
|
|
|
||
|
|
## I need a password to access some pages
|
||
|
|
|
||
|
|
You have setup lightweight authentication. Your password is in your environement `BK_AUTHENTICATION_PASSWORD` variable.
|
||
|
|
|
||
|
|
## I cannot access the Add page (Configuration missing!)
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
You need to pass the `BK_REBRICKABLE_API_KEY` environment to your application, depending on how you run the application.
|
||
|
|
For instance:
|
||
|
|
|
||
|
|
- Docker: `docker run -e BK_REBRICKABLE_API_KEY=xxxx`
|
||
|
|
- Docker compose (directly in `compose.yaml`):
|
||
|
|
|
||
|
|
```
|
||
|
|
services:
|
||
|
|
bricktracker:
|
||
|
|
environment:
|
||
|
|
- BK_AUTHENTICATION_KEY=xxxx
|
||
|
|
```
|
||
|
|
|
||
|
|
- Docker compose (with an environement file, for instance `.env`)
|
||
|
|
|
||
|
|
```
|
||
|
|
-- .env
|
||
|
|
BK_AUTHENTICATION_KEY=xxxx
|
||
|
|
|
||
|
|
-- compose.yaml
|
||
|
|
services:
|
||
|
|
bricktracker:
|
||
|
|
env_file: ".env"
|
||
|
|
```
|
||
|
|
|
||
|
|
> **Warning**<br>
|
||
|
|
> Do not use quotes (", ') around your environment variables.
|
||
|
|
> Docker will interpret them has being part of the **value** of the environment variable.
|
||
|
|
> For instance...
|
||
|
|
>
|
||
|
|
> ```
|
||
|
|
> services:
|
||
|
|
> bricktracker:
|
||
|
|
> environment:
|
||
|
|
> - BK_AUTHENTICATION_KEY="xxxx"
|
||
|
|
> ```
|
||
|
|
>
|
||
|
|
> ...will make Docker believe that your API key is `"xxxx"`.
|
||
|
|
|
||
|
|
## The socket is disconnected
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
If you are seeing the socket disconnected while you are on the **Add** or **Bulk add** pages, it can mean:
|
||
|
|
|
||
|
|
- The application is not running anymore (it somehow stopped after you accessed the page): check that the application is running and its log for errors,
|
||
|
|
- You restarted the application and it can take some time for the socket to be back up: just wait a bit it should automatically re-connect,
|
||
|
|
- You are using the CORS allowed origin restriction (via the `BK_DOMAIN_NAME` environment variable) with a mismatching value: you should see a log line similar to this following one in your application logs.
|
||
|
|
|
||
|
|
```
|
||
|
|
http://127.0.0.1:3333 is not an accepted origin. (further occurrences of this error will be logged with level INFO)
|
||
|
|
[2025-01-18 18:15:52,980] ERROR - http://127.0.0.1:3333 is not an accepted origin. (further occurrences of this error will be logged with level INFO)
|
||
|
|
```
|
||
|
|
|
||
|
|
Make sure the value you have set is matching the URL of your application.
|
||
|
|
If it is not the case, adjust the value and restart the application.
|
||
|
|
|
||
|
|
|
||
|
|
## No such file or directory: '<path>' when adding a set
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
The application doestake care of creating folders for static images and expects them to be writable.
|
||
|
|
Make sure that the folder exists, and if it exists that it is writable by the application.
|
||
|
|
|
||
|
|
## I'm seeing Unknown (<number>) instead of the set theme
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Either the theme is too recent for your version of the themes file, or your theme file has not be initialized.
|
||
|
|
Head to the **Admin** page, **Themes** section and update the file.
|