# Manage Grafana 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:

```bash 
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.