From 50648802ac6e94f2a5a2c6ef5b37f03e6282629d Mon Sep 17 00:00:00 2001 From: Ammar Bandukwala Date: Wed, 8 Oct 2025 11:05:50 -0500 Subject: [PATCH 1/3] =?UTF-8?q?=F0=9F=A4=96=20Update=20docs:=20macOS=20DMG?= =?UTF-8?q?s=20are=20now=20signed=20and=20notarized?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Simplified installation instructions now that proper code signing and notarization are in place. Users no longer need to bypass Gatekeeper security with right-click → Open or terminal workarounds. Changes: - Updated docs/install.md to remove security bypass instructions - Clarified separate x64 and arm64 artifact names - Updated README.md to note signed/notarized status - Removed all references to unsigned app warnings _Generated with `cmux`_ --- README.md | 2 +- docs/install.md | 31 +++++++++++-------------------- 2 files changed, 12 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 5b8536155..cce0b17ac 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ A cross-platform desktop application for embarassingly parallel development. Download pre-built binaries from [GitHub Actions artifacts](https://github.com/coder/cmux/actions/workflows/build.yml): -- **macOS**: Universal binary DMG (Intel + Apple Silicon) +- **macOS**: Signed and notarized DMG (separate builds for Intel/Apple Silicon) - **Linux**: AppImage ## Development diff --git a/docs/install.md b/docs/install.md index b191665ea..04a833840 100644 --- a/docs/install.md +++ b/docs/install.md @@ -6,7 +6,9 @@ Pre-built binaries are available from [GitHub Actions](https://github.com/coder/cmux/actions/workflows/build.yml): -- **macOS**: Universal binary DMG (Intel + Apple Silicon) +- **macOS**: Signed and notarized DMG + - `macos-dmg-x64` (Intel Macs) + - `macos-dmg-arm64` (Apple Silicon) - **Linux**: AppImage (portable, works on most distros) To download: @@ -14,31 +16,20 @@ To download: 1. Go to the [Build workflow](https://github.com/coder/cmux/actions/workflows/build.yml) 2. Click on the latest successful run 3. Scroll down to "Artifacts" section -4. Download `macos-dmg` or `linux-appimage` +4. Download the appropriate artifact for your platform ### Installation **macOS:** -⚠️ **Note**: The app is unsigned, so you'll need to bypass Gatekeeper security. +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 Cmux to Applications folder +4. Open the app normally -1. Download and open the DMG file -2. Drag Cmux to Applications folder -3. **First time opening**: - - Don't double-click the app (macOS will block it) - - Right-click (or Control+click) on Cmux.app - - Select "Open" from the menu - - Click "Open" in the security dialog - - The app will now be allowed to run - -**Alternative method if the above doesn't work:** - -1. After step 2, open Terminal -2. Run: `xattr -cr /Applications/Cmux.app` -3. Run: `codesign --force --deep --sign - /Applications/Cmux.app` -4. Now you can open the app normally - -These steps are only needed once. After that, you can open the app normally. +The app is code-signed and notarized by Apple, so it will open without security warnings. **Linux:** From 20c12a3f8437f77d604d202057a6839f57c39340 Mon Sep 17 00:00:00 2001 From: Ammar Bandukwala Date: Wed, 8 Oct 2025 11:53:38 -0500 Subject: [PATCH 2/3] Add note about non-main builds requiring Gatekeeper bypass --- docs/install.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/install.md b/docs/install.md index 04a833840..8e0d861c5 100644 --- a/docs/install.md +++ b/docs/install.md @@ -36,3 +36,14 @@ The app is code-signed and notarized by Apple, so it will open without security 1. Download the AppImage file 2. Make it executable: `chmod +x Cmux-*.AppImage` 3. Run it: `./Cmux-*.AppImage` + + +### Testing Pre-Release Builds + +⚠️ **Note**: 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/Cmux.app` +3. Run: `codesign --force --deep --sign - /Applications/Cmux.app` +4. Now you can open the app normally + From 9ba85849c7c49e3c2063bd4f1d0fe123e54e2a06 Mon Sep 17 00:00:00 2001 From: Ammar Bandukwala Date: Wed, 8 Oct 2025 11:59:36 -0500 Subject: [PATCH 3/3] Run prettier on docs/install.md --- docs/install.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/install.md b/docs/install.md index 8e0d861c5..1e77622c5 100644 --- a/docs/install.md +++ b/docs/install.md @@ -37,7 +37,6 @@ The app is code-signed and notarized by Apple, so it will open without security 2. Make it executable: `chmod +x Cmux-*.AppImage` 3. Run it: `./Cmux-*.AppImage` - ### Testing Pre-Release Builds ⚠️ **Note**: 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: @@ -46,4 +45,3 @@ The app is code-signed and notarized by Apple, so it will open without security 2. Run: `xattr -cr /Applications/Cmux.app` 3. Run: `codesign --force --deep --sign - /Applications/Cmux.app` 4. Now you can open the app normally -