Relationships
#2894 Docs: serve-flags.md should state that relative grants-dir and grants-file resolve against the repository
Opened by hammz · 10/1/2026
What changed
swamp-club#2812 changes how swamp serve resolves a relative grants-dir or grants-file. They used to resolve against the process working directory; they now resolve against the repository directory, whichever source supplied them (the --grants-dir/--grants-file flags, SWAMP_GRANTS_DIR/SWAMP_GRANTS_FILE, or grants-dir:/grants-file: in .swamp/serve.yaml). An absolute path is unchanged.
Page to update
content/manual/reference/swamp-serve/serve-flags.md:
- the --grants-file and --grants-dir rows in the flags table
- the grants-file and grants-dir keys in the serve.yaml table
- the SWAMP_GRANTS_FILE and SWAMP_GRANTS_DIR rows in the environment table
Suggested content
Add to each: A relative path resolves against the repository directory, so the same configuration loads the same grants wherever swamp serve, or the daemon, is started from.
Closed
No activity in this phase yet.
stack72 commented 10/2/2026, 1:46:18 AM
Documented in https://github.com/swamp-club/swamp-club/pull/1281. In reference/swamp-serve/serve-flags.md, the --grants-file and --grants-dir flag rows, the grants-file and grants-dir serve.yaml keys, and the SWAMP_GRANTS_FILE and SWAMP_GRANTS_DIR environment rows all now say that a relative path resolves against the repository directory.
Sign in to post a ripple.