Documentation
Troubleshooting
Common problems and how to fix them.
"Operation not permitted" when I change files in the lake
This is intended. The files are locked so that nothing changes them by accident. Use quantlake delete or quantlake recollect instead. If you unlock the files with sudo chattr -i and change them anyway, quantlake verify reports the change and the server downloads those days again.
quantlake status says the server is not running
Check systemctl status quantlake-server and journalctl -u quantlake-server. Targets and requests that you register in the meantime are kept, and the server processes them when it starts again.
A target shows as not available
Your plan may not include that exchange, symbol or date range, or the symbol may be written wrongly. Check what you can download:
quantlake available --exchange binance-futures --data-type trades --symbol BTCUSDT --refresh --wait- Tardis.dev: grouped symbols, such as
PERPETUALS, are not supported. - Databento: check how the symbol is written (see Exchanges and symbols). A single contract, such as
ESZ6, is only available for the days on which it was listed.
Some days failed to download
quantlake status lists each failure and when the server will try again:
| Kind | Meaning | Next try |
|---|---|---|
transient | Network or provider server error | With backoff, waiting at most 6 hours |
not_published | The provider has not published the day yet | After 1 hour |
over_budget | The Databento day costs more than the budget left this month | After 1 day. See Paying for Databento data |
forbidden | Your API key does not include this data | After 1 day |
not_found | The provider has no data for this day | After 1 day |
invalid | The request was not valid | After 1 day |
Run quantlake recollect for the range to retry right away. With Tardis.dev, a 403 error usually means that the same API key was used from another IP address. It clears after about 15 minutes.
Downloads stopped
Free disk space has probably fallen below the threshold. quantlake status shows the message and the free space. Free up space, or lower the threshold:
quantlake config set server.min_free_gb 10