Managing Users

SMTP configuration is not available by default at startup, so directly sending a user invitation from the Grafana UI will not work under the organization and user management screen.

Two options are possible:

  1. Set SMTP configuration details to be able to send user invites and other notifications via email
  2. Manually create users

Configure SMTP and Send User Invites

To activate SMTP email sending, use the exo CLI with the following parameters:

$ exo dbaas update --zone de-fra-1 grafana-smtp --grafana-settings '{"smtp_server":{"host":"a_valid_smtp_host","port":587,"username":"myusername","password":"mypassword","from_address":"dashboard@your.domain"}}'

The full list of parameters is as follow:

Required

  • from_address: (String) Address used for sending emails.
  • host: (String) Server hostname or IP.
  • port: (Number) SMTP server port.

Optional

  • from_name: (String) Name used in outgoing emails, defaults to Grafana.
  • password: (String, Sensitive) Password for SMTP authentication.
  • skip_verify: (Boolean) Skip verifying server certificate. Defaults to false.
  • starttls_policy: (String) Either OpportunisticStartTLS, MandatoryStartTLS or NoStartTLS. Default is OpportunisticStartTLS.
  • username: (String) Username for SMTP authentication.

Then proceed to the admin/users/ section of the Grafana portal and follow the instructions.

NOTE
The SMTP settings can also be set at service creation using the CLI with the same --grafana-settings option flag.

Manual User Creation

If no SMTP configuration is set then proceed as described:

  • Navigate to the admin/users/ section of the Grafana portal
  • Add the user. Deactivate the sent email option.
  • No email will be sent. You can retrieve the invitation link by click on the pending invites button.
  • Specifically add the user to the organization you would prefer. By default a new organization will be created for each new user, whereas you might want to have them under the same default organization.