---
title: "Manage Grafana Users"
description: "Learn how to configure Grafana SMTP via exo CLI to send user invites and notifications or manually create users in the admin portal without email."
url: https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/user-mgmt/
product: "Grafana"
section: product
last_updated: 2026-06-03
---
> For AI agents: the documentation index is at https://community.exoscale.com/llms.txt. Every page is available as markdown at `<page URL>index.md` or with `Accept: text/markdown`.

# 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.
