Problem
New self-hosted setups still require an admin to manually update the Cloud Page database so each user gets a valid root_folder_path.
This is easy to miss and confusing for new users. Example: a user can log in to Vault Web, but Cloud Page does not work until an admin manually creates the storage folder and updates the DB path to /host-cloud/<username>.
Proposed solution
Document this setup step in a more visible place and consider a small setup helper or runbook flow.
Scope:
- explain why Cloud Page needs a per-user root path
- document host path vs container path clearly, e.g.
/data/vault-users/alice vs /host-cloud/alice
- provide a safe example command for updating the user record
- add a checklist for DB reachable, cloud root configured, JWT secret matching, and reverse proxy access
- optionally add a script later that creates the folder and updates the DB for a username
Acceptance criteria
Problem
New self-hosted setups still require an admin to manually update the Cloud Page database so each user gets a valid
root_folder_path.This is easy to miss and confusing for new users. Example: a user can log in to Vault Web, but Cloud Page does not work until an admin manually creates the storage folder and updates the DB path to
/host-cloud/<username>.Proposed solution
Document this setup step in a more visible place and consider a small setup helper or runbook flow.
Scope:
/data/vault-users/alicevs/host-cloud/aliceAcceptance criteria