Repository navigation
Conversation
Covers the Mac values for the install guide's .env, the removable-volume prompt for media on an external drive, and a transcode node on the same Mac for VideoToolbox: installing ffmpeg-full, adding the node and its key, copying the node program out of the server image, and installing, checking, updating, and removing it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…her backend Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Lead with the Mac values for .env, the mounts-denied error and the removable-volume prompt; add what the installer checks before it starts, how to keep the Mac awake, and how to see a conversion reach the node. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Silo Kody — review completeReview finished. Check the inline comments for findings and verify each suggestion against the code and tests. Reviewing changes in Silo
Review settingsReview OptionsThe following review options are enabled or disabled:
|
|
Important Draft PR not reviewedDraft PRs are not automatically reviewed by default.
To automatically review draft PRs, update your CodeRabbit configuration: reviews:
auto_review:
drafts: true
|
|
Draft until Silo-Server/silo-server#4950 and Silo-Server/silo-server#4940 are merged into main. The docs describe those changes, and their labels or defaults may still change in review. |
|
|
||
| ## Convert video with the Mac's hardware | ||
|
|
||
| This needs a Mac with Apple Silicon. Run a transcode node on the Mac itself, outside Docker, to convert video with VideoToolbox, the Mac's video hardware. Docker on a Mac runs Linux in a virtual machine that can't use VideoToolbox, so Silo in Docker converts video on the CPU. |
There was a problem hiding this comment.
Mac node instructions present unmerged functionality as available
Readers may expect the Mac node and installer to be available in current server images. Mark the instructions as dependent on the unmerged change in Silo-Server/silo-server#4950.
Also found in:
src/content/docs/docs/get-started/mac.md:76-76
Kody rule violation: Qualify playback documentation by implementation availability
Prompt for LLM
File src/content/docs/docs/get-started/mac.md, line 30:
Mac node instructions present unmerged functionality as available
Qualify the Mac node instructions as dependent on the unmerged server change. As written, the page presents the node and installer as available in current server images.
**Also found in:**
- `src/content/docs/docs/get-started/mac.md:76-76`
Kody rule violation: [Qualify playback documentation by implementation availability](https://kodus.siloserver.org/settings/code-review/1247779129/kody-rules/efe5218f-b87c-4b64-81da-675ed3c8c7e7?teamId=ba9922fc-c0ea-4cf8-87bb-9d4f42ffc73e)
Suggested code:
This needs a Mac with Apple Silicon. The Apple Silicon node and its installer are proposed in Silo-Server/silo-server#4950 and are not yet generally available. Once that change is available in your server version, run a transcode node on the Mac itself, outside Docker, to convert video with VideoToolbox, the Mac's video hardware. Docker on a Mac runs Linux in a virtual machine that can't use VideoToolbox, so Silo in Docker converts video on the CPU.
Talk to Kody by mentioning @kody
Was this suggestion helpful? React with 👍 or 👎 to help Kody learn from this interaction.
|
Preview deployed: https://pr-450.siloserver-org.pages.dev
Docs changes: 4 changes on 4 pages. Each link opens the first change on its page. Step through the rest with the changes box in the corner of the preview.
The alias updates after a successful build and deployment. The preview is removed when this pull request closes. |
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Silo Kody — review completeReview finished. Check the inline comments for findings and verify each suggestion against the code and tests. Reviewing changes in Silo
Review settingsReview OptionsThe following review options are enabled or disabled:
|
| ./silo node install --server http://localhost:8090 | ||
| ``` | ||
|
|
||
| `--server` is the address the Mac reaches Silo at: port `8090` from the install guide, or the `PORT` in your `.env`. When the installer asks for the node key, paste it and press Return; the key doesn't appear as you paste it. |
There was a problem hiding this comment.
Mac node instructions present unmerged playback changes as available
Users may expect the installer and VideoToolbox node-editor option to work with released server images. Note that they depend on the unmerged changes in Silo-Server/silo-server#4950 and Silo-Server/silo-server#4940, respectively.
Kody rule violation: Qualify playback documentation by implementation availability
Prompt for LLM
File src/content/docs/docs/get-started/mac.md, line 64:
Mac node instructions present unmerged playback changes as available
Qualify the Mac node instructions as dependent on the proposed server changes. The installer and VideoToolbox node-editor option are described as available, but their changes are still unmerged.
Kody rule violation: [Qualify playback documentation by implementation availability](https://kodus.siloserver.org/settings/code-review/1247779129/kody-rules/efe5218f-b87c-4b64-81da-675ed3c8c7e7?teamId=ba9922fc-c0ea-4cf8-87bb-9d4f42ffc73e)
Talk to Kody by mentioning @kody
Was this suggestion helpful? React with 👍 or 👎 to help Kody learn from this interaction.
Problem
Closes #449
The site had no Mac guide. On a Mac, the install guide's
/opt/silodata path fails in Docker Desktop withmounts denied, and Silo in Docker converts video on the CPU because Docker's Linux VM can't use VideoToolbox. This adds a Mac guide that covers both.It documents unmerged server changes, so it stays a draft until they merge:
silo node installandsilo node uninstall.Pages changed
What changed on each page
Run Silo Server on a Mac
slug: docs/mac.MEDIA_ROOT,SILO_DATA_ROOT,PUIDandPGID, themounts deniederror the guide's/opt/silogives, and the removable-volume prompt for media on an external drive.ffmpeg-full, add the node in Admin > Playback > Nodes with Source access set to Through the API servers, issue its key, copy the node out of the container withdocker compose cp, and run./silo node install --server http://localhost:8090. It covers the key prompt that hides what you paste, keeping the Mac awake, what the installer checks before it changes anything,--port, and the rollback when the node isn't ready within a minute.keywords: "Mac mini", "MacBook", "iMac", "M1", "M4", "Docker for Mac", "media engine", "LaunchAgent".questions: "Can I host my media server on a Mac mini?", "Why does Silo in Docker on my Mac convert on the CPU?", "How do I use my Mac's media engine for transcoding?", "What does mounts denied for /opt/silo mean?"Worth checking: the page tells Mac readers to keep
TZandSECRET_KEYfrom the install guide and changes only the other four.envlines.Install Silo Server
Transcode nodes
Left out on purpose
Evidence
Tested on a live server and device: an Apple M4 Mac mini with the server in Docker Desktop, following the page's steps with the node from silo-server#4950 and the editor from silo-server#4940. Source reviewed at silo-server#4940
58ae25fc0and silo-server#495016e5f217d.Needs a hands-on check: nothing beyond re-checking labels once the server pull requests merge.
Evidence: https://evidence.siloserver.org/r/siloserver-org/mac-videotoolbox-node/
Risks
None identified. Documentation only.
Checklist
AI Disclosure
🤖 Generated with Claude Code