diff --git a/docs/widgets/services/gitea.md b/docs/widgets/services/gitea.md index bf75aa69b..da695a9a2 100644 --- a/docs/widgets/services/gitea.md +++ b/docs/widgets/services/gitea.md @@ -5,7 +5,7 @@ description: Gitea Widget Configuration Learn more about [Gitea](https://gitea.com). -API token requires `notifications` and `repository` permissions. See the [gitea documentation](https://docs.gitea.com/development/api-usage#generating-and-listing-api-tokens) for details on generating tokens. +API token requires `notifications`, `repository` and `issue` permissions. See the [gitea documentation](https://docs.gitea.com/development/api-usage#generating-and-listing-api-tokens) for details on generating tokens. Allowed fields: ["notifications", "issues", "pulls"] diff --git a/docs/widgets/services/pfsense.md b/docs/widgets/services/pfsense.md index 1d9e84613..8f32a718d 100644 --- a/docs/widgets/services/pfsense.md +++ b/docs/widgets/services/pfsense.md @@ -9,9 +9,9 @@ This widget requires the installation of the [pfsense-api](https://github.com/ja Once pfSense API is installed, you can set the API to be read-only in System > API > Settings. -Currently the only supported authentication mode is 'Local Database'. +There are two currently supported authentication modes: 'Local Database' and 'API Token'. For 'Local Database', use `username` and `password` with the credentials of an admin user. For 'API Token', utilize the `headers` parameter with `client_token` and `client_id` obtained from pfSense as shown below. Do not use both headers and username / password. -WAN interface to monitor can be defined by updating the `wan` param. +The interface to monitor is defined by updating the `wan` parameter. It should be referenced as it is shown under Interfaces > Assignments in pfSense. Load is returned instead of cpu utilization. This is a limitation in the pfSense API due to the complexity of this calculation. This may become available in future versions. @@ -21,7 +21,10 @@ Allowed fields: `["load", "memory", "temp", "wanStatus", "wanIP", "disk"]` (maxi widget: type: pfsense url: http://pfsense.host.or.ip:port - username: user - password: pass + username: user # optional, or API token + password: pass # optional, or API token + headers: # optional, or username/password + Authorization: client_id client_token wan: igb0 + fields: ["load", "memory", "temp", "wanStatus"] # optional ``` diff --git a/src/utils/config/service-helpers.js b/src/utils/config/service-helpers.js index de129f577..c4ca2a65b 100644 --- a/src/utils/config/service-helpers.js +++ b/src/utils/config/service-helpers.js @@ -117,6 +117,8 @@ export async function servicesFromDocker() { return { server: serverName, services: discovered.filter((filteredService) => filteredService) }; } catch (e) { + logger.error("Error getting services from Docker server '%s': %s", serverName, e); + // a server failed, but others may succeed return { server: serverName, services: [] }; }