environment-variables.md

Environment Variables

This section explains the environment variables used to configure the Smart Route Planning Agent.

1. Core Configuration
2. Network Configuration
3. Application Settings
4. Proxy Settings

Core Configuration

Variable	Default	Description
HOST_IP	Auto-detected	Host IP address for the application. Automatically detected from the network interface. Falls back to 127.0.0.1 if detection fails.
TAG	1.0.0-rc1	Docker image tag to use when building and running containers.
REGISTRY	(empty)	Docker registry path for pulling or pushing images.

Network Configuration

Variable	Default	Description
AI_ROUTE_PLANNER_PORT	7864	Port on which the Smart Route Planning Agent UI is accessible.

Application Settings

Variable	Default	Description
TRAFFIC_BUFFER_DURATION	60	Duration in seconds for traffic data buffering.
LOG_LEVEL	INFO	Logging level for the application. Options: DEBUG, INFO, WARNING, ERROR.
DATA_RETENTION_HOURS	24	Number of hours to retain traffic data.

Proxy Settings

Variable	Default	Description
http_proxy	(system)	HTTP proxy URL for outbound connections.
https_proxy	(system)	HTTPS proxy URL for outbound connections.
no_proxy	(system)	Comma-separated list of hosts to bypass proxy. HOST_IP is automatically added.

Set Environment Variables

Configure Using the Setup Script (Recommended)

The setup script automatically configures most environment variables. To override defaults, export variables before running the script:

export AI_ROUTE_PLANNER_PORT=8080
export LOG_LEVEL=DEBUG
source setup.sh --setup

Configure Manually

For manual deployment, create a .env file in the src/ directory:

HOST_IP=192.168.1.100
AI_ROUTE_PLANNER_PORT=7864
TAG=latest
LOG_LEVEL=INFO
TRAFFIC_BUFFER_DURATION=60
DATA_RETENTION_HOURS=24

Run the Docker Compose tool:

cd src
docker compose --env-file .env up