Skip to content

docs: troubleshoot Flox building from source as flake input#445

Merged
devusb merged 1 commit intomainfrom
docs/flake-input-troubleshooting
Mar 17, 2026
Merged

docs: troubleshoot Flox building from source as flake input#445
devusb merged 1 commit intomainfrom
docs/flake-input-troubleshooting

Conversation

@devusb
Copy link
Copy Markdown
Contributor

@devusb devusb commented Mar 16, 2026

Summary

  • Adds troubleshooting section for users who install Flox as a Nix flake input and find it building from source instead of using the binary cache
  • Covers two common causes: using follows for nixpkgs (mismatched store paths) and the Flox binary cache missing from substituters
  • Based on a real user support interaction

Test plan

  • Verify the page renders correctly with mkdocs serve
  • Confirm code blocks and admonitions display properly

🤖 Generated with Claude Code

Covers two common causes: using `follows` for nixpkgs (which changes
store paths away from what's cached) and the Flox binary cache not
appearing in `substituters` (only in `trusted-substituters`).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 16, 2026
@devusb devusb requested review from garbas and jbayer March 16, 2026 21:17
@devusb devusb self-assigned this Mar 16, 2026
@github-actions
Copy link
Copy Markdown

Copy link
Copy Markdown
Contributor

@jbayer jbayer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

@devusb devusb merged commit b993835 into main Mar 17, 2026
4 checks passed
@devusb devusb deleted the docs/flake-input-troubleshooting branch March 17, 2026 11:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants