diff --git a/.github/workflows/desktop.yml b/.github/workflows/desktop.yml index c2da960..ce203dc 100644 --- a/.github/workflows/desktop.yml +++ b/.github/workflows/desktop.yml @@ -525,9 +525,12 @@ jobs: echo "APPLE_TEAM_ID=$A_TEAM" >> "$GITHUB_ENV" echo "Apple signing configured" else + # Without an Apple Developer ID the app is ad-hoc signed + # (tauri.conf.json signingIdentity "-") and not notarized, so + # Gatekeeper asks users to approve it on first launch. Updater + # artifacts are still signed with the Tauri key. if [[ "${{ github.ref }}" == refs/tags/* ]]; then - echo "::error::Apple signing secrets are required for release builds" - exit 1 + echo "::warning::No Apple signing secrets; releasing an unsigned, un-notarized macOS build" fi echo "No Apple certificate configured, skipping code signing" fi diff --git a/docs/downloads.md b/docs/downloads.md index 6b3d8b7..c087948 100644 --- a/docs/downloads.md +++ b/docs/downloads.md @@ -23,22 +23,27 @@ processing happens on your local machine — the app connects to the backend you ### Download -| Platform | Download | Notes | -|----------|----------|-------| -| macOS (Universal) | [:material-download: **Locus.dmg**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_universal.dmg) | Apple Silicon + Intel | -| Windows (64-bit) | [:material-download: **Locus-setup.exe**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_x64-setup.exe) | Windows 10+ | -| Linux (DEB) | [:material-download: **Locus.deb**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_amd64.deb) | Ubuntu, Debian | -| Linux (RPM) | [:material-download: **Locus.rpm**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/Locus-1.0.1-1.x86_64.rpm) | Fedora, RHEL | -| Linux (AppImage) | [:material-download: **Locus.AppImage**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_amd64.AppImage) | Any distro | +Download from the [:material-download: **latest release**](https://github.com/aryanjsx/Locus/releases/latest): + +| Platform | File | Notes | +|----------|------|-------| +| macOS (Universal) | `Locus__universal.dmg` | Apple Silicon + Intel | +| Windows (64-bit) | `Locus__x64-setup.exe` or `.msi` | Windows 10+ | +| Windows (ARM64) | `Locus__arm64-setup.exe` | Windows 11 on ARM | +| Linux (DEB) | `Locus__amd64.deb` | Ubuntu, Debian | +| Linux (RPM) | `Locus--1.x86_64.rpm` | Fedora, RHEL | +| Linux (AppImage) | `Locus__amd64.AppImage` | Any distro | !!! tip "All releases" Browse all versions on the [GitHub Releases](https://github.com/aryanjsx/Locus/releases) page. -### macOS: "app is damaged" fix +### macOS: first launch -macOS Gatekeeper quarantines apps downloaded from the internet that aren't notarized -by Apple. If you see **"Locus is damaged and can't be opened"**, run this in -Terminal to clear the quarantine flag: +The macOS app isn't signed with an Apple Developer ID or notarized yet, so +Gatekeeper blocks the first launch. Right-click **Locus.app** and choose +**Open**, or allow it in **System Settings → Privacy & Security**. If you see +**"Locus is damaged and can't be opened"**, run this in Terminal to clear the +quarantine flag: ```bash xattr -cr /Applications/Locus.app diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index b4e4312..feeeaba 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -90,24 +90,32 @@ cd Locus ./scripts/quickstart.sh ``` -**Step 2.** Download and open the desktop app: - -| Platform | Download | -|----------|----------| -| macOS (Universal) | [:material-download: **Locus.dmg**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_universal.dmg) | -| Windows (64-bit) | [:material-download: **Locus-setup.exe**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_x64-setup.exe) | -| Linux (DEB) | [:material-download: **Locus.deb**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_amd64.deb) | -| Linux (RPM) | [:material-download: **Locus.rpm**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/Locus-1.0.1-1.x86_64.rpm) | -| Linux (AppImage) | [:material-download: **Locus.AppImage**](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_amd64.AppImage) | +**Step 2.** Download and open the desktop app from the +[:material-download: **latest release**](https://github.com/aryanjsx/Locus/releases/latest): + +| Platform | File | +|----------|------| +| macOS (Universal) | `Locus__universal.dmg` | +| Windows (64-bit) | `Locus__x64-setup.exe` or `Locus__x64_en-US.msi` | +| Windows (ARM64) | `Locus__arm64-setup.exe` | +| Linux (DEB) | `Locus__amd64.deb` | +| Linux (RPM) | `Locus--1.x86_64.rpm` | +| Linux (AppImage) | `Locus__amd64.AppImage` | The app connects to `http://localhost:8000` automatically. -!!! warning "macOS: \"app is damaged\"" - If macOS says the app is damaged, clear the Gatekeeper quarantine flag: +!!! warning "macOS: the app isn't signed by Apple yet" + The macOS app isn't signed with an Apple Developer ID or notarized, so the + first launch is blocked. Right-click **Locus.app** and choose **Open**, or + allow it in **System Settings → Privacy & Security**. If macOS says the + app is damaged, clear the Gatekeeper quarantine flag: ```bash xattr -cr /Applications/Locus.app ``` - This is normal for open-source apps distributed outside the App Store. + +!!! warning "Windows: SmartScreen warning" + The Windows installer isn't code-signed yet. If SmartScreen blocks it, + choose **More info → Run anyway**. !!! tip "All releases" Browse all versions on the [GitHub Releases](https://github.com/aryanjsx/Locus/releases) page. diff --git a/docs/index.md b/docs/index.md index 150b679..bdc7f39 100644 --- a/docs/index.md +++ b/docs/index.md @@ -66,9 +66,9 @@ Locus is that stack. It is a framework for local-first personal AI, built around **Step 2.** Download and open the desktop app: - [Download for macOS](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_universal.dmg){ .md-button .md-button--primary } + [Download the desktop app](https://github.com/aryanjsx/Locus/releases/latest){ .md-button .md-button--primary } - Also available for [Windows](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_x64-setup.exe), [Linux (DEB)](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/LOCUS_1.0.1_amd64.deb), and [Linux (RPM)](https://github.com/aryanjsx/Locus/releases/download/desktop-v1.0.2/Locus-1.0.1-1.x86_64.rpm). See the [Downloads](downloads.md) page for details. + Available for macOS, Windows and Linux. See the [Downloads](downloads.md) page for which file to pick. The app connects to `http://localhost:8000` automatically.