Merge commit '56382a92b7f128fb25df463bca616ec97c1c7b99' as 'compose'

2025-09-01 08:43:15 -04:00
parent 8985952112 56382a92b7
commit 5f397fc5b2
12 changed files with 1655 additions and 0 deletions
@@ -0,0 +1,120 @@
+# OpenVoiceOS Docker Compose Environment Configuration
+# Optimized version with improved defaults and documentation
+# Copy this file to .env and modify the values as needed
+
+# =============================================================================
+# USER AND GROUP CONFIGURATION
+# =============================================================================
+# Primary users (defined first to avoid circular references)
+OVOS_USER=ovos
+HIVEMIND_USER=hivemind
+
+# =============================================================================
+# DISPLAY AND GRAPHICS CONFIGURATION
+# =============================================================================
+# X11 Display configuration
+DISPLAY=:0
+WAYLAND_DISPLAY=wayland-0
+XDG_RUNTIME_DIR=/run/user/1000
+
+# Qt/GUI Configuration
+QT_QPA_PLATFORM=eglfs
+QT_QPA_EGLFS_INTEGRATION=eglfs_kms
+QT_QPA_EGLFS_KMS_CONFIG=/home/ovos/.config/mycroft/ovos-eglfs.json
+
+# =============================================================================
+# SYSTEM GROUP CONFIGURATION
+# =============================================================================
+
+# System Group IDs (adjust based on your system)
+# Use: getent group <groupname> | cut -d: -f3
+INPUT_GID=102
+RENDER_GID=106
+VIDEO_GID=44
+
+# Raspberry Pi specific Group IDs (only used on Pi)
+GPIO_GID=997
+I2C_GID=994
+SPI_GID=995
+
+# =============================================================================
+# DIRECTORY CONFIGURATION
+# =============================================================================
+# OVOS directories
+OVOS_CONFIG_FOLDER=/home/ovos/ovos/config
+OVOS_CONFIG_PHAL_FOLDER=/home/ovos/ovos/config/phal
+OVOS_PERSONA_FOLDER=/home/ovos/ovos/config/persona
+OVOS_SHARE_FOLDER=/home/ovos/ovos/share
+TMP_FOLDER=/home/ovos/ovos/tmp
+
+# Hivemind directories
+HIVEMIND_CONFIG_FOLDER=/home/hivemind/hivemind/config
+HIVEMIND_CONFIG_PHAL_FOLDER=/home/hivemind/hivemind/config/phal
+HIVEMIND_SHARE_FOLDER=/home/hivemind/hivemind/share
+
+# =============================================================================
+# DOCKER CONFIGURATION
+# =============================================================================
+# Image version and pull policy
+VERSION=alpha
+PULL_POLICY=always
+
+# =============================================================================
+# SYSTEM CONFIGURATION
+# =============================================================================
+# Timezone configuration
+TZ=UTC
+
+# =============================================================================
+# PLATFORM-SPECIFIC OVERRIDES
+# =============================================================================
+# Uncomment and modify based on your platform:
+
+# For macOS:
+# PULSE_SERVER=docker.for.mac.host.internal
+
+# For Windows WSL:
+# PULSE_SERVER=/mnt/wslg/PulseServer
+# XDG_RUNTIME_DIR=/mnt/wslg
+
+# For standard Linux:
+# PULSE_SERVER=unix:/run/user/1000/pulse/native
+
+# =============================================================================
+# RESOURCE LIMITS (Optional - uncomment to override defaults)
+# =============================================================================
+# Memory limits for different service types
+# CORE_MEMORY_LIMIT=1G
+# STANDARD_MEMORY_LIMIT=512M
+# LIGHT_MEMORY_LIMIT=256M
+
+# CPU limits
+# CORE_CPU_LIMIT=1.0
+# STANDARD_CPU_LIMIT=0.5
+
+# =============================================================================
+# ADVANCED CONFIGURATION
+# =============================================================================
+# Health check intervals (uncomment to override defaults)
+# HEALTH_CHECK_INTERVAL=30s
+# HEALTH_CHECK_TIMEOUT=10s
+# HEALTH_CHECK_RETRIES=3
+
+# Logging configuration
+# LOG_MAX_SIZE=200m
+# LOG_MAX_FILES=1
+
+# =============================================================================
+# SECURITY CONFIGURATION
+# =============================================================================
+# Set to 'true' to enable additional security features
+# ENABLE_APPARMOR=false
+# ENABLE_SECCOMP=false
+
+# =============================================================================
+# DEVELOPMENT CONFIGURATION
+# =============================================================================
+# Development mode settings (uncomment for development)
+# DEV_MODE=false
+# DEBUG_LOGGING=false
+# ENABLE_PROFILING=false