.env.example

# lsget Environment Variables Configuration
# Copy this file to .env and customize as needed

# Server Configuration
# --------------------

# Address to bind the server to (REQUIRED)
# This is where the server listens (network layer)
# Default: 0.0.0.0:8080 (docker) or localhost:8080 (local)
LSGET_ADDR=0.0.0.0:8080

# Directory to serve files from (REQUIRED)
# Default: . (current directory) or /data (docker)
LSGET_DIR=/data

# Maximum bytes to display with cat command
# Default: 4096 (4 KB)
LSGET_CATMAX=4096

# Public Base URL (OPTIONAL - auto-detects if not set)
# Only needed when behind reverse proxy or when public URL differs from bind address
#
# When to use:
#   - Behind Nginx/Caddy/Traefik with different public URL
#   - Docker with custom domain mapping
#   - Generating sitemap.xml with canonical URLs
#
# When NOT needed (leave empty):
#   - Running locally for development
#   - Direct access without reverse proxy
#   - Auto-detection from request works fine
#
# Format: Full URL with protocol (http:// or https://) WITHOUT trailing slash
# Examples:
#   LSGET_BASEURL=https://files.example.com
#   LSGET_BASEURL=http://cdn.example.com:8080
#   LSGET_BASEURL=https://example.com/files
#
# Leave empty for auto-detection (recommended for most setups):
LSGET_BASEURL=

# Logging Configuration
# ---------------------

# Path to access log file for statistics
# Leave empty to disable logging
LSGET_LOGFILE=/logs/access.log

# Process Management
# ------------------

# Path to PID file
# Leave empty to not create a PID file
LSGET_PID=

# Sitemap Generation
# ------------------

# Generate sitemap.xml every N minutes
# Set to 0 to disable sitemap generation
# Default: 0 (disabled)
LSGET_SITEMAP=0

# Docker-Specific
# ---------------

# Port mapping for docker-compose
# Maps host port to container port 8080
# Default: 8080
LSGET_PORT=8080