---
title: Demo mode
description: "Try the console on one computer, with demo servers as Docker containers: start, stop and reset a demo, connect, and convert it to production."
sidebar:
  icon: flask-conical
search:
  keywords: ["demo", "try", "evaluate", "trial", "laptop", "local", "docker desktop", "orbstack"]
seo:
  title: "Try the console in demo mode"
---

A demo runs the console and its database servers as Docker containers on one computer.

:::warning
Demo servers are for testing only.
:::

## Requirements

- Linux or macOS, with Docker and the Docker Compose v2 plugin. On a Mac, start
  [OrbStack](https://docs.orbstack.dev/quick-start) or Docker Desktop first.
- At least 4 CPUs and 8 GB of Docker memory. See [Demo memory](#demo-memory).
- Internet access from Docker containers for the first start.
- Free port `8080`, and no other Docker network on `172.29.0.0/24`.

## Start a demo

Run:

```bash
curl -fsSL https://enterprise.tigerdata.com/install/timescale-enterprise.sh | sh -s -- --demo
```

Or run the installer without options and select **Try a demo on this computer (not for
production)** (the default on a Mac). Type `y` to accept the warning. The first start takes
about a minute more.

![The Demo ready box with the console URL, the login token and the manage command](/docs/screenshots/v2026.11.5-beta/demo-mode/demo-ready.light.webp)

Open `http://localhost:8080` and log in with the token. To see the token again, run the
**Manage** command. The demo files are in `~/tse`.

Licensing applies as in production: start a [trial](/docs/v2026.11.5-beta/licensing) or add a license.

## Add demo servers

A demo server takes the place of a real server. The console starts it for you as a container
and enrolls it, as a real server enrolls with the [enroll command](/docs/v2026.11.5-beta/servers#enroll-a-server).
You do not run a command.

1. **Open Register new server**

    Open **Infrastructure → Servers**, and select **Register new server**.

2. **Name the server**

    Optional: enter a name.

3. **Add the server**

    Select **Add server**.

![The Add a server panel of a demo console, with Start a demo server and the capacity line](/docs/screenshots/v2026.11.5-beta/demo-mode/add-demo-server.light.webp)

A demo console accepts demo servers only. To add real servers,
[convert the demo to production](#convert-a-demo-to-production).

### Demo memory

The console needs about 2 GiB of Docker memory, and each demo server about 1.25 GiB. 8 GB
holds the console and 4 demo servers. Stopped demo servers count. When there is no room, the
console does not start a demo server.

To change the limit, open **Settings → Resources** in Docker Desktop, or **Settings → System**
in OrbStack.

## Connect to a database service

Open the database service, select **Connection info**, and use the **From this computer
(demo)** connection string. It uses `127.0.0.1` and a port from 15432 to 15531.

## Stop, start, reset and upgrade

Run the **Manage** command and select the action in the menu, or add the option:
`curl -fsSL https://enterprise.tigerdata.com/install/timescale-enterprise.sh | sh -s -- --demo stop`.

| Option | Result |
| --- | --- |
| `--demo stop` | Stops the demo. The data stays. |
| `--demo` | Starts a stopped demo, or upgrades it to the newest release. |
| `--demo reset` | Deletes all demo servers and data, and makes a new demo. The login token stays. |

A demo that runs starts again after a restart of the computer or of Docker.

## Remove a demo

Select **Uninstall** in the menu, or use the option `--uninstall`. Type `uninstall` to
confirm. On Linux, answer `r` first.

:::warning
An uninstall deletes the console, all demo servers and their data, and the login token. You
cannot undo it.
:::

## Convert a demo to production

On Linux only: select **Convert to a production console** in the menu, or run `--uninstall`
and answer `c`.

- The console keeps its users, settings, alerts and license, and the days left of a trial.
- The installer deletes all demo servers, with their database services and backups.
- The console moves to `/opt/tse`. This needs root or `sudo`.
- The installer asks the questions of a [production install](/docs/v2026.11.5-beta/installation).
- If the convert stops, run the installer again.

The installer does not convert if the host already has a production console.
