Skip to content
Lyft Data Docs (Beta)

Server Installation

macOS server installation

This guide installs the Lyft Data server as a launch daemon on macOS. Commands require an administrator account.

Before you begin

Complete the installation prerequisites and extract the binary to /usr/local/bin/lyftdata. Confirm availability with lyftdata --version.

Prepare the server account

Need a trial-only setup? Start with the Evaluation Quickstart before promoting the pilot to a launch daemon.

Install the launch daemon

Create /Library/LaunchDaemons/com.lyftdata.server.plist:

Terminal window
sudo tee /Library/LaunchDaemons/com.lyftdata.server.plist >/dev/null <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.lyftdata.server</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/lyftdata</string>
    <string>run</string>
    <string>server</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>LYFTDATA_STAGING_DIR</key>
    <string>/var/lib/lyftdata-server</string>
    <key>LYFTDATA_LICENSE_EULA_ACCEPT</key>
    <string>yes</string>
    <key>LYFTDATA_ADMIN_INIT_PASSWORD</key>
    <string>ChangeMeVerySoon</string>
  </dict>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>StandardOutPath</key>
  <string>/var/lib/lyftdata-server/server.log</string>
  <key>StandardErrorPath</key>
  <string>/var/lib/lyftdata-server/server-error.log</string>
  <key>UserName</key>
  <string>lyftdata</string>
  <key>WorkingDirectory</key>
  <string>/var/lib/lyftdata-server</string>
</dict>
</plist>
EOF
sudo chmod 644 /Library/LaunchDaemons/com.lyftdata.server.plist

Optional settings

Add more entries to the <dict> in the plist when you need to expose the service or adjust retention defaults, for example:

<key>LYFTDATA_BIND_ADDRESS</key>
<string>0.0.0.0:3000</string>
<key>LYFTDATA_LOG_RETENTION_DAYS</key>
<string>30</string>
<key>LYFTDATA_DB_DISK_USE_MAX_PERCENT</key>
<string>80</string>

See the installation prerequisites for optional variables shared across platforms.

Load and start the daemon:

Terminal window
sudo launchctl load -w /Library/LaunchDaemons/com.lyftdata.server.plist

Verify the installation

Terminal window
# Check launchctl status
sudo launchctl list | grep com.lyftdata.server


# Tail the server log
sudo tail -n 50 /var/lib/lyftdata-server/server.log

If LYFTDATA_ADMIN_INIT_PASSWORD was omitted, the first startup prints the generated admin password to the log—change it immediately after logging in at http://localhost:3000.

Next steps