---
title: Configuration
description: "Set TLS, the console URL, the mesh range and the secrets of the console in .env, and the update check, telemetry and the console clock."
sidebar:
  icon: settings
---

The console reads its settings from `.env` in the install directory.

- To change the TLS mode, `TSE_PUBLIC_URL` or `TSE_BACKUP_DIR`, run
  `./timescale-enterprise.sh` in the install directory and select **Change the listener**.
- To apply another change to `.env`, run `docker compose -f docker-compose.yml up -d` in the
  install directory.

## TLS modes

Set the mode with `TSE_TLS_MODE`:

| Mode | Ports on the host | Result |
| --- | --- | --- |
| `none` (default) | HTTP `8080` | Plain HTTP. Only for a trusted network. |
| `self-signed` | HTTPS `443`, `80` redirects to HTTPS | The console makes a certificate. Browsers show a warning. Enrollment commands use `curl -k`. |
| `provided` | HTTPS `443`, `80` redirects to HTTPS | Put the certificate and the key in `./certs`. Set `TSE_TLS_CERT_FILE` and `TSE_TLS_KEY_FILE` to their paths under `/certs`. |

All modes also publish the mesh ports: `8090` (enrollment), `41641/udp` (WireGuard) and
`3478/udp` (STUN). A [demo](/docs/v2026.11.5-beta/demo-mode) publishes only `8080`.

## Environment variable reference

| Variable | Default | Purpose |
| --- | --- | --- |
| `TSE_AUTH_TOKEN` | (required) | The [admin token](/docs/v2026.11.5-beta/users-and-roles#the-admin-token). A change ends all sessions. |
| `TSE_DB_ENCRYPTION_KEY` | (required) | 64 hex characters. Encrypts the secrets in the console database. If you lose it, the console cannot read its secrets. |
| `TSE_TLS_MODE` | `none` | See [TLS modes](#tls-modes). |
| `TSE_TLS_CERT_FILE` / `TSE_TLS_KEY_FILE` | (empty) | The certificate and the key in `provided` mode, for example `/certs/cert.pem`. |
| `TSE_PUBLIC_URL` | (empty) | The console URL that your servers reach, with the scheme. Required before you enroll servers. Use a DNS name. See [Change IP addresses](/docs/v2026.11.5-beta/operations/change-ip-addresses#the-console-gets-a-new-address). |
| `TSE_MESH_SUBNET` | `100.64.0.0/10` | The range of the mesh addresses, inside `100.64.0.0/10`. Set it before you enroll servers. After a change, you must enroll all servers again. |
| `TSE_BACKUP_DIR` | `<install dir>/backups` | The host directory of the local [console backups](/docs/v2026.11.5-beta/console-backups), an absolute path. |
| `TSE_PACK_DOWNLOAD_TOKEN` | (empty) | A pull token for `docker.io/timescale/enterprise-packs`. Empty: the console downloads server packages with no login. |
| `TSE_PACK_DOWNLOAD_USER` | (empty) | The login user of `TSE_PACK_DOWNLOAD_TOKEN`. Empty: `timescale`. |
| `RELEASE_TAG` | `latest` | The tag of the console image. The installer sets it. |

## Update check

The console reads `https://enterprise.tigerdata.com/install/latest.json` 1 minute after it starts, then once a day.
The request sends no data about your install.

- When a newer release is available, the footer shows `<release> is available`. Click it to
  see the upgrade command. See [Upgrade](/docs/v2026.11.5-beta/upgrade).
- To check now, click **Check for updates** in the footer.
- To turn the check off, open **Help (?) → About** and turn off **Check for new releases**.
  You must be an admin.

## Telemetry

The console sends a check-in to Tiger Data once a day: the install ID and version, counts
of services, servers, backups and operations, the sums of vCPUs, memory and disk, and the
uptime. It contains no names, addresses, credentials, license keys or data from your
database services.

Open **Administration → Telemetry** to see **Last sent** and **Next payload** (the exact
next check-in). To turn telemetry off, turn off **Send telemetry**. You must be an admin.

## Console clock

The servers, two-factor codes, certificates and restore times use the clock of the console
host (see [Time sync](/docs/v2026.11.5-beta/time-sync)). The console does not set the clock: keep time
sync (for example chrony) on in the console host.

Every 5 minutes, the console compares its clock with `pool.ntp.org` (`123/udp`), or else
with the clocks of the enrolled servers.

- When the offset is more than 30 seconds, the **Overview** tab of each service shows
  **Console clock is off.**
- The `ConsoleClockWrong` [alert](/docs/v2026.11.5-beta/alerts#console) fires after 10 minutes.
- **Administration → Time sync** shows the state of the console clock and of each server.

On a site with no internet access, the console usually cannot measure the offset, and shows
no warning. Sync the console host to an NTP server of your site.

## Data persistence

The console data and the metrics stay after a restart and an upgrade. An
[uninstall](/docs/v2026.11.5-beta/uninstall) deletes them, but keeps `TSE_BACKUP_DIR`.

After the loss of the console host, you need a console backup on an S3 target and its
recovery key to [restore the console](/docs/v2026.11.5-beta/operations/restore-the-console).
