docs(enterprise): document system-managed settings file paths#1140
Merged
Conversation
Documents the hardcoded system-managed settings.json deployment paths (macOS /Library/Application Support/Factory/, Linux/WSL /etc/factory/, Windows C:\\Program Files\\Factory\\) so IT/MDM administrators can ship base org policy before any user authenticates. Source PR (factory-mono): Factory-AI/factory-mono#13857 Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Droid finished @factory-davidgu's task —— View job Solid doc addition that explains system-managed settings paths and precedence, but a couple details need tightening: the failure-mode semantics (unreadable vs malformed) are easy to misinterpret, and the guidance should explicitly address file permissions/secret handling to avoid accidental key leakage. |
![factory-droid[bot]](https://avatars.githubusercontent.com/in/358017?s=60&v=4){kind=small}
stepan-factory
approved these changes
May 26, 2026
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.
Description
Documents the hardcoded system-managed
settings.jsondeployment paths shipped in Factory-AI/factory-mono#13857 (CLI-656). IT/MDM administrators can drop a settings file at a well-known platform path so org policy is enforced before any user authenticates — useful for managed laptops, airgapped fleets, and CI runners./Library/Application Support/Factory/settings.json/etc/factory/settings.jsonC:\Program Files\Factory\settings.jsonChanges
docs/enterprise/hierarchical-settings-and-org-control.mdxcovering paths, precedence, tier behaviour, and failure semantics.docs/enterprise/network-and-deployment.mdxunder "Configuration surfaces".Japanese mirrors under
jp/enterprise/*are intentionally not updated in this PR — translation typically batches separately.