malla/env.example at main · zenitraM/malla · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
# Malla Configuration
# Copy this file to .env and adjust the values as needed

# =============================================================================
# Docker Configuration
# =============================================================================

# Docker image to use (leave as default to use pre-built images from GHCR)
# MALLA_IMAGE=ghcr.io/zenitram/malla:latest

# Port to expose the web UI on (default: 5008)
# MALLA_WEB_PORT=5008

# Web server command (choose between Flask dev server and Gunicorn)
# Default: /app/.venv/bin/malla-web (Flask development server)
# Production: /app/.venv/bin/malla-web-gunicorn (Gunicorn WSGI server)
# MALLA_WEB_COMMAND=/app/.venv/bin/malla-web-gunicorn

# =============================================================================
# Application Configuration
# =============================================================================

# Display name shown in the navigation bar
MALLA_NAME=Malla

# Markdown content rendered on the dashboard homepage
# MALLA_HOME_MARKDOWN=

# Inline CSS injected into every page's <head> to restyle the UI without
# editing templates. Overriding Bootstrap CSS variables recolors the whole site.
# MALLA_CUSTOM_CSS=:root{--bs-primary:#14532d;--bs-primary-rgb:20,83,45}
# Raw HTML injected into <head> (favicon, meta, <link>, <script>).
# MALLA_CUSTOM_HTML_HEAD=<link rel="icon" href="/static/favicon.ico">

# Flask secret key (change this for production!)
MALLA_SECRET_KEY=your-secret-key-here

# SQLite database file path (relative or absolute)
# MALLA_DATABASE_FILE=meshtastic_history.db

# Host interface to bind the web server to
# MALLA_HOST=0.0.0.0

# TCP port for the web server
# MALLA_PORT=5008

# Enable debug mode (DO NOT use in production)
MALLA_DEBUG=false

# Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
# MALLA_LOG_LEVEL=INFO

# =============================================================================
# MQTT Configuration (Required)
# =============================================================================

# MQTT broker address (REQUIRED - set this to your broker's IP/hostname)
MALLA_MQTT_BROKER_ADDRESS=127.0.0.1

# MQTT broker port (default: 1883)
MALLA_MQTT_PORT=1883

# MQTT authentication (optional)
MALLA_MQTT_USERNAME=
MALLA_MQTT_PASSWORD=

# MQTT topic configuration (defaults should work for most setups)
MALLA_MQTT_TOPIC_PREFIX=msh
MALLA_MQTT_TOPIC_SUFFIX=/+/+/+/#

# MQTT client ID (leave empty for a randomly generated ID)
# MALLA_MQTT_CLIENT_ID=

# Reverse proxy settings
# Comma-separated IPs of trusted reverse proxies.
# When set, Malla trusts the configured client IP header only from those peers.
# Recommended for Anubis: X-Real-IP
# MALLA_TRUSTED_PROXY_CLIENT_IP_HEADER=X-Real-IP
# MALLA_TRUSTED_PROXY_IPS=10.89.0.90
# ProxyFix is still used for X-Forwarded-Proto when enabled.
# When running via malla-web-gunicorn, the same IPs are passed to Gunicorn's
# forwarded_allow_ips so forwarded headers are only accepted from those peers.

# Default channel key for decrypting secondary channels (base64, optional)
# MALLA_DEFAULT_CHANNEL_KEY=1PG7OiApB1nwvP+rz05pAQ==

# Number of hours after which to delete old data (0 = never delete)
# MALLA_DATA_RETENTION_HOURS=0

# OpenTelemetry endpoint for sending traces (optional)
# MALLA_OTLP_ENDPOINT=

# Gunicorn settings (only used when running via malla-web-gunicorn)
# Number of worker processes (null = auto-detect based on CPU cores)
# MALLA_GUNICORN_WORKERS=
# Number of threads per worker
# MALLA_GUNICORN_THREADS=1