---
title: "Local demo"
description: "Operate and inspect the disposable Docker-backed Linguana demonstration stack."
canonical_url: "https://docs.linguana.dev/docs/advanced/testing/local-demo"
markdown_url: "https://docs.linguana.dev/docs/advanced/testing/local-demo.md"
x_farming_labs_generated_preamble: true
---

# Local demo
URL: /docs/advanced/testing/local-demo
LLM index: /llms.txt
Description: Operate and inspect the disposable Docker-backed Linguana demonstration stack.

# Test the local demo

> For Linguana contributors and beta evaluators. This is not the application installation guide.

## Start

Copy `.env.example` to `.env`, provide `OPENROUTER_API_KEY`, then run:

```bash
bun run demo:up
```

The command builds the API, dashboard, PostgreSQL, MinIO, Inngest, and TanStack example; deploys migrations; seeds idempotently; and waits for the example on `http://localhost:3010`.

## Service map

| Service | URL |
| --- | --- |
| API | `http://localhost:3000` |
| Landing | `http://localhost:3001` |
| Dashboard | `http://localhost:3002` |
| Admin | `http://localhost:3003` |
| Example | `http://localhost:3010` |
| Inngest | `http://localhost:8288` |
| MinIO console | `http://localhost:9001` |

## Exercise the loop

Open the example, switch to French, edit literal example copy, and run `bun run demo:up` again. The changed build should translate only new content while reusing prior exact matches.

## Diagnose and clean up

```bash
bun run demo:logs
bun run docker:down
```

<ExpectedResult>
The example renders French without a locale URL, source files remain unchanged, and production is not automatically published.
</ExpectedResult>

If startup fails, inspect the earliest unhealthy dependency rather than repeatedly rebuilding. Continue with [Live-provider testing](/docs/advanced/testing/live-provider) for the retained interactive stack.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).