{"record":{"id":"aa272dec8bec8f7f","repo":"oraios/serena","slug":"unsupported-operating-system-system-aa272d","errorCode":null,"errorMessage":"Unsupported operating system: {system}","messagePattern":"Unsupported operating system: (.+?)","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"src/solidlsp/language_servers/luau_lsp.py","lineNumber":240,"sourceCode":"        def _get_luau_lsp_asset_name() -> str:\n            system = platform.system()\n            machine = platform.machine().lower()\n\n            if system == \"Linux\":\n                if machine in [\"x86_64\", \"amd64\"]:\n                    return \"luau-lsp-linux-x86_64.zip\"\n                if machine in [\"aarch64\", \"arm64\"]:\n                    return \"luau-lsp-linux-arm64.zip\"\n                raise RuntimeError(\n                    f\"Unsupported Linux architecture: {machine}. \"\n                    \"luau-lsp only provides linux-x86_64 and linux-arm64 binaries. \"\n                    \"Please build from source: https://github.com/JohnnyMorganz/luau-lsp\"\n                )\n            if system == \"Darwin\":\n                return \"luau-lsp-macos.zip\"\n            if system == \"Windows\":\n                return \"luau-lsp-win64.zip\"\n            raise RuntimeError(f\"Unsupported operating system: {system}\")\n\n    @staticmethod\n    def _get_platform_type(custom_settings: SolidLSPSettings.CustomLSSettings) -> str:\n        platform_type = custom_settings.get(\"platform\", \"roblox\")\n        if platform_type not in SUPPORTED_PLATFORMS:\n            raise ValueError(f\"Unsupported Luau platform: {platform_type}. Expected one of: {', '.join(sorted(SUPPORTED_PLATFORMS))}\")\n        return platform_type\n\n    @staticmethod\n    def _get_roblox_security_level(custom_settings: SolidLSPSettings.CustomLSSettings) -> str:\n        security_level = custom_settings.get(\"roblox_security_level\", \"PluginSecurity\")\n        if security_level not in SUPPORTED_ROBLOX_SECURITY_LEVELS:\n            raise ValueError(\n                f\"Unsupported Luau Roblox security level: {security_level}. \"\n                f\"Expected one of: {', '.join(sorted(SUPPORTED_ROBLOX_SECURITY_LEVELS))}\"\n            )\n        return security_level\n","sourceCodeStart":222,"sourceCodeEnd":258,"githubUrl":"https://github.com/oraios/serena/blob/7fcbca7e62555ec2287ddb2f083caee805848ea6/src/solidlsp/language_servers/luau_lsp.py#L222-L258","documentation":"Raised when selecting the luau-lsp release asset on an OS that is not Linux, Darwin, or Windows; luau-lsp upstream has no prebuilt binaries for other systems. The library throws RuntimeError instead of downloading a wrong asset.","triggerScenarios":"_get_luau_lsp_asset_name (called from _download_luau_lsp) executing where platform.system() returns 'FreeBSD', 'OpenBSD', 'NetBSD', 'SunOS', 'AIX', or similar.","commonSituations":"FreeBSD/OpenBSD servers and CI, Solaris/illumos hosts, AIX mainframe environments, custom embedded OS builds.","solutions":["Run the workload in a Linux container (Docker/podman) on the unsupported host","Build luau-lsp from source for the target OS and pre-place the binary so the download path is not taken","Use a supported OS CI runner (ubuntu/macos/windows) for anything using this library","If a community build exists, patch _get_luau_lsp_asset_name to add the OS/asset mapping"],"exampleFix":"// before\n# multilspy on FreeBSD host directly\n// after\npodman run --rm -v $(pwd):/work -w /work python:3.11  # linux environment","handlingStrategy":"validation","validationCode":"import platform\nif platform.system() not in (\"Linux\", \"Darwin\", \"Windows\"):\n    raise SystemExit(f\"luau-lsp has prebuilt binaries only for Linux/macOS/Windows; got {platform.system()}. Run in a Linux container.\")","typeGuard":null,"tryCatchPattern":"try:\n    server = create_luau_server()\nexcept RuntimeError as e:\n    if \"Unsupported operating system\" in str(e):\n        run_in_linux_container()\n    else:\n        raise","preventionTips":["Run on Linux/macOS/Windows hosts or containers","Skip luau tests on unsupported OSes in CI matrices","Pre-provision a source-built binary on exotic platforms","Document OS requirements in project setup docs"],"tags":["luau","operating-system","unsupported-platform","installation"],"backgroundTag":"unsupported-platform","analyzedSha":"7fcbca7e62555ec2287ddb2f083caee805848ea6","analyzedAt":"2026-08-29T00:04:09.619Z","schemaVersion":2},"datasetVersion":"2026-08-29T02:17:18.158Z"}