Skip to content

Commit

Permalink
Add info about server var modes (#392)
Browse files Browse the repository at this point in the history
  • Loading branch information
rockycodes committed Feb 21, 2024
1 parent a6ce62a commit 49ba256
Showing 1 changed file with 8 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,11 @@ corresponding to the release is used to generate markdown documentation of the
variables. The generated markdown files are added to this directoy. Use the
left sidebar to see the available configuration variables for the CiviForm
version you are deploying.

Variables can have four different modes which determine where they are set and displayed:
1. "Admin writeable" variables should be set in the admin settings panel which is accessible in CiviForm when logged in as an admin. These variables should NOT be set in your deployment config and setting them there will have no affect on the app.
2. "Admin readable" variables should be set in your deployment config file. The values for these variables can be seen in the admin settings panel, but not changed there.
3. "Server setting" variables should be set in your deployment config file and are not visible in the admin settings panel.
4. "Managed secret" variables should be set in your cloud provider's secrets manager. These are not visible in the admin settings panel.

A variable's mode is listed in between the variable name and its description in the server environment variable documentation that is generated on each release and saved in this directory (for example [v1.51.0](https://docs.civiform.us/it-manual/sre-playbook/upgrading-to-a-new-release/server-environment-variables/v1.51.0)).

0 comments on commit 49ba256

Please sign in to comment.