Forjinn Docs

Development Platform

Documentation v2.0
Made with
by Forjinn

Environment Variables

Learn about environment variables and how to implement it effectively.

2 min read
🆕Recently updated
Last updated: 12/9/2025

Environment Variables Reference

This page lists all important environment variables for configuring, securing, and tuning InnoSynth-Forjinn for various deployment scenarios—cloud, docker, k8s, on-prem, and CI.


How to Use

  • Set env variables in .env files (Docker), deployment charts (K8s), or process manager configs.
  • Priority: Inline (process) > .env file > chart > defaults.
  • Sensitive keys/secrets should be injected via secret manager if possible.

Core Config

  • PORT – Main web server/API port (default: 3000)
  • NODE_ENVdevelopment/production (affects logs, error output, caching)
  • LOG_LEVELinfo/warn/error/debug/trace
  • BASE_URL – Public URL for the platform, used in links/callbacks

Database & Storage

  • DB_TYPEpostgres/sqlite/mysql/etc
  • DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS
  • REDIS_URL or CACHE_URL – for caching/session storage
  • FILE_STORAGE_PATH – Directory for uploads/artifacts

Credentials & Secrets

  • OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc – for provider LLMs/tools
  • ENCRYPTION_KEY – Encryption for sensitive config/DB fields

SSO & Auth

  • OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_DISCOVERY_URL – for OpenID/OAuth2
  • SAML_METADATA_URL, SAML_ENTITY_ID, etc – for SAML integrations

Workers & Concurrency

  • WORKER_COUNT – Max concurrent workflow/agent worker processes/pods
  • JOB_QUEUE_URL – External queue for distributed/multi-node deployments
  • MAX_TOKENS – Limit tokens per LLM call (cost/control purposes)

Observability (Logs/Monitoring)

  • LOG_PATH – Directory for writing logs (/logs default)
  • PROMETHEUS_METRICS_ENABLED – Enable platform metrics endpoint
  • NEW_RELIC_KEY/DATADOG_KEY – Third-party monitoring keys

Advanced & Custom

  • NO_TELEMETRY – Opt out of usage stats/reporting to vendor
  • FEATURE_FLAGS – Turn on/off experimental features (FEATURE_FLAGS=AutoGen,CrewAI)
  • RATE_LIMIT_* – Set rate limiting thresholds (API, UI, agent runs)

K8s/Docker-only

  • POD_NAME, NAMESPACE, CLUSTER_ID – Used for metrics/log cross-correlation
  • K8S_HEALTHCHECK_PATH – For Kubernetes readiness/liveness probes

Security

  • ALLOWED_ORIGINS – CORS policy; specify whitelisted domains for API/UI
  • SESSION_TIMEOUT – Session expiration in minutes/hours

Troubleshooting

  • Always validate .env values and restart services after changes.
  • Use docker-compose config or kubectl describe to confirm actual loaded env values.
  • For secrets, never print in logs or expose to users!
  • Version control: Never commit .env files with secrets to source control.

Master the environment variables for reliable, secure, compliant, and high-performance deployments—review on every upgrade or environment change!