Skip to content

Cross-platform support: Windows and Linux #39

Description

@soulkyiro

Summary

Add Windows and Linux support to LiteLLM Relay to enable enterprise-wide deployments in organizations with heterogeneous device fleets.

Motivation

Currently Relay only supports macOS. Many corporate environments run mixed OS estates — particularly Windows for business users and Linux for engineering/server workstations. Without cross-platform support, IT teams cannot enforce a single AI governance layer across all employee devices, leaving significant gaps in shadow AI detection and AI tool auto-configuration.

Scope

Windows

  • Installer (MSI or EXE) deployable via Group Policy, SCCM, or Intune
  • Auto-configuration paths for AI tools on Windows (e.g., %APPDATA% paths for Claude Desktop, Codex)
  • Service-based background process (Windows Service) replacing LaunchAgent/LaunchDaemon
  • CA trust integration with the Windows Certificate Store
  • PAC file / system proxy configuration via registry or GPO
  • System tray app equivalent of the macOS menu bar app

Linux

  • Installer (.deb, .rpm, or universal shell script)
  • systemd unit files for periodic auto-configuration and proxy service
  • Auto-configuration for CLI tools (Claude Code, Codex) in ~/.config or $XDG_CONFIG_HOME
  • CA trust via update-ca-certificates / trust anchor
  • Environment-based proxy configuration (http_proxy, https_proxy)

Shared

  • Abstraction layer for OS-specific paths, service management, and CA trust
  • Cross-platform CI (GitHub Actions matrix: macOS, Windows, Linux)
  • MDM documentation for Windows-centric tools (Intune, SCCM) and Linux config management (Ansible, Chef, Puppet)

Enterprise context

Corporate IT teams typically need:

  • Centralized deployment via MDM/config management
  • Silent install with no user interaction
  • Per-machine or per-user configuration via policy
  • Unattended updates
  • Compatibility with corporate proxy chains and DLP tools

Acceptance criteria

  • relay binary compiles and runs on Windows (x86_64) and Linux (x86_64, aarch64)
  • AI tool auto-configuration works for at least Claude Code and Codex on all three platforms
  • Install scripts/packages support silent, unattended deployment
  • CA trust is established on each platform without manual steps
  • CI pipeline tests all three platforms
  • MDM/deployment documentation covers at least one tool per platform (Intune for Windows, Ansible for Linux)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions