Worker Installation

Windows worker installation

Use these steps to install an external Lyft Data worker on Windows so it can connect to an existing server. Run all commands in an elevated PowerShell prompt.

Before you begin

Complete the installation prerequisites, install NSSM, ensure the binary is on PATH, and create a worker ID plus API key on the server. Confirm availability with lyftdata --version from an elevated PowerShell prompt.

Prepare the worker account

Note

Use the Windows service account template with user lyftdata-worker and data directory C:\ProgramData\LyftData\worker.

Success criteria

• Get-Service LyftDataWorker reports Status : Running.
• The worker shows as Online in the UI within one polling interval (15 seconds by default).
• Get-Content "C:\\ProgramData\\LyftData\\worker\\worker.log" -Tail 20 shows successful registration without authentication errors.

Configure environment variables

Set the worker’s identity and connection details as machine-scoped environment variables:

powershell [Environment]::SetEnvironmentVariable("LYFTDATA_WORKER_ID", "worker-01", "Machine") [Environment]::SetEnvironmentVariable("LYFTDATA_WORKER_API_KEY", "<your-api-key>", "Machine") [Environment]::SetEnvironmentVariable("LYFTDATA_URL", "http://server-host:3000", "Machine") [Environment]::SetEnvironmentVariable("LYFTDATA_JOBS_DIR", "C:\\ProgramData\\LyftData\\worker", "Machine") [Environment]::SetEnvironmentVariable("LYFTDATA_LICENSE_EULA_ACCEPT", "yes", "Machine")

Optional settings

Before starting the service, add any other worker flags here—for example, LYFTDATA_WORKER_METRICS_INTERVAL to enable metrics collection or LYFTDATA_URL pointing at a staging control plane. Restarting the service after edits picks up the new environment immediately.

Install the worker service with NSSM

`powershell nssm install LyftDataWorker “C:\Program Files\LyftData\lyftdata.exe” run worker nssm set LyftDataWorker AppDirectory “C:\Program Files\LyftData” nssm set LyftDataWorker AppStdout “C:\ProgramData\LyftData\worker\worker.log” nssm set LyftDataWorker AppStderr “C:\ProgramData\LyftData\worker\worker-error.log” nssm set LyftDataWorker ObjectName ”.\lyftdata-worker” "" nssm set LyftDataWorker Start SERVICE_AUTO_START

Start-Service LyftDataWorker `

Replace with the password for the lyftdata-worker service account before running the command.

Tip: parameterise the block above in a reusable install-lyftdata-worker.ps1 script so you can roll out additional workers quickly while keeping credentials in your Secrets Manager.

Verify the worker is online

`powershell

Confirm the Windows service is running

Get-Service LyftDataWorker `

Check the server UI to confirm the worker shows online. If the worker does not appear in the dashboard, review the log at C:\ProgramData\LyftData\worker\worker.log and verify the worker ID, API key, and server URL.

Next steps

• Deploy jobs to the new worker from the server UI
• Repeat the process on additional hosts to scale out
• Follow the post-install checklist to enable metrics and exercise the job editor