Conversation
Covers the plain `installer -pkg` command, what the package changes on the machine, why 1.16.0 and earlier fail under an MDM agent (the postinstall inherits the agent's TCC identity and cannot create /etc/fstab) with both workarounds, the behaviour on machines that already have Nix, and how to verify a fleet install without trusting /etc/flox-version alone. Related: DEV-8, flox/flox-installers#529. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
djsauble
reviewed
Sep 17, 2026
Comment on lines
+13
to
+17
| Use the `x86_64-darwin` package on Intel Macs. The package refuses to install | ||
| on the wrong architecture, so a policy that ships both and lets the installer | ||
| decide is safe. Download links for the current release are on the | ||
| [Install](/install-flox/install#macos) page. | ||
|
|
Contributor
There was a problem hiding this comment.
Not sure we need to bother with this paragraph since we're deprecating x86_64-darwin soon anyway.
Suggested change
| Use the `x86_64-darwin` package on Intel Macs. The package refuses to install | |
| on the wrong architecture, so a policy that ships both and lets the installer | |
| decide is safe. Download links for the current release are on the | |
| [Install](/install-flox/install#macos) page. |
djsauble
reviewed
Sep 17, 2026
Comment on lines
+33
to
+35
| Flox 1.17.0 and later do not write `/etc/fstab`. The mount options for the | ||
| volume are set by the mount service instead. | ||
|
|
Contributor
There was a problem hiding this comment.
Flox 1.17.0 hasn't been released, so a bit odd to mention it here, but also I don't think this will be true (since we haven't yet prioritized the work to change the existing /etc/fstab behavior).
djsauble
requested changes
Sep 17, 2026
djsauble
left a comment
djsauble
left a comment
Contributor
There was a problem hiding this comment.
This seems more aspirational than anything, since it mentions 1.17.0 and changes to /etc/fstab behavior that we haven't committed to yet.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Related: DEV-8, flox/flox-installers#529.
Adds Install Flox → Unattended and MDM installs, a page for people deploying the macOS
.pkgfrom an MDM or a script rather than by double-clicking it. The docs had nothing on MDM, headless or unattended installs.What the page covers
installer -pkg ... -target /command and the architecture note.Nix Storevolume, the two LaunchDaemons, build users,/etc/nix,/usr/local/binlinks, the/etc/zshrcpatches)./etc/fstab, sovifsfails after the volume is already created. Includes the cleanup command and the two workarounds (the MDM's native install command, or a PPPC profile grantingSystemPolicySysAdminFilesto the agent binary)./etc/flox-versionalone.docs.jsongets the nav entry after Install, andllms.txtis regenerated.Checks
mint broken-links: no broken links in the new page (the three reported are the pre-existing/changelog/rss.xmllinks).Before merging
/etc/fstab. That assumes flox/flox-installers#529 ships in the next release; adjust the version if it lands later.🤖 Generated with Claude Code