QuantLake
GitHub
Documentation

Managing the server

Check, update, move and uninstall quantlake-server, and what it does in the background.

Common tasks

TaskHow
Check the statusquantlake status, or systemctl status quantlake-server
Follow the logsjournalctl -u quantlake-server -f
Change the settingsquantlake config set …. The server picks up the change within a few seconds, without a restart
Move the data lakesudo quantlake-server install --lake-root /path/to/lake
Check the dataquantlake verify
Uninstallsudo quantlake-server uninstall

What the server does in the background

  • Downloads the days of each collection target, oldest first, with server.concurrency days at the same time (4 by default).
  • Picks up new days within an hour after the provider publishes them.
  • Stays within the rate limits of each provider.
  • Retries failed downloads. See Some days failed to download for how long it waits.
  • Stops starting new downloads when free disk space falls below server.min_free_gb (20 GB by default).
  • Checks every file against the catalog each week, and downloads again any file that was changed.
  • Checks every month for days that the provider has published again, and downloads them again.

Update QuantLake

Pull the new version, then run mise run deploy, or rebuild and run install again:

git pull
dotnet publish src/QuantLake.Server/QuantLake.Server.csproj -c Release -r linux-x64 -o artifacts/linux-x64
dotnet publish src/QuantLake.CLI/QuantLake.CLI.csproj -c Release -r linux-x64 -o artifacts/linux-x64
sudo ./artifacts/linux-x64/quantlake-server install

Your data, settings and keys are kept. If the new version changes the file format, the server downloads the saved days again in the new format.

Uninstall

sudo quantlake-server uninstall

This removes the service and the binaries, but keeps your data, settings and keys. Add --purge to also delete the key pair; stored secrets can then no longer be decrypted.

To delete the whole data lake after you uninstall, unlock the files first:

sudo chattr -R -i ~/.local/share/quantlake
rm -rf ~/.local/share/quantlake