Local Development

Ce contenu n’est pas encore disponible dans votre langue.

Run AImetier locally with zero external dependencies.

Prerequisites

Node.js 20+
pnpm 9+

Start Dev Server

pnpm install
pnpm dev

This starts:

API server at http://localhost:3100
UI served by the API server in dev middleware mode (same origin)

No Docker or external database required. AImetier uses embedded PostgreSQL automatically.

One-Command Bootstrap

For a first-time install:

pnpm aimetier run

This does:

Auto-onboards if config is missing
Runs aimetier doctor with repair enabled
Starts the server when checks pass

Bind Presets In Dev

Default pnpm dev stays in local_trusted with loopback-only binding.

To open AImetier to a private network with login enabled:

pnpm dev --bind lan

Tailscale support is disabled (2026-06-15) — the --bind tailnet preset is rejected. Use --bind lan for private-network access. To bind to a specific tailnet address you manage yourself, set AIMETIER_TAILNET_BIND_HOST=<addr> explicitly (AImetier no longer auto-detects it).

Allow additional private hostnames:

pnpm aimetier allowed-hostname dotta-macbook-pro

For private-network access details, see Tailscale Private Access (Disabled).

Health Checks

curl http://localhost:3100/api/health
# -> {"status":"ok"}

curl http://localhost:3100/api/companies
# -> []

Reset Dev Data

To wipe local data and start fresh:

rm -rf ~/.aimetier/instances/default/db
pnpm dev

Data Locations

Data	Path
Config	`~/.aimetier/instances/default/config.json`
Database	`~/.aimetier/instances/default/db`
Storage	`~/.aimetier/instances/default/data/storage`
Secrets key	`~/.aimetier/instances/default/secrets/master.key`
Logs	`~/.aimetier/instances/default/logs`

Override with environment variables:

AIMETIER_HOME=/custom/path AIMETIER_INSTANCE_ID=dev pnpm aimetier run