Environment Variables
Configure Inkog behavior using environment variables. Command-line flags take precedence over environment variables.
Available Variables
| Variable | Description | Default |
|---|---|---|
INKOG_SERVER_URL | Override the Inkog API server endpoint | https://inkog-api.fly.dev |
INKOG_API_KEY | API key for enterprise authentication | None |
INKOG_OUTPUT_FORMAT | Default output format (text, json, html) | text |
CI | Enables quiet mode (suppresses spinners/colors) | Auto-detected |
Priority Order
Configuration values are resolved in this order (highest to lowest):
- Command-line flags (highest priority)
- Environment variables
- Default values (lowest priority)
Examples
Setting Default Output Format
# Always output JSON
export INKOG_OUTPUT_FORMAT=json
inkog .Using Enterprise Server
# Point to self-hosted instance
export INKOG_SERVER_URL=https://inkog.internal.company.com
export INKOG_API_KEY=your-enterprise-key
inkog .CI/CD Environment
The CI variable is automatically set by most CI platforms:
| Platform | Auto-set |
|---|---|
| GitHub Actions | CI=true |
| GitLab CI | CI=true |
| CircleCI | CI=true |
| Travis CI | CI=true |
| Jenkins | Varies |
When CI is set:
- Progress spinners are disabled
- ANSI colors are suppressed
- Output is optimized for log files
Manual Quiet Mode
# Force quiet mode outside CI
CI=true inkog .Shell Configuration
Add to your shell profile for persistent configuration:
Bash (~/.bashrc):
export INKOG_OUTPUT_FORMAT=json
export INKOG_SERVER_URL=https://inkog-api.fly.devZsh (~/.zshrc):
export INKOG_OUTPUT_FORMAT=json
export INKOG_SERVER_URL=https://inkog-api.fly.devFish (~/.config/fish/config.fish):
set -x INKOG_OUTPUT_FORMAT json
set -x INKOG_SERVER_URL https://inkog-api.fly.devNetwork Configuration
Timeouts
- HTTP timeout: 60 seconds
- Retry attempts: 3 with exponential backoff (2s, 4s, 8s)
- Rate limit handling: Respects
Retry-Afterheader (default 30s)
Proxy Support
Inkog respects standard HTTP proxy environment variables:
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1Last updated on