Configuration
Meridian reads src/config.json. Copy from src/config.example.json on first
install. You can edit via the Settings panel (Profile · Search & run · LLM) or directly in the file.
See also: Dashboard guide.
Config sections
| Section | Purpose |
|---|---|
profile |
Name, skills, titles, resume summary |
preferences |
Search queries, score threshold, easy apply toggles |
locationPolicy |
Expected physical location for hybrid / WFO roles |
salary |
Compensation filters and research inputs |
transition |
Career transition mode inputs |
portals |
Enable or disable LinkedIn and Naukri |
llm |
Provider, model, base URL, webhook URL |
Environment variables
See .env.example in the repository. Environment variables override config for LLM keys and
runtime flags such as:
JOB_AGENT_MODE— search, assist-apply, demo, next-role, etc.JOB_AGENT_HEADED— launch visible browser for portal loginJOB_AGENT_PORTAL— linkedin, naukri, or bothJOB_AGENT_RUN_ID— artifact suffix for a run (UI-managed)JOB_AGENT_RESUME_RUN_ID— resume pipeline from checkpoint (UI-managed)JOB_AGENT_UI_HOST— dashboard bind address (default127.0.0.1)JOB_AGENT_UI_PORT— dashboard port (default3030)OPENAI_API_KEY,OPENAI_BASE_URL,OPENAI_MODEL
Documentation ↔ dashboard
The product docs on
vijayptiwari.github.io/meridian
link back to your self-hosted workspace. After npm run ui, open
http://127.0.0.1:3030.
If you bind Meridian to another host or port, visit any docs page once with
?dashboard=https://your-host:3030. The docs site remembers that URL in your browser for
header, footer, and sidebar dashboard links.
Security
- Never commit
src/config.jsonor.env - The UI listens on
127.0.0.1by default — do not expose it to the public internet without a reverse proxy and auth - Browser session state is stored in
data/browser-state/— treat it like a password