Skip to content
Reference
CLI Reference

CLI Reference

vectora [command] [options]

Commands

CommandWhat it does
(no args)prints help
startstarts the full backend + the SPA (fullstack)
start --headlessstarts without opening a window (backend + tray)
configshows/edits settings; subcommands: keys, docker, qdrant, redis
storagemigrations, diagnostics, backup/restore, BaaS wizard
sessionslists all saved sessions

start options

OptionDefaultDescription
--headless—doesn’t open a window (keeps backend + MCP + tray)
--host <host>0.0.0.0listen host
--port <n>8080port
--ssl-certfile / --ssl-keyfile <pem>—serve over https://

vectora config 

vectora config keys         # interactive wizard for API keys + LLM provider
vectora config docker up    # spins up local Postgres + Redis + Qdrant (Docker)
vectora config qdrant       # Qdrant-specific config
vectora config redis        # Redis-specific config

vectora storage 

vectora storage wizard                       # managed infra wizard (Supabase/Neon/Qdrant Cloud/self-hosted)
vectora storage migrate status               # applied/pending migrations
vectora storage migrate upgrade              # applies pending migrations
vectora storage migrate to-postgres          # SQLite → Postgres
vectora storage migrate to-qdrant <collection> # LanceDB → Qdrant
vectora storage migrate to-pgvector          # LanceDB → pgvector
vectora storage migrate memory-to-native     # old memories → native store

See Storage: lite vs. complete for the full context.

vectora sessions 

vectora sessions

Lists all locally saved sessions (threads).

Typical usage on a VPS over SSH

The frontend covers day-to-day configuration, but on a headless server the CLI exposes the essentials:

uv run vectora config keys         # configure API keys
uv run vectora config docker up    # spin up optional infrastructure
uv run vectora start --headless    # backend + MCP, no window
Configuration (Reference)