Using files for secrets
Author: r3miCreated Apr 10, 2026Updated Aug 30, 2026
Describe the feature request
Hello, would it be possible to provide the value of secrets through files, in addition to the current environnement variables ?
For example, when using an env variable in config files:
headers:
Authorization: "Bearer ${MY_API_TOKEN}"gatus could look
- first at the content of the file whose pathname is in env var
$MY_API_TOKEN_FILEif defined (e.g.MY_API_TOKEN_FILE=/run/secrets/my_api_token) (The naming conventionxx_FILEis commonly used in other projects, or could bexx__FILEorFILE__xxinstead) - else at the content of env var
$MY_API_TOKENdirectly, as it is done today.
Such a feature would be compatible with docker secrets, and also would require no change to config files already using env variables.
thanks you very much for gatus!
Why do you personally want this feature to be implemented?
it would be possible to benefit from Docker secrets (and similar mechanisms).
How long have you been using this project?
2 years
Additional information
I have looked at issues #1448 and #1399 , with similar concerns, but different proposals.
Source: TwiN/gatus