Skip to content

Config: Standardize frontend origin environment variables across services #1349

@cosmoqain459

Description

@cosmoqain459

Problem

The current Docker configuration uses multiple environment variables representing frontend origin and CORS-related configuration:

  • FRONTEND_URL
  • FRONTEND_ORIGIN
  • CORS_ALLOWED_ORIGINS

These variables are passed to different services and appear to serve closely related purposes.

This creates multiple configuration sources that contributors must understand and maintain when changing frontend deployment URLs.

Impact

Potential issues include:

  • Increased configuration complexity.
  • Higher risk of inconsistent values between services.
  • Additional maintenance burden when deployment URLs change.
  • Confusion for new contributors during environment setup.

Suggested Investigation

Review:

  • Which variables are actively consumed by each service.
  • Whether any variables are redundant.
  • Whether a common naming convention can be adopted.
  • Whether documentation accurately describes the required configuration.

Proposed Changes

  • Audit usage of:

    • FRONTEND_URL
    • FRONTEND_ORIGIN
    • CORS_ALLOWED_ORIGINS
  • Identify variables that represent the same frontend endpoint.

  • Standardize naming where practical.

  • Update service configuration to use a consistent convention.

  • Update:

    • .env.example
    • docker-compose.yml
    • setup documentation
  • Document the purpose of each remaining variable to reduce contributor confusion.

Expected Outcome

Frontend origin configuration should be clearly documented and use a consistent naming strategy wherever possible.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions