Skip to content

Document storage directory permissions - #28

Merged
jbrooksuk merged 1 commit into
3.xfrom
codex/document-storage-permissions
Aug 14, 2026
Merged

Document storage directory permissions#28
jbrooksuk merged 1 commit into
3.xfrom
codex/document-storage-permissions

Conversation

@jbrooksuk

Copy link
Copy Markdown
Member

Summary

  • document that the web-server user needs write access to Cachet鈥檚 storage directory
  • explain that Cachet uses the directory for logs, cached files, sessions, and other runtime data

Why

Without this requirement, a new installation can fail at runtime when Cachet needs to write application data.

Closes #13

Validation

  • git diff --check
  • Mintlify validation could not be run because the mintlify command is not installed locally.

@mintlify

mintlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cachet 馃煝 Ready View Preview Aug 13, 2026, 12:21 PM

馃挕 Tip: Enable Workflows to automatically generate PRs for you.

@jbrooksuk
jbrooksuk marked this pull request as ready for review August 14, 2026 06:01
@jbrooksuk
jbrooksuk merged commit 5859f15 into 3.x Aug 14, 2026
2 checks passed
@jbrooksuk
jbrooksuk deleted the codex/document-storage-permissions branch August 14, 2026 06:03

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

馃挕 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f4573ac266

鈩癸笍 About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 馃憤.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread v3.x/installation.mdx
Comment on lines +49 to +50
Ensure the user running your web server can write to Cachet's `storage` directory. Cachet uses this
directory for logs, cached files, sessions, and other runtime data.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Grant storage access to every Cachet process user

On deployments where nginx and PHP-FPM run under different accounts, granting access to the web-server user does not let the PHP process write Cachet's runtime data; the scheduler and dedicated queue worker documented below can likewise run as separate users. Specify that the PHP-FPM/application, scheduler, and queue-worker users must all have appropriate access to storage, otherwise these supported configurations can still fail with permission errors.

Useful? React with 馃憤聽/ 馃憥.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

v3.x give write permission to storage

1 participant