---
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.11-beta/demo-mode) publishes only `8443`, with self-signed HTTPS.

## Environment variable reference

| Variable | Default | Purpose |
| --- | --- | --- |
| `TSE_AUTH_TOKEN` | (required) | The [admin token](/docs/v2026.11.11-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.11-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.11-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.11-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 usage and diagnostic data to Tiger Data, to improve and support the product.
An admin sets this in **Administration → Telemetry**.

## Console clock

The servers, two-factor codes, certificates and restore times use the clock of the console
host (see [Time sync](/docs/v2026.11.11-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.11-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.11-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.11-beta/operations/restore-the-console).
