Skip to content
You're viewing documentation for v2026.11.8-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview
On this page

Configuration

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.

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 publishes only 8080.

Environment variable reference

Variable Default Purpose
TSE_AUTH_TOKEN (required) 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.
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.
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, 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.
  • 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. A check-in also follows changes such as a deploy, a license or trial change, and an upgrade. The check-in contains only product metadata about the console, its servers and its database services: counts, versions, kinds, states and on/off settings. For example:

  • The versions of the console, PostgreSQL, the extensions and the console components.
  • The topology, the health and the size of the services and the servers, as counts and totals.
  • The results of backups and operations, as counts.
  • The settings that are on or off, for example TLS and single sign-on.

The check-in also contains a random install ID that the console makes. The check-in never contains names, addresses, credentials, license keys or data from your database services. A value that is not in a fixed list of known values is sent as other.

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