> ## Documentation Index > Fetch the complete documentation index at: https://mux.coder.com/llms.txt > Use this file to discover all available pages before exploring further. # Install > Download and install Mux for macOS, Linux, and Windows ## Downloads ### Release Builds Download pre-built binaries from the releases page. * **macOS**: Signed and notarized DMG (separate builds for Intel/Apple Silicon) * **Linux**: AppImage * **Windows** *(alpha)*: Installer exe ### Development Builds Download pre-built binaries of `main` from [GitHub Actions](https://github.com/coder/mux/actions/workflows/pr.yml?query=event:push+branch:main): * **macOS**: Signed and notarized DMG * `build-macos-x64` (Intel Macs) * `build-macos-arm64` (Apple Silicon) * **Linux**: `build-linux` AppImage (portable, works on most distros) * **Windows**: `build-windows` installer exe To download: 1. Go to the [PR workflow (main branch)](https://github.com/coder/mux/actions/workflows/pr.yml?query=event:push+branch:main) 2. Click on the latest successful run 3. Scroll down to "Artifacts" section 4. Download the appropriate artifact for your platform ### Installation #### macOS 1. Download the DMG file for your Mac: * Intel Mac: `macos-dmg-x64` * Apple Silicon: `macos-dmg-arm64` 2. Open the DMG file 3. Drag Mux to Applications folder 4. Open the app normally The app is code-signed and notarized by Apple, so it will open without security warnings. #### Linux 1. Download the AppImage file 2. Make it executable: `chmod +x Mux-*.AppImage` 3. Run it: `./Mux-*.AppImage` #### Windows *(alpha)* Prerequisites: * Install **Git for Windows** (includes Git Bash). **WSL is not supported.** * Restart Mux after installing Git for Windows. 1. Download the installer exe from [releases](https://github.com/coder/mux/releases) (e.g., `mux-x.x.x-x64.exe`) 2. Run the installer 3. Follow the installation prompts 4. Launch Mux from the Start menu or desktop shortcut Windows support is currently in alpha. Please [report any issues](https://github.com/coder/mux/issues) you encounter. ### Testing Pre-Release Builds Only builds from the `main` branch are signed and notarized. If you're testing a build from a pull request or other branch, you'll need to bypass macOS Gatekeeper: 1. After installing, open Terminal 2. Run: `xattr -cr /Applications/Mux.app` 3. Run: `codesign --force --deep --sign - /Applications/Mux.app` 4. Now you can open the app normally ## CLI via npm The Mux CLI can also be run directly via `npx` without installing the desktop app: ```bash theme={null} # Run agent tasks npx mux run "Fix the failing tests" # Start the server for remote/mobile access npx mux server --port 3000 ``` Or install globally: ```bash theme={null} npm install -g mux ``` This is ideal for CI/CD pipelines and scripted automation. See the [CLI documentation](/reference/cli) for all available commands and options.