Setup Commands

Instance setup and diagnostics commands.

`aimetier run`

One-command bootstrap and start:

pnpm aimetier run

Does:

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

Choose a specific instance:

pnpm aimetier run --instance dev

`aimetier onboard`

Interactive first-time setup:

pnpm aimetier onboard

If AImetier is already configured, rerunning onboard keeps the existing config in place. Use aimetier configure to change settings on an existing install.

First prompt:

Quickstart (recommended): local defaults (embedded database, no LLM provider, local disk storage, default secrets)
Advanced setup: full interactive configuration

Start immediately after onboarding:

pnpm aimetier onboard --run

Non-interactive defaults + immediate start (opens browser on server listen):

pnpm aimetier onboard --yes

On an existing install, --yes now preserves the current config and just starts AImetier with that setup.

`aimetier doctor`

Health checks with optional auto-repair:

pnpm aimetier doctor
pnpm aimetier doctor --repair

Validates:

Server configuration
Database connectivity
Secrets adapter configuration
Storage configuration
Missing key files

`aimetier configure`

Update configuration sections:

pnpm aimetier configure --section server
pnpm aimetier configure --section secrets
pnpm aimetier configure --section storage

`aimetier env`

Show resolved environment configuration:

pnpm aimetier env

This now includes bind-oriented deployment settings such as AIMETIER_BIND and AIMETIER_BIND_HOST when configured.

`aimetier allowed-hostname`

Allow a private hostname for authenticated/private mode:

pnpm aimetier allowed-hostname my-tailscale-host

Local Storage Paths

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

Override with:

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

Or pass --data-dir directly on any command:

pnpm aimetier run --data-dir ./tmp/aimetier-dev
pnpm aimetier doctor --data-dir ./tmp/aimetier-dev