Skip to content

Commit ec5b3b7

Browse files
committed
docs(self-hosting): point custom builds at package:mac, not package:share
package:share is the "send someone a build to try" path. It passes -c.mac.timestamp=none to skip the per-file round trip to Apple's timestamp authority, and its own docstring notes distribution builds need those timestamps. Apple's notary service requires a secure timestamp, so a build made that way cannot be notarized however many credentials the operator supplies — which is exactly what the section was telling them to do. package:mac inherits notarize and hardenedRuntime from electron-builder.yml and leaves timestamps on, and bun run build honours SIM_DESKTOP_DEFAULT_ORIGIN the same way, so the baked-origin instruction is unchanged. Its artifact path and name differ from the share script's per-channel overrides, so those are corrected too, and the two stacked warnings are merged into one.
1 parent a52b575 commit ec5b3b7

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

  • apps/docs/content/docs/en/platform/self-hosting

apps/docs/content/docs/en/platform/self-hosting/desktop.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -108,11 +108,13 @@ Packaging needs **macOS with Xcode 26 or newer** — the app icon is an Icon Com
108108

109109
```bash
110110
cd apps/desktop
111-
SIM_DESKTOP_DEFAULT_ORIGIN=https://sim.example.com bun run package:share
111+
SIM_DESKTOP_DEFAULT_ORIGIN=https://sim.example.com bun run package:mac
112112
```
113113

114-
This bakes your origin in as the default for fresh installs, so nobody has to set the server by hand (the picker stays available in the menu). Artifacts land in `apps/desktop/release/sim/`, named `sim-<version>-<arch>.dmg`.
114+
This bakes your origin in as the default for fresh installs, so nobody has to set the server by hand (the picker stays available in the menu). Artifacts land in `apps/desktop/release/`, named `Sim-<version>-<arch>.dmg`. Add `-c.appId=com.example.sim` if you want your own bundle identifier rather than Sim's.
115115

116116
<Callout type="warn">
117117
Signing and notarization become your responsibility with this route, and macOS quarantines anything downloaded that is not notarized. Supply your own Developer ID via `CSC_LINK` and `CSC_KEY_PASSWORD`, and App Store Connect notarization credentials via `APPLE_API_KEY`, `APPLE_API_KEY_ID`, `APPLE_API_ISSUER`, and `APPLE_TEAM_ID`.
118+
119+
Use `package:mac` for this, **not** `package:share`. The share script is the "send someone a build to try" path: it passes `-c.mac.timestamp=none` to skip the per-file round trip to Apple's timestamp authority. Apple's notary service requires a secure timestamp, so a build made that way cannot be notarized however many credentials you supply.
118120
</Callout>

0 commit comments

Comments
 (0)