---
url: https://panomc.com/docs/platform/configuration/services.md
---
# Services Configuration

## Database Configuration

```jsonc
database {
  type = "mariadb" # "mariadb" (for both MySQL/MariaDB) or "portable"
  host = ""        # e.g., "127.0.0.1:3306"
  name = ""        # database name
  username = ""
  password = ""    # can be empty if your database has no password
  prefix = "pano_" # table prefix (do not change after installation)
}
```

**Notes**

* **Database Types:**
  * `mariadb`: Default type, compatible with both **MySQL 5.5+** and **MariaDB**.
  * `portable`: Only supported on **Windows (x64 and ARM64)**. Automatically managed by Pano (see [Setup Wizard →](../../installation/setup/) for details).
* Password can be blank if authentication is disabled.
* **Warning:** Changing `type` or `prefix` after installation is not supported and will require a **reinstallation**.

## Pano Account (Optional)

```jsonc
pano-account {
  username = ""
  email = ""
  access-token = ""   # secure token for your Pano account
  platform-id = ""    # account ID
  
  connect {
    public-key = ""
    private-key = ""
    state = ""
  }
}
```

**Important**

* If unsure what this does, **do not edit manually**.
* Manage linking in **Panel → Settings → Platform**.
* Required for **Marketplace features** (updates, store installs).

## Email (SMTP)

```jsonc
email {
  enabled = false
  provider = "SMTP" # "SMTP" (the settings below) or "PANO_MAIL"
  sender = ""      # e.g., "Pano <no-reply@domain.com>" - mostly must be same with username
  hostname = ""    # e.g., "smtp.gmail.com"
  port = 465
  username = ""    # e.g., "no-reply@domain.com"
  password = ""
  ssl = true
  starttls = ""    # "DISABLED" or "OPTIONAL" or "REQUIRED"
  authMethods = "" # optional, mostly "PLAIN"
  host-managed = true # Pano Host only
  host-sender = null  # Pano Host only
  custom = null       # Pano Host only
}
```

**Info**

* Optional during setup; configurable later via **Panel → Settings → Platform**.
* Without SMTP, password recovery and verification emails will not work.
* The wording and look of every mail are edited in **Panel → Settings → Mail templates**; see [Mail Templates](../mail-templates/).
* `provider`: how mail is sent. `SMTP` uses the settings in this block. `PANO_MAIL` sends through the [Pano Mail](#pano-mail) of the Pano account this installation is connected to, and the SMTP settings are not used. Default **SMTP**. Switch it in **Panel → Settings → Platform** instead of editing the file.
* `host-managed`, `host-sender` and `custom` only matter on a **Pano Host** instance; leave them alone elsewhere.
  * `host-managed`: `true` means this block follows the instance's Pano Host mail and is rewritten on every boot. Saving other mail settings in **Panel → Settings** sets it to `false`, so they stay. Default **true**.
  * `host-sender`: the sender used with Pano Host mail instead of the instance's default, kept across boots. Empty (`null`) means the default.
  * `custom`: a copy of your own SMTP settings (`sender`, `hostname`, `port`, `username`, `password`, `ssl`, `starttls`, `authMethods`), kept while Pano Host mail is in use so switching back to them loses nothing. Filled in automatically.

### Pano Mail {#pano-mail}

**Pano Mail** is e-mail sending that comes with your Pano account, so you do not need a mail server of
your own. Pick **Pano Mail** instead of **Own mail server** in the e-mail step of the setup wizard, or later in
**Panel → Settings → Platform**. The installation must be connected to your Pano account.

* **Free plan.** Free for every account, with a monthly and a daily allowance (the panel shows both), and it works
  right away with no set-up. Bigger plans can be chosen on the Pano website.
* **Sender address.** Every account gets one free address on a subdomain we give you. It can be renamed but not
  removed. You can also add your own domain on the Pano website, which asks you to add a few DNS records. The part
  before the `@` can be changed in the panel.
* **Usage.** The panel shows what was used today and this month, and when the allowance resets. You are warned when you get
  close to a limit, and e-mail pauses until it resets or you choose a bigger plan.
* **On the Pano website.** The **E-mail** tab of your account shows the plan, the usage of all your Panos and a log of the
  e-mails sent in the last 30 days.