Skip to main content
Version: 0.4 (Latest)

CLI Reference

LakeXpress works in two steps:

  1. Create a sync configuration with config create. It is stored in the LakeXpress DB.
  2. Run it with sync, as often as needed.

The other commands manage the LakeXpress DB (lxdb), show run status (status) and remove stale runs (cleanup).

This section describes the syntax and options of each command. For complete, ready-to-run commands, see Examples & Recipes.

Commands​

CommandPurpose
lxdb init, drop, truncate, locks, release-locksManage the LakeXpress DB
config create, list, deleteManage sync configurations
sync, sync[export], sync[publish]Run a sync configuration
statusShow syncs and runs
cleanupRemove stale or failed runs
runRun a legacy YAML configuration

Command Line Structure​

usage: LakeXpress [-h] [--version] [--no_banner]
COMMAND [SUBCOMMAND] [OPTIONS]

-h, --version and --no_banner can be placed before the command. All other options go after the command, for example LakeXpress sync --log_level DEBUG ....

Common Options​

Every command accepts these options. The pages of each command list only its own options.

OptionDescription
-a, --auth_file PATHCredentials JSON file. Required by every command except run
--lxdb_auth_id IDEntry of the credentials file for the LakeXpress DB. Required by every command except run
--log_level LEVELDEBUG, INFO (default), WARNING or ERROR
--log_dir PATHDirectory for log files (default: current directory). See Logging
--no_progressDisable the progress bar
--no_bannerDo not print the startup banner
--quiet_fbcpDo not copy FastBCP log lines into the LakeXpress logs (statistics are still recorded)
--license TEXTLicense text (alternative to the LAKEXPRESS_LICENSE environment variable)
--license_file PATHPath to a license file
-h, --helpShow the help of the command and exit

LakeXpress --version shows the version and the date the binary was built.

License Resolution​

LakeXpress looks for a license in this order:

  1. LAKEXPRESS_LICENSE environment variable
  2. --license
  3. --license_file
  4. Default file locations:
    • Linux/Mac: ~/.lakexpress/license.lic
    • Windows: %APPDATA%/LakeXpress/license.lic
    • Current directory: ./license.lic
  5. Trial mode: 30 days from the build date of the binary (shown by --version)
Copyright © 2026 Architecture & Performance.