Rudder 可以在 macOS、Windows 和 Linux 上本地运行。安装命令会下载适合你电脑 的桌面应用，并安装 rudder 命令，方便以后再次启动。

​
代码签名政策

Rudder 正在为 Windows Desktop 发布产物申请代码签名基金会项目资格。 申请获批且发布流程完成配置前，现有发布产物不会被描述为已经由该服务签名。 免费代码签名由签名服务提供，证书由 签名基金会提供。详情见 代码签名政策和 隐私政策。 开始前需要：
  • Node.js 20 或更高版本，它会提供 npx 命令
  • 一个终端和首次下载所需的网络
  • 为当前用户安装应用的权限

​
1. 运行安装命令

第一次下载可能需要几分钟。完成后，Rudder Desktop 会自动打开。

​
2. 确认 Rudder 已经打开

当桌面窗口让你创建或选择组织时，安装就完成了。Rudder 把团队工作空间称为 “组织”。你不需要另装 PostgreSQL，也不需要手动启动服务端。 以后直接运行：
接下来，连接一个 Agent 运行工具，并交给它一件小任务。

完成第一个任务

创建组织，连接 Agent，并拿到一个真实结果。

​
Rudder 没有打开怎么办

先在当前窗口选择重试。Rudder 只会重新启动一次，不会因为重复点击而打开 多个本地服务。 如果仍然失败：
  1. 打开技术详情，阅读错误说明。
  2. 选择复制诊断信息，复制经过筛选的诊断摘要。
  3. 选择在 GitHub 报告或联系支持。Rudder 只会打开草稿，不会自动发送， 也不会上传你的本地文件。
分享前请检查复制的内容。不要附上凭据、数据库、.env 文件或私人工作空间内容。 如果终端提示 npx: command not found，请安装 Node.js 20 或更高版本，重新打开 终端，再运行安装命令。 如果 Agent 仍在工作时出现更新，选择空闲时更新，让本次运行先完成。只有在 确认可以取消当前任务时，才选择停止运行并立即更新。

​
卸载 Rudder

先退出 Rudder Desktop，并确认没有 Agent 运行正在执行。
  1. 删除默认位置中的便携版桌面应用：
    • macOS：将 ~/Applications/Rudder.app 移到废纸篓。
    • Windows：删除 %LOCALAPPDATA%\\Programs\\Rudder。
    • Linux：删除 ~/.local/share/rudder/Rudder.AppImage。
  2. 运行 npm uninstall --global @rudderhq/cli 删除持久化 CLI。
Rudder 默认将本地工作空间和运行时数据保存在 ~/.rudder。删除桌面应用或 CLI 不会删除这些数据。先备份需要保留的内容；只有在确实要清除全部本地 Rudder 状态 时，才单独删除该目录。