Download instructions in installation docs point to invalid URL #3

Closed
opened 2025-12-30 01:19:12 +01:00 by adam · 6 comments
Owner

Originally created by @jasongwartz on GitHub (Feb 3, 2024).

The docs on installation currently suggest the following instructions to download the executable:

curl -o pkl https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-macos-0.25.1.bin
chmod +x pkl
./pkl --version

but the URL https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-macos-0.25.1.bin is invalid:

$ curl -I https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-macos-0.25.1.bin
HTTP/2 404
...

The current release page includes separate ARM vs Intel binaries, which link to eg: https://github.com/apple/pkl/releases/download/0.25.1/pkl-macos-amd64
which itself is a 302 redirect to a https://objects.githubusercontent.com/github-production-release-asset-2e65be/745600812/... URL containing the actual binary.

I was able to curl -L the https://github.com/apple/pkl/releases/download/0.25.1/pkl-macos-amd64 URL to get a working binary.

I'm guessing this requires a doc change in or around here: ce65290aae/docs/modules/pkl-cli/pages/index.adoc (L4) but possibly a bit of new content explaining which build to choose based on system architecture.

Happy to make a PR if it would help!

Originally created by @jasongwartz on GitHub (Feb 3, 2024). The [docs on installation](https://pkl-lang.org/main/current/pkl-cli/index.html#macos-executable) currently suggest the following instructions to download the executable: ``` curl -o pkl https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-macos-0.25.1.bin chmod +x pkl ./pkl --version ``` but the URL `https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-macos-0.25.1.bin` is invalid: ``` $ curl -I https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-macos-0.25.1.bin HTTP/2 404 ... ``` The [current release page](https://github.com/apple/pkl/releases/tag/0.25.1) includes separate ARM vs Intel binaries, which link to eg: `https://github.com/apple/pkl/releases/download/0.25.1/pkl-macos-amd64` which itself is a 302 redirect to a ` https://objects.githubusercontent.com/github-production-release-asset-2e65be/745600812/...` URL containing the actual binary. I was able to `curl -L` the `https://github.com/apple/pkl/releases/download/0.25.1/pkl-macos-amd64` URL to get a working binary. I'm guessing this requires a doc change in or around here: https://github.com/apple/pkl/blob/ce65290aae9c407603a26401d9ac03277bb5de7b/docs/modules/pkl-cli/pages/index.adoc?plain=1#L4 but possibly a bit of new content explaining which build to choose based on system architecture. Happy to make a PR if it would help!
adam closed this issue 2025-12-30 01:19:12 +01:00
Author
Owner

@bielikb commented on GitHub (Feb 3, 2024):

Thanks for this!

Is this binary notarized? I got an pop-up on macOS Sonoma 14.0.

@bielikb commented on GitHub (Feb 3, 2024): Thanks for this! Is this binary notarized? I got an pop-up on macOS Sonoma 14.0.
Author
Owner

@finestructure commented on GitHub (Feb 3, 2024):

Same here:

image

@finestructure commented on GitHub (Feb 3, 2024): Same here: ![image](https://github.com/apple/pkl/assets/65520/1d77f3d8-3009-45b4-b803-b7f3c93d0a9a)
Author
Owner

@jackkleeman commented on GitHub (Feb 3, 2024):

I generally struggle with these popups if I click to download a binary from Chrome, but it generally works fine with curl or if I run xattr -d com.apple.quarantine ./pcl

@jackkleeman commented on GitHub (Feb 3, 2024): I generally struggle with these popups if I click to download a binary from Chrome, but it generally works fine with curl or if I run `xattr -d com.apple.quarantine ./pcl`
Author
Owner

@petersid2022 commented on GitHub (Feb 3, 2024):

This is also the case for installing the Linux executable on amd64:

$ curl -I https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-linux-amd64-0.25.1.bin
HTTP/2 404
server: GitHub.com

I was able to get the executable by using:
$ curl -L -o pkl https://github.com/apple/pkl/releases/download/0.25.1/pkl-linux-amd64

@petersid2022 commented on GitHub (Feb 3, 2024): This is also the case for installing the Linux executable on amd64: ``` $ curl -I https://github.com/apple/pkl/releases/download/0.25.1/pkl-cli-linux-amd64-0.25.1.bin HTTP/2 404 server: GitHub.com ``` I was able to get the executable by using: `$ curl -L -o pkl https://github.com/apple/pkl/releases/download/0.25.1/pkl-linux-amd64`
Author
Owner

@holzensp commented on GitHub (Feb 8, 2024):

Fixed by #21

@holzensp commented on GitHub (Feb 8, 2024): Fixed by #21
Author
Owner

@jasongwartz commented on GitHub (Feb 8, 2024):

Thanks @holzensp !

@jasongwartz commented on GitHub (Feb 8, 2024): Thanks @holzensp !
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/pkl#3