Configuration Guide
SmartDocs is configured through environment variables and a smartdocs.config.js file.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
SMARTDOCS_AI_PROVIDER | No | openai | LLM provider |
SMARTDOCS_API_KEY | Yes | — | Your API key |
SMARTDOCS_MODEL | No | gpt-4o-mini | Model name |
SMARTDOCS_BASE_URL | No | — | Custom endpoint |
Providers
OpenAI (default):
SMARTDOCS_AI_PROVIDER=openai SMARTDOCS_API_KEY=sk-... SMARTDOCS_MODEL=gpt-4o-mini
Anthropic:
SMARTDOCS_AI_PROVIDER=anthropic SMARTDOCS_API_KEY=sk-ant-... SMARTDOCS_MODEL=claude-sonnet-4-20250514
Local with Ollama:
SMARTDOCS_AI_PROVIDER=openai-compatible SMARTDOCS_BASE_URL=http://localhost:11434/v1 SMARTDOCS_MODEL=llama-3.2-3b # No API key needed
Security
API keys are server-side only. They're read from process.env in Next.js API routes and never sent to the browser.
Next: API Reference