Server Installation

Windows server installation

These steps install the Lyft Data server as a Windows service. All commands below must be run from an elevated PowerShell prompt.

Before you begin

Complete the installation prerequisites, install NSSM, and extract the binary to C:\Program Files\LyftData. Confirm lyftdata --version from an elevated PowerShell prompt.

Prepare the server account

Note

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

Success criteria

• Get-Service LyftDataServer reports Status : Running.
• Test-NetConnection -ComputerName localhost -Port 3000 succeeds from the server.
• Get-Content "C:\\ProgramData\\LyftData\\server\\server.log" -Tail 50 | Select-String "Server started" shows the expected startup entry with no errors.

Need a trial-only setup? Start with the Evaluation Quickstart before wiring services with NSSM.

Configure environment variables

Set the required environment variables once so the Windows service can pick them up on every boot:

powershell [Environment]::SetEnvironmentVariable("LYFTDATA_STAGING_DIR", "C:\\ProgramData\\LyftData\\server", "Machine") [Environment]::SetEnvironmentVariable("LYFTDATA_LICENSE_EULA_ACCEPT", "yes", "Machine") [Environment]::SetEnvironmentVariable("LYFTDATA_ADMIN_INIT_PASSWORD", "ChangeMeVerySoon", "Machine")

Tip

Set optional environment variables (for example LYFTDATA_BIND_ADDRESS, LYFTDATA_LOG_RETENTION_DAYS, or LYFTDATA_DB_DISK_USE_MAX_PERCENT) following the guidance in installation prerequisites.

Install the service with NSSM

NSSM provides a simple wrapper for running the server as a Windows service.

`powershell

Install the service

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

Start the service

Start-Service LyftDataServer `

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

Tip: save this block as install-lyftdata-server.ps1 and parameterise the password to reuse it across staging and production installs.

Verify the installation

`powershell

Check the Windows service

Get-Service LyftDataServer

Inspect the server log (optional)

Get-Content “C:\ProgramData\LyftData\server\server.log” -Tail 50 `

If LYFTDATA_ADMIN_INIT_PASSWORD was not supplied, the first run prints the generated admin password to the log. Change it immediately after logging into http://localhost:3000.

Next steps

• Open the UI at http://localhost:3000 and sign in as admin
• Review the worker installation guide to add external workers
• Follow the post-install checklist to enable metrics and create your first job