Common errors/problems

Note

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

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: '' 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 () 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.

2.8 KiB Raw Blame History