config.env.example

# Configuration for LLM Development Stack
# Copy this file to config.env and edit the paths for your environment
#
# This configuration can be used as-is without modification.
# All paths are relative to BASE_DIR and will be created automatically.
#
# Default directory structure (using $HOME/llmops_services as BASE_DIR):
#
# $HOME/llmops_services/
# ├── forgejo/
# │   ├── bin/
# │   │   └── forgejo                 # Forgejo binary
# │   ├── data/
# │   │   └── gitea/
# │   │       ├── conf/
# │   │       │   └── app.ini         # Forgejo configuration
# │   │       ├── gitea.db            # SQLite database
# │   │       └── gitea-repositories/ # Git repositories
# │   └── logs/
# │       └── forgejo.log             # Forgejo application logs
# ├── mlflow/
# │   ├── tracking/                   # MLflow tracking database location
# │   ├── artifacts/                  # MLflow artifact storage
# │   ├── logs/                       # MLflow application logs
# │   └── mlflow.db                   # MLflow SQLite database
# ├── venv/                           # Python virtual environment
# │   ├── bin/
# │   │   ├── activate               # Virtual environment activation script
# │   │   ├── mlflow                 # MLflow CLI
# │   │   └── python                 # Python interpreter
# │   └── lib/python3.x/site-packages/
# ├── logs/                           # Shared log directory for service startup
# └── activate.sh                     # Environment activation script
#
# Additional files created in project root during runtime:
# ├── .forgejo.pid                    # Forgejo process ID (for shutdown)
# ├── .forgejo.port                   # Forgejo port number (for access)
# ├── .mlflow.pid                     # MLflow process ID (for shutdown)
# └── .mlflow.port                    # MLflow port number (for access)

# Base directory for all services (change to your preferred location)
BASE_DIR="$HOME/llmops_services"

# Forgejo configuration
FORGEJO_HOME="$BASE_DIR/forgejo"
FORGEJO_DATA_DIR="$FORGEJO_HOME/data"
FORGEJO_LOG_DIR="$FORGEJO_HOME/logs"
FORGEJO_BINARY_PATH="$FORGEJO_HOME/bin/forgejo"
FORGEJO_VERSION="12.0.0"  # Change to desired version

# MLflow configuration
MLFLOW_HOME="$BASE_DIR/mlflow"
MLFLOW_TRACKING_URI="$MLFLOW_HOME/tracking"
MLFLOW_ARTIFACT_ROOT="$MLFLOW_HOME/artifacts"
MLFLOW_LOG_DIR="$MLFLOW_HOME/logs"
MLFLOW_BACKEND_STORE="sqlite:///$MLFLOW_HOME/mlflow.db"

# Python virtual environment for MLflow
PYTHON_VENV_DIR="$BASE_DIR/venv"

# Shared logs directory
LOGS_DIR="$BASE_DIR/logs"

# Default ports (will be auto-detected if busy)
DEFAULT_FORGEJO_PORT=3000
DEFAULT_MLFLOW_PORT=5000

# Service management settings
GRACEFUL_SHUTDOWN_TIMEOUT=10  # Seconds to wait for graceful shutdown before force kill
STATUS_CHECK_TIMEOUT=2        # Seconds to wait when testing service responsiveness
MLFLOW_SERVER_HOST="127.0.0.1"  # MLflow server host (127.0.0.1 for localhost only, 0.0.0.0 for all interfaces)
FORGEJO_SERVER_HOST="127.0.0.1"  # Forgejo server host (127.0.0.1 for localhost only, 0.0.0.0 for all interfaces)

# Backup settings
BACKUP_BASE_DIR="$BASE_DIR/backups"  # Directory to store backups