Troubleshooting
Common issues
Section titled “Common issues”PineXQ deploy cannot find file
Section titled “PineXQ deploy cannot find file”cannot connect to docker socket: Error while fetching server API version: (2, 'CreateFile', 'The system cannot find the file specified.')
This error most often occurs if Docker is not running. Start Docker manually and try again.
Input/output files are not UTF8-encoded
Section titled “Input/output files are not UTF8-encoded”Procon, like many applications, uses locale settings to determine encoding.
For local testing, especially on Windows machines, it may be necessary to set Python to use UTF-8.
Simply set the environment variable PYTHONUTF8=1.
Pinexq client version mismatch
Section titled “Pinexq client version mismatch”UserWarning: Version mismatch between 'pinexq_client' (v9.4.0) and 'JobManagementAPI' (v9.3.0)!
This indicates that the API version differs between your client and the system.
This can sometimes cause errors that prevent your workers from working.
If your client’s version is lower, you may wish to try updating your client, e.g. with uv sync --upgrade-package pinexq-client.
No logs on portal
Section titled “No logs on portal”Procon connects to Python’s logging system by configuring the root logger.
Configuring the root logger yourself during runtime, e.g. with logging.basicConfig(), can interfere with this process,
and should be avoided, especially during import time.
If necessary, logging can be configured during tests, e.g. using pytest’s caplog fixture.