Prepare The Binary

Every deployment starts with a LyftData executable:

• lyftdata (server/CLI)
• lyftdata-worker (worker-only; optional for external worker hosts)

Note

Complete the installation prerequisites for each host before downloading the binary.

For evaluation and single-host installs, lyftdata is sufficient (server + built-in worker). For dedicated external worker hosts, you can deploy lyftdata-worker instead.

Note

The examples below use the server/CLI binary (lyftdata) and the current stable release path (release/latest). For worker-only installs, replace lyftdata-… with lyftdata-worker-… in the download URLs and use lyftdata-worker --version when verifying. If you need a beta build or another artifact, start from the Downloads page.

Linux (systemd hosts)

1. Download the archive

   mkdir -p /opt/lyftdata
   cd /opt/lyftdata
   curl -LO https://downloads.lyftdata.com/release/latest/lyftdata-x86_64-unknown-linux-gnu.tar.xz

2. (Optional) Verify the checksum

   curl -LO https://downloads.lyftdata.com/release/latest/lyftdata-x86_64-unknown-linux-gnu.tar.xz.sha256
   sha256sum -c lyftdata-x86_64-unknown-linux-gnu.tar.xz.sha256

3. Extract the archive and make it executable

   tar -xJf lyftdata-x86_64-unknown-linux-gnu.tar.xz
   cp lyftdata-x86_64-unknown-linux-gnu/lyftdata ./lyftdata
   chmod +x ./lyftdata

   If you prefer a global location, create a symlink:

   sudo ln -s /opt/lyftdata/lyftdata /usr/sbin/lyftdata

4. Confirm the version

   ./lyftdata --version

macOS (launchd hosts)

1. Download the archive

   mkdir -p /usr/local/lib/lyftdata
   cd /usr/local/lib/lyftdata
   curl -LO https://downloads.lyftdata.com/release/latest/lyftdata-aarch64-apple-darwin.tar.xz

   macOS downloads are currently published for Apple Silicon (arm64). See System Requirements for platform requirements.

2. (Optional) Verify the checksum

   curl -LO https://downloads.lyftdata.com/release/latest/lyftdata-aarch64-apple-darwin.tar.xz.sha256
   shasum -a 256 -c lyftdata-aarch64-apple-darwin.tar.xz.sha256

3. Extract and install the binary

   tar -xJf lyftdata-aarch64-apple-darwin.tar.xz
   chmod +x lyftdata-aarch64-apple-darwin/lyftdata
   sudo mv lyftdata-aarch64-apple-darwin/lyftdata /usr/local/bin/lyftdata
   # Remove the Gatekeeper quarantine flag so the unsigned binary can run
   sudo xattr -d com.apple.quarantine /usr/local/bin/lyftdata || true

   Note

   If you extracted the archive with Finder, the quarantine flag can be applied to the whole directory. Run sudo xattr -dr com.apple.quarantine /usr/local/lib/lyftdata before moving the binary, or execute the commands above from Terminal to clear the attribute. Use man xattr on macOS to learn more about how the command manages extended attributes.

4. Confirm the version

   lyftdata --version

Windows (PowerShell)

1. Download the archive

   $downloadDir = 'C:\Program Files\LyftData'
   New-Item -ItemType Directory -Path $downloadDir -Force | Out-Null
   Invoke-WebRequest -Uri https://downloads.lyftdata.com/release/latest/lyftdata-x86_64-pc-windows-msvc.zip -OutFile "$downloadDir\lyftdata.zip"
   Unblock-File -Path "$downloadDir\lyftdata.zip" -ErrorAction SilentlyContinue

2. (Optional) Verify the checksum

   Invoke-WebRequest -Uri https://downloads.lyftdata.com/release/latest/lyftdata-x86_64-pc-windows-msvc.zip.sha256 -OutFile "$downloadDir\lyftdata.zip.sha256"
   $expected = (Get-Content "$downloadDir\lyftdata.zip.sha256").Split()[0]
   $actual = (Get-FileHash "$downloadDir\lyftdata.zip" -Algorithm SHA256).Hash
   if ($expected -ne $actual) { throw "Checksum mismatch: expected $expected but saw $actual" }

3. Extract the archive

   Expand-Archive -Path "$downloadDir\lyftdata.zip" -DestinationPath $downloadDir -Force
   Unblock-File -Path "$downloadDir\lyftdata.exe" -ErrorAction SilentlyContinue

4. Confirm the version

   & "$downloadDir\lyftdata.exe" --version

   Add $downloadDir to PATH or copy lyftdata.exe into a directory that is already on PATH so services can find it.

   Note

   If you extracted the archive with File Explorer, Windows may mark the files with the “Downloaded from the Internet” flag. Running Unblock-File clears that mark so SmartScreen does not prompt when the service starts—see the Microsoft PowerShell documentation for more details. Alternatively, right-click the ZIP (or lyftdata.exe), choose Properties, and select Unblock before running the installer commands.

Once the executable is available on the host, continue with the platform-specific server and worker setup guides.