Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions .github/workflows/desktop.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
27 changes: 16 additions & 11 deletions docs/downloads.md
Original file line number Diff line number Diff line change
Expand Up @@ -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_<version>_universal.dmg` | Apple Silicon + Intel |
| Windows (64-bit) | `Locus_<version>_x64-setup.exe` or `.msi` | Windows 10+ |
| Windows (ARM64) | `Locus_<version>_arm64-setup.exe` | Windows 11 on ARM |
| Linux (DEB) | `Locus_<version>_amd64.deb` | Ubuntu, Debian |
| Linux (RPM) | `Locus-<version>-1.x86_64.rpm` | Fedora, RHEL |
| Linux (AppImage) | `Locus_<version>_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
Expand Down
32 changes: 20 additions & 12 deletions docs/getting-started/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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_<version>_universal.dmg` |
| Windows (64-bit) | `Locus_<version>_x64-setup.exe` or `Locus_<version>_x64_en-US.msi` |
| Windows (ARM64) | `Locus_<version>_arm64-setup.exe` |
| Linux (DEB) | `Locus_<version>_amd64.deb` |
| Linux (RPM) | `Locus-<version>-1.x86_64.rpm` |
| Linux (AppImage) | `Locus_<version>_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.
Expand Down
4 changes: 2 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Loading