mirror of
https://github.com/oven-sh/bun
synced 2026-02-02 15:08:46 +00:00
62 lines
2.0 KiB
Plaintext
62 lines
2.0 KiB
Plaintext
---
|
|
title: Codesign a single-file JavaScript executable on macOS
|
|
description: Fix the "can't be opened because it is from an unidentified developer" Gatekeeper warning when running your JavaScript executable.
|
|
sidebarTitle: Codesign on macOS
|
|
mode: center
|
|
---
|
|
|
|
Compile your executable using the `--compile` flag.
|
|
|
|
```sh
|
|
bun build --compile ./path/to/entry.ts --outfile myapp
|
|
```
|
|
|
|
---
|
|
|
|
List your available signing identities. One of these will be your signing identity that you pass to the `codesign` command. This command requires macOS.
|
|
|
|
```sh terminal icon="terminal"
|
|
security find-identity -v -p codesigning
|
|
```
|
|
|
|
```txt
|
|
1. XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX "Developer ID Application: Your Name (ZZZZZZZZZZ)"
|
|
1 valid identities found
|
|
```
|
|
|
|
---
|
|
|
|
Optional, but recommended: create an `entitlements.plist` file with the necessary permissions for the JavaScript engine to work correctly.
|
|
|
|
```xml entitlements.plist icon="file-code"
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
|
<plist version="1.0">
|
|
<dict>
|
|
<key>com.apple.security.cs.allow-jit</key>
|
|
<true/>
|
|
<key>com.apple.security.cs.allow-unsigned-executable-memory</key>
|
|
<true/>
|
|
<key>com.apple.security.cs.disable-executable-page-protection</key>
|
|
<true/>
|
|
<key>com.apple.security.cs.allow-dyld-environment-variables</key>
|
|
<true/>
|
|
<key>com.apple.security.cs.disable-library-validation</key>
|
|
<true/>
|
|
</dict>
|
|
</plist>
|
|
```
|
|
|
|
---
|
|
|
|
Sign your executable using the `codesign` command and verify it works.
|
|
|
|
```bash terminal icon="terminal"
|
|
codesign --entitlements entitlements.plist -vvvv --deep --sign "XXXXXXXXXX" ./myapp --force
|
|
codesign -vvv --verify ./myapp
|
|
```
|
|
|
|
---
|
|
|
|
For more information on macOS codesigning, refer to [Apple's Code Signing documentation](https://developer.apple.com/documentation/security/code_signing_services). For details about creating single-file executables with Bun, see [Standalone Executables](/bundler/executables). This guide requires Bun v1.2.4 or newer.
|