> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skyfree.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Instance Config

> Set instance-wide fallback services and review worker capacity.

<Info>
  **Included with every self-managed instance.** This tab is part of [Whitelabel Setup](/self-host/whitelabel-setup/overview).
</Info>

## What is this?

The **Instance Config** tab holds instance-wide settings that aren't tied to a specific cron job — a fallback email sender, a currency-conversion API, message-credit billing units, and a read-only status panel written by background processes. Changes here apply without a restart.

<img src="https://mintcdn.com/mail2skyfreegmailcom/TMRlP9xN8aYGfnKu/images/whitelabel-setup-instance-config-overview.png?fit=max&auto=format&n=TMRlP9xN8aYGfnKu&q=85&s=0f771c949b3e12b3925e2b6f1368f498" alt="The Instance Config tab showing the four sections: Universal email fallback (SES), Currency conversion (FX rate API), Message credit billing, and Read-only instance status" width="1282" height="953" data-path="images/whitelabel-setup-instance-config-overview.png" />

## What can I do here?

**Universal email fallback (SES)** — used when a platform has no email settings configured, or its primary provider fails:

* **Region** (e.g. `ap-south-1`)
* **Access key ID**
* **Secret access key**
* **From email**
* **Reply-to email**

**Currency conversion (FX rate API)** — base URL and key used for cross-currency conversion:

* **API base URL** (e.g. `https://open.er-api.com/v6/latest`)
* **API key**

**Message credit billing** — credit units consumed per stored message and status update:

* **Units per stored message**
* **Units per status update**
* **Billable statuses (comma separated)** — which WhatsApp status-update events (e.g. `sent, delivered, read, failed`) count toward billing.
* **Estimated updates per message**

**Read-only instance status** — written by background processes, cannot be edited here:

* **Worker heartbeat** — status, role, PID, and last-seen time of the background health worker.
* **Platform capacity records** — total messages sent all-time, peak combined throughput, and when it was last sampled.

Each of the three editable sections (SES, FX rate API, message credit billing) has its own independent **Save section** button.

## How to use it

1. Scroll to the **Universal email fallback (SES)** card and fill in your AWS SES **Region**, **Access key ID**, **Secret access key**, **From email**, and **Reply-to email**. Click **Save section** on that card to save just this section.

   <img src="https://mintcdn.com/mail2skyfreegmailcom/OO2U_FWAO_6BJhiB/images/whitelabel-setup-instance-config-ses.png?fit=max&auto=format&n=OO2U_FWAO_6BJhiB&q=85&s=9e9793146bf797cddd6bdc17e2deddea" alt="The Universal email fallback (SES) card with its fields and Save section button" width="1282" height="953" data-path="images/whitelabel-setup-instance-config-ses.png" />

2. Scroll to the **Currency conversion (FX rate API)** card and enter the **API base URL** and **API key** for your exchange-rate provider. Click **Save section**.

3. Scroll to the **Message credit billing** card and set **Units per stored message**, **Units per status update**, **Billable statuses (comma separated)**, and **Estimated updates per message**. Click **Save section**.

   <img src="https://mintcdn.com/mail2skyfreegmailcom/OO2U_FWAO_6BJhiB/images/whitelabel-setup-instance-config-billing.png?fit=max&auto=format&n=OO2U_FWAO_6BJhiB&q=85&s=2863951edaa9b8e2146a5c31af8dfef2" alt="The Message credit billing card with its numeric fields and the billable statuses text field" width="1282" height="953" data-path="images/whitelabel-setup-instance-config-billing.png" />

4. Review the **Read-only instance status** card at the bottom to confirm the worker heartbeat is recent and check platform capacity numbers — these fields aren't editable and are for diagnostics only.

   <img src="https://mintcdn.com/mail2skyfreegmailcom/OO2U_FWAO_6BJhiB/images/whitelabel-setup-instance-config-status.png?fit=max&auto=format&n=OO2U_FWAO_6BJhiB&q=85&s=0aa721fc6afd4c62f255ae21e7fa1baa" alt="The read-only Worker heartbeat and Platform capacity records panels" width="1282" height="953" data-path="images/whitelabel-setup-instance-config-status.png" />
