signoz-aio

Overview

SigNoz is a self-hosted observability platform for traces, metrics, and logs.
[center][color=#ff8c00]JSONbored Verified AIO Template[/color][/center]

This Unraid AIO template packages the official SigNoz Docker stack into a single container with sensible defaults for a first deployment. It internally manages SigNoz, the SigNoz OTEL collector, ClickHouse, and ZooKeeper, so you do not need to translate the upstream multi-container compose stack yourself. Advanced users can also override the metadata database and ClickHouse endpoints with supported upstream-backed settings.

All-In-One (AIO) Edition
Install it, keep the defaults, and point your OpenTelemetry senders at the published OTLP ports. Advanced settings are available for power users, but they are intentionally limited to real upstream-backed options instead of speculative extras.

Initial Setup:

Click Apply.
Wait for first startup to complete. This image boots multiple internal services, so the first run is heavier than a typical single-service container.
Open the WebUI on port 8080.
Send telemetry to OTLP gRPC on 4317 or OTLP HTTP on 4318.
Optional: enable the built-in local host agent and explicitly fill the advanced host/Docker path fields if you want this same Unraid machine to forward host metrics, Docker metrics, and Docker logs into SigNoz.

Resource Note: ClickHouse makes SigNoz powerful, but also heavier on RAM, disk, and startup time than lighter AIO apps.

Requirements

SigNoz is a heavier ClickHouse-backed observability stack; allocate at least 4GB Docker memory and expect a slower first boot than small single-service apps. Back up /appdata before upgrades. The optional local host agent requires explicitly enabling only the host and Docker mounts you need; mounting /var/run/docker.sock grants Docker control access to the container.

Runtime arguments

Web UI: http://[IP]:[PORT:8080]
Network: bridge
Shell: sh
Privileged: false

Template configuration

SigNoz UI PortPorttcp

Main SigNoz UI and API port.

Target: 8080
Default: 8080
Value: 8080

OTLP gRPC PortPorttcp

OTLP gRPC ingest port for agents, SDKs, and collectors sending telemetry into SigNoz.

Target: 4317
Default: 4317
Value: 4317

OTLP HTTP PortPorttcp

OTLP HTTP ingest port for telemetry senders that use HTTP instead of gRPC.

Target: 4318
Default: 4318
Value: 4318

AppData - SigNoz RootPathrw

Single persistent root that stores ClickHouse data, ZooKeeper state, generated config, and SigNoz SQLite metadata by default.

Target: /appdata
Default: /mnt/user/appdata/signoz-aio
Value: /mnt/user/appdata/signoz-aio

[Host Agent] Enable Local Host AgentVariable

Advanced. Set to true to let this same container also collect local host metrics, Docker metrics, Docker logs, or Prometheus targets after you explicitly configure the host mounts or targets below.

Target: SIGNOZ_ENABLE_HOST_AGENT
Default: false|true
Value: false

TimezoneVariable

Container timezone.

Target: TZ
Default: UTC
Value: UTC

[AIO] Startup Wait Timeout SecondsVariable

Advanced. Maximum seconds the wrapper waits for SigNoz or ClickHouse readiness before failing with a clear startup error.

Target: SIGNOZ_AIO_WAIT_TIMEOUT_SECONDS
Default: 300
Value: 300

[SigNoz] Version Banner EnabledVariable

Advanced. Shows the upstream SigNoz startup version banner.

Target: SIGNOZ_VERSION_BANNER_ENABLED
Default: true|false
Value: true

[SigNoz] Internal Log LevelVariable

Advanced. Log level for SigNoz internal instrumentation logs.

Target: SIGNOZ_INSTRUMENTATION_LOGS_LEVEL
Default: info|debug|warn|error
Value: info

[SigNoz] Internal Tracing EnabledVariable

Advanced. Enables SigNoz self-tracing; only enable when you have a clear internal telemetry target.

Target: SIGNOZ_INSTRUMENTATION_TRACES_ENABLED
Default: false|true
Value: false

[SigNoz] Internal Tracing OTLP EndpointVariable

Advanced. OTLP endpoint used by SigNoz self-tracing when internal tracing is enabled.

Target: SIGNOZ_INSTRUMENTATION_TRACES_PROCESSORS_BATCH_EXPORTER_OTLP_ENDPOINT
Default: localhost:4317
Value: localhost:4317

[SigNoz] Internal Metrics EnabledVariable

Advanced. Enables SigNoz self-metrics.

Target: SIGNOZ_INSTRUMENTATION_METRICS_ENABLED
Default: true|false
Value: true

[SigNoz] Internal Metrics HostVariable

Advanced. Internal Prometheus host used for SigNoz self-metrics. This port is not published by the Unraid template.

Target: SIGNOZ_INSTRUMENTATION_METRICS_READERS_PULL_EXPORTER_PROMETHEUS_HOST
Default: 0.0.0.0
Value: 0.0.0.0

[SigNoz] Internal Metrics PortVariable

Advanced. Internal Prometheus port used for SigNoz self-metrics. This port is not published by the Unraid template.

Target: SIGNOZ_INSTRUMENTATION_METRICS_READERS_PULL_EXPORTER_PROMETHEUS_PORT
Default: 9090
Value: 9090

[Access] External URLVariable

Advanced. Public SigNoz URL used in generated links when serving through a reverse proxy.

Target: SIGNOZ_GLOBAL_EXTERNAL__URL

[Access] Ingestion URLVariable

Advanced. Public ingestion endpoint URL if agents should advertise a different OTLP endpoint than the UI URL.

Target: SIGNOZ_GLOBAL_INGESTION__URL

[Metadata DB] ProviderVariable

Advanced. Metadata database backend for organizations, users, dashboards, and settings. Leave at sqlite for the built-in self-contained install, or set to postgres to use an external PostgreSQL database.

Target: SIGNOZ_SQLSTORE_PROVIDER
Default: sqlite|postgres
Value: sqlite

[Metadata DB] SQLite PathVariable

Advanced. SQLite file path for SigNoz metadata when the metadata DB provider is set to sqlite.

Target: SIGNOZ_SQLSTORE_SQLITE_PATH
Default: /appdata/signoz/signoz.db
Value: /appdata/signoz/signoz.db

[Metadata DB] SQLite Journal ModeVariable

Advanced. SQLite journal mode for the default metadata database.

Target: SIGNOZ_SQLSTORE_SQLITE_MODE
Default: wal|delete
Value: wal

[Metadata DB] SQLite Busy TimeoutVariable

Advanced. How long SQLite waits for metadata database locks before failing.

Target: SIGNOZ_SQLSTORE_SQLITE_BUSY__TIMEOUT
Default: 10s
Value: 10s

[Metadata DB] SQLite Transaction ModeVariable

Advanced. SQLite transaction locking mode.

Target: SIGNOZ_SQLSTORE_SQLITE_TRANSACTION__MODE
Default: deferred|immediate|exclusive
Value: deferred

[Metadata DB] Max Open ConnectionsVariable

Advanced. Maximum open SQL metadata-store connections.

Target: SIGNOZ_SQLSTORE_MAX__OPEN__CONNS
Default: 100
Value: 100

[Metadata DB] Max Connection LifetimeVariable

Advanced. Maximum SQL metadata connection lifetime. Use 0s for no lifetime limit.

Target: SIGNOZ_SQLSTORE_MAX__CONN__LIFETIME
Default: 0s
Value: 0s

[Metadata DB] PostgreSQL DSNVariable

Advanced. PostgreSQL connection string used when SIGNOZ_SQLSTORE_PROVIDER=postgres. Example: postgres://signoz:your_password@postgres:5432/signoz?sslmode=disable

Target: SIGNOZ_SQLSTORE_POSTGRES_DSN

[Auth] Provision Root UserVariable

Advanced. Set to true to provision a SigNoz root admin user on startup. This works with either SQLite or PostgreSQL metadata storage.

Target: SIGNOZ_USER_ROOT_ENABLED
Default: false|true
Value: false

[Auth] Root User EmailVariable

Advanced. Root user email address used when root user provisioning is enabled.

Target: SIGNOZ_USER_ROOT_EMAIL

[Auth] Root User PasswordVariable

Advanced. Root user password used when root user provisioning is enabled.

Target: SIGNOZ_USER_ROOT_PASSWORD

[Auth] Root User Org NameVariable

Advanced. Organization name for the provisioned root user.

Target: SIGNOZ_USER_ROOT_ORG_NAME
Default: default
Value: default

[Auth] Root User Org IDVariable

Advanced. Optional predetermined UUIDv7 for the root user's organization.

Target: SIGNOZ_USER_ROOT_ORG_ID

[Auth] Invite Max Token LifetimeVariable

Advanced. Maximum lifetime for invitation tokens.

Target: SIGNOZ_USER_PASSWORD_INVITE_MAX__TOKEN__LIFETIME
Default: 48h
Value: 48h

[Auth] Allow Self Password ResetVariable

Advanced. Allows users to request their own password reset flow.

Target: SIGNOZ_USER_PASSWORD_RESET_ALLOW__SELF
Default: false|true
Value: false

[Auth] Reset Max Token LifetimeVariable

Advanced. Maximum lifetime for password reset tokens.

Target: SIGNOZ_USER_PASSWORD_RESET_MAX__TOKEN__LIFETIME
Default: 6h
Value: 6h

[Host Agent] Host Root PathPathro

Advanced optional host metrics mount. Leave blank unless enabling the local host agent. Set to / only if you want to mount the Unraid host root read-only for host metrics.

Target: /hostfs

[Host Agent] Docker SocketPathrw

Advanced optional Docker metrics mount. Leave blank unless enabling Docker metrics for the local host agent. Setting this to /var/run/docker.sock grants Docker control access to this container.

Target: /var/run/docker.sock

[Host Agent] Docker Container Logs PathPathro

Advanced optional Docker log mount. Leave blank unless enabling Docker log collection for the local host agent. Set to /var/lib/docker/containers to read local Docker JSON logs.

Target: /var/lib/docker/containers

Tokenizer JWT SecretVariable

Optional. Leave blank to auto-generate a persistent secret on first boot and save it under /appdata/config/generated.env.

Target: SIGNOZ_TOKENIZER_JWT_SECRET

[Tokenizer] Rotation IntervalVariable

Advanced. Interval for SigNoz token rotation.

Target: SIGNOZ_TOKENIZER_ROTATION_INTERVAL
Default: 30m
Value: 30m

[Tokenizer] Rotation Grace DurationVariable

Advanced. Grace duration for previous token pairs after rotation.

Target: SIGNOZ_TOKENIZER_ROTATION_DURATION
Default: 1m
Value: 1m

[Tokenizer] Idle LifetimeVariable

Advanced. Idle session lifetime before reauthentication.

Target: SIGNOZ_TOKENIZER_LIFETIME_IDLE
Default: 168h
Value: 168h

[Tokenizer] Max LifetimeVariable

Advanced. Maximum session lifetime before reauthentication.

Target: SIGNOZ_TOKENIZER_LIFETIME_MAX
Default: 720h
Value: 720h

[Tokenizer] Opaque GC IntervalVariable

Advanced. Garbage collection interval for opaque session tokens.

Target: SIGNOZ_TOKENIZER_OPAQUE_GC_INTERVAL
Default: 1h
Value: 1h

[Tokenizer] Max Tokens Per UserVariable

Advanced. Maximum opaque tokens tracked per user when using opaque token internals.

Target: SIGNOZ_TOKENIZER_OPAQUE_TOKEN_MAX__PER__USER
Default: 5
Value: 5

[ClickHouse] Use External ClickHouseVariable

Advanced. Set to true to disable the bundled ClickHouse and ZooKeeper services and use external ClickHouse endpoints instead. When enabled, configure the ClickHouse DSN and healthcheck URL options below.

Target: SIGNOZ_USE_EXTERNAL_CLICKHOUSE
Default: false|true
Value: false

[ClickHouse] Base DSNVariable

Advanced. Base ClickHouse DSN used by SigNoz. Leave at the default for the bundled database, or point it at your external ClickHouse endpoint.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_DSN
Default: tcp://127.0.0.1:9000
Value: tcp://127.0.0.1:9000

[ClickHouse] Cluster NameVariable

Advanced. ClickHouse cluster name used by the SigNoz server for telemetry-store queries. Leave at cluster for the bundled deployment.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_CLUSTER
Default: cluster
Value: cluster

[ClickHouse] Healthcheck URLVariable

Advanced. HTTP healthcheck URL used before SigNoz and the collector start. Change this when using external ClickHouse.

Target: SIGNOZ_CLICKHOUSE_HEALTHCHECK_URL
Default: http://127.0.0.1:8123/ping
Value: http://127.0.0.1:8123/ping

[ClickHouse] Max Open ConnectionsVariable

Advanced. Maximum open ClickHouse connections used by SigNoz.

Target: SIGNOZ_TELEMETRYSTORE_MAX__OPEN__CONNS
Default: 100
Value: 100

[ClickHouse] Max Idle ConnectionsVariable

Advanced. Maximum idle ClickHouse connections used by SigNoz.

Target: SIGNOZ_TELEMETRYSTORE_MAX__IDLE__CONNS
Default: 50
Value: 50

[ClickHouse] Dial TimeoutVariable

Advanced. ClickHouse connection dial timeout.

Target: SIGNOZ_TELEMETRYSTORE_DIAL__TIMEOUT
Default: 5s
Value: 5s

[ClickHouse] Query Max Execution TimeVariable

Advanced. Optional ClickHouse max_execution_time query setting.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_MAX__EXECUTION__TIME

[ClickHouse] Query Max Execution Time LeafVariable

Advanced. Optional ClickHouse max_execution_time_leaf query setting.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_MAX__EXECUTION__TIME__LEAF

[ClickHouse] Query Speed Check DelayVariable

Advanced. Optional ClickHouse timeout_before_checking_execution_speed query setting.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_TIMEOUT__BEFORE__CHECKING__EXECUTION__SPEED

[ClickHouse] Query Max Result RowsVariable

Advanced. Optional ClickHouse max_result_rows query setting.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_MAX__RESULT__ROWS

[ClickHouse] Query Max Bytes To ReadVariable

Advanced. Optional ClickHouse max_bytes_to_read query setting.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_MAX__BYTES__TO__READ

[ClickHouse] Ignored Data-Skipping IndicesVariable

Advanced. Optional comma-separated ClickHouse data-skipping indices to ignore for SigNoz queries. Leave blank for the upstream default.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_IGNORE__DATA__SKIPPING__INDICES

[ClickHouse] Secondary Index Bulk FilteringVariable

Advanced. Optional ClickHouse secondary index bulk filtering setting. Leave blank for the upstream default.

Target: SIGNOZ_TELEMETRYSTORE_CLICKHOUSE_SETTINGS_SECONDARY__INDICES__ENABLE__BULK__FILTERING

[Host Agent] Prometheus TargetsVariable

Advanced. Optional comma-separated Prometheus scrape targets for the built-in local host agent, for example: node-exporter:9100,cadvisor:8080.

Target: SIGNOZ_HOST_AGENT_PROMETHEUS_TARGETS

[Host Agent] Prometheus Metrics PathVariable

Advanced. Metrics path used for the built-in host agent's Prometheus scrape targets.

Target: SIGNOZ_HOST_AGENT_PROMETHEUS_METRICS_PATH
Default: /metrics
Value: /metrics

[Host Agent] Prometheus Scrape IntervalVariable

Advanced. Scrape interval used for Prometheus targets defined for the built-in host agent.

Target: SIGNOZ_HOST_AGENT_PROMETHEUS_SCRAPE_INTERVAL
Default: 30s
Value: 30s

[Collector] OTEL Resource AttributesVariable

Advanced OpenTelemetry resource attributes injected into the internal collector. Useful if you want a clearer default host or environment label.

Target: OTEL_RESOURCE_ATTRIBUTES
Default: host.name=signoz-host,os.type=linux
Value: host.name=signoz-host,os.type=linux

[Collector] Low Cardinal Exception GroupingVariable

Advanced upstream collector option for ClickHouse trace exception grouping. Leave at false unless you intentionally want the alternate grouping behavior.

Target: LOW_CARDINAL_EXCEPTION_GROUPING
Default: false|true
Value: false

[Collector] ClickHouse Base DSN OverrideVariable

Advanced. Optional collector-specific ClickHouse base DSN override. Leave blank to inherit the main ClickHouse base DSN.

Target: SIGNOZ_OTEL_COLLECTOR_CLICKHOUSE_DSN

[Collector] ClickHouse TimeoutVariable

Advanced timeout used by the internal SigNoz collector for ClickHouse operations and migrations.

Target: SIGNOZ_OTEL_COLLECTOR_TIMEOUT
Default: 10m
Value: 10m

[Collector] ClickHouse Cluster NameVariable

Advanced cluster name used by the SigNoz collector migrations. The official external ClickHouse setup requires the cluster name to remain cluster unless you know exactly what you are changing.

Target: SIGNOZ_OTEL_COLLECTOR_CLICKHOUSE_CLUSTER
Default: cluster
Value: cluster

[Collector] ClickHouse Replication ModeVariable

Advanced replication setting used by the SigNoz collector migrations.

Target: SIGNOZ_OTEL_COLLECTOR_CLICKHOUSE_REPLICATION
Default: false|true
Value: false

[Collector] Traces DSNVariable

Advanced. Optional collector DSN for traces database. Leave blank to derive from the base ClickHouse DSN.

Target: SIGNOZ_CLICKHOUSE_TRACES_DSN

[Collector] Metrics DSNVariable

Advanced. Optional collector DSN for metrics database. Leave blank to derive from the base ClickHouse DSN.

Target: SIGNOZ_CLICKHOUSE_METRICS_DSN

[Collector] Logs DSNVariable

Advanced. Optional collector DSN for logs database. Leave blank to derive from the base ClickHouse DSN.

Target: SIGNOZ_CLICKHOUSE_LOGS_DSN

[Collector] Meter DSNVariable

Advanced. Optional collector DSN for SigNoz meter database. Leave blank to derive from the base ClickHouse DSN.

Target: SIGNOZ_CLICKHOUSE_METER_DSN

[Collector] Metadata DSNVariable

Advanced. Optional collector DSN for telemetry metadata database. Leave blank to derive from the base ClickHouse DSN.

Target: SIGNOZ_CLICKHOUSE_METADATA_DSN

[Collector] Batch Send SizeVariable

Advanced. OTel collector batch send size for regular telemetry pipelines.

Target: SIGNOZ_OTEL_COLLECTOR_BATCH_SEND_SIZE
Default: 10000
Value: 10000

[Collector] Batch Max SizeVariable

Advanced. OTel collector maximum batch size for regular telemetry pipelines.

Target: SIGNOZ_OTEL_COLLECTOR_BATCH_SEND_MAX_SIZE
Default: 11000
Value: 11000

[Collector] Batch TimeoutVariable

Advanced. OTel collector batch timeout for regular telemetry pipelines.

Target: SIGNOZ_OTEL_COLLECTOR_BATCH_TIMEOUT
Default: 10s
Value: 10s

[Collector] Meter Batch Send SizeVariable

Advanced. OTel collector batch send size for SigNoz meter telemetry.

Target: SIGNOZ_OTEL_COLLECTOR_METER_BATCH_SEND_SIZE
Default: 20000
Value: 20000

[Collector] Meter Batch Max SizeVariable

Advanced. OTel collector maximum batch size for SigNoz meter telemetry.

Target: SIGNOZ_OTEL_COLLECTOR_METER_BATCH_SEND_MAX_SIZE
Default: 25000
Value: 25000

[Collector] Meter Batch TimeoutVariable

Advanced. OTel collector batch timeout for SigNoz meter telemetry.

Target: SIGNOZ_OTEL_COLLECTOR_METER_BATCH_TIMEOUT
Default: 1s
Value: 1s

[Collector] Self Metrics Scrape IntervalVariable

Advanced. Scrape interval for the collector's own Prometheus metrics.

Target: SIGNOZ_OTEL_COLLECTOR_SELF_SCRAPE_INTERVAL
Default: 60s
Value: 60s

[Collector] pprof EndpointVariable

Advanced. Internal collector pprof endpoint. This port is not published by the Unraid template.

Target: SIGNOZ_OTEL_COLLECTOR_PPROF_ENDPOINT
Default: 0.0.0.0:1777
Value: 0.0.0.0:1777

[SigNoz] Analytics EnabledVariable

Advanced. Enables upstream Segment analytics if a Segment key is configured. Leave false for homelab deployments.

Target: SIGNOZ_ANALYTICS_ENABLED
Default: false|true
Value: false

[SigNoz] Stats Reporter EnabledVariable

Advanced. Privacy default: disabled. Set true only if you want to enable upstream stats reporting internals.

Target: SIGNOZ_STATSREPORTER_ENABLED
Default: false|true
Value: false

[SigNoz] API Timeout DefaultVariable

Advanced. Default API request timeout.

Target: SIGNOZ_APISERVER_TIMEOUT_DEFAULT
Default: 60s
Value: 60s

[SigNoz] API Timeout MaxVariable

Advanced. Maximum API request timeout.

Target: SIGNOZ_APISERVER_TIMEOUT_MAX
Default: 600s
Value: 600s

[SigNoz] API Timeout Excluded RoutesVariable

Advanced. Comma-separated API routes excluded from request timeout handling.

Target: SIGNOZ_APISERVER_TIMEOUT_EXCLUDED__ROUTES
Default: /api/v1/logs/tail,/api/v3/logs/livetail,/api/v1/export_raw_data
Value: /api/v1/logs/tail,/api/v3/logs/livetail,/api/v1/export_raw_data

[SigNoz] API Logging Excluded RoutesVariable

Advanced. Comma-separated API routes excluded from request logging.

Target: SIGNOZ_APISERVER_LOGGING_EXCLUDED__ROUTES
Default: /api/v1/health,/api/v1/version,/
Value: /api/v1/health,/api/v1/version,/

[SigNoz] Querier Cache TTLVariable

Advanced. TTL for cached SigNoz query results.

Target: SIGNOZ_QUERIER_CACHE__TTL
Default: 168h
Value: 168h

[SigNoz] Querier Flux IntervalVariable

Advanced. Recent-data interval that SigNoz should not cache.

Target: SIGNOZ_QUERIER_FLUX__INTERVAL
Default: 5m
Value: 5m

[SigNoz] Querier Max Concurrent QueriesVariable

Advanced. Maximum concurrent SigNoz queries for missing ranges.

Target: SIGNOZ_QUERIER_MAX__CONCURRENT__QUERIES
Default: 4
Value: 4

[SigNoz] Prometheus Query TimeoutVariable

Advanced. Maximum time a PromQL query may run before SigNoz aborts it.

Target: SIGNOZ_PROMETHEUS_TIMEOUT
Default: 2m
Value: 2m

[SigNoz] Prometheus Active Query TrackerVariable

Advanced. Enables SigNoz Prometheus active query tracking.

Target: SIGNOZ_PROMETHEUS_ACTIVE__QUERY__TRACKER_ENABLED
Default: true|false
Value: true

[SigNoz] Prometheus Query Tracker PathVariable

Advanced. Optional path for SigNoz Prometheus active query tracking.

Target: SIGNOZ_PROMETHEUS_ACTIVE__QUERY__TRACKER_PATH

[SigNoz] Prometheus Max Concurrent QueriesVariable

Advanced. Maximum concurrent Prometheus queries tracked by SigNoz.

Target: SIGNOZ_PROMETHEUS_ACTIVE__QUERY__TRACKER_MAX__CONCURRENT
Default: 20
Value: 20

[SigNoz] pprof EnabledVariable

Advanced. Enables SigNoz internal pprof endpoint inside the container. The port is not published by default.

Target: SIGNOZ_PPROF_ENABLED
Default: true|false
Value: true

[SigNoz] pprof AddressVariable

Advanced. Internal SigNoz pprof bind address. Do not publish this unless you understand the exposure risk.

Target: SIGNOZ_PPROF_ADDRESS
Default: 0.0.0.0:6060
Value: 0.0.0.0:6060

[SigNoz] Ruler Eval DelayVariable

Advanced. Delay applied when evaluating alerting rules.

Target: SIGNOZ_RULER_EVAL__DELAY
Default: 2m
Value: 2m

[SigNoz] Alert Poll IntervalVariable

Advanced. Poll interval for syncing built-in SigNoz Alertmanager state from the metadata store.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_POLL__INTERVAL
Default: 1m
Value: 1m

[SigNoz] Alert Group By LabelsVariable

Advanced. Comma-separated labels used by the built-in SigNoz Alertmanager route grouping.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_ROUTE_GROUP__BY
Default: alertname
Value: alertname

[SigNoz] Alert Group IntervalVariable

Advanced. Interval at which grouped alerts are resent to receivers.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_ROUTE_GROUP__INTERVAL
Default: 1m
Value: 1m

[SigNoz] Alert Group WaitVariable

Advanced. Initial wait before sending a newly grouped alert.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_ROUTE_GROUP__WAIT
Default: 1m
Value: 1m

[SigNoz] Alert Repeat IntervalVariable

Advanced. Default repeat interval for the built-in SigNoz Alertmanager route.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_ROUTE_REPEAT__INTERVAL
Default: 4h
Value: 4h

[SigNoz] Alert Resolve TimeoutVariable

Advanced. Default global resolve timeout for the built-in SigNoz Alertmanager.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_RESOLVE__TIMEOUT
Default: 5m
Value: 5m

[SigNoz] Alert External URLVariable

Advanced. External URL used by alert notifications when SigNoz is behind a reverse proxy.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_EXTERNAL__URL

[SigNoz] Alert GC IntervalVariable

Advanced. Garbage collection interval for built-in Alertmanager alerts.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_ALERTS_GC__INTERVAL
Default: 30m
Value: 30m

[SigNoz] Alert Silences MaxVariable

Advanced. Maximum stored Alertmanager silences. Use 0 for no limit.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_SILENCES_MAX
Default: 0
Value: 0

[SigNoz] Alert Silences Max Size BytesVariable

Advanced. Maximum stored Alertmanager silences size in bytes. Use 0 for no limit.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_SILENCES_MAX__SIZE__BYTES
Default: 0
Value: 0

[SigNoz] Alert Silences Maintenance IntervalVariable

Advanced. Maintenance interval for Alertmanager silences snapshots.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_SILENCES_MAINTENANCE__INTERVAL
Default: 15m
Value: 15m

[SigNoz] Alert Silences RetentionVariable

Advanced. Retention duration for Alertmanager silences.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_SILENCES_RETENTION
Default: 120h
Value: 120h

[SigNoz] Alert Notification Log Maintenance IntervalVariable

Advanced. Maintenance interval for Alertmanager notification log snapshots.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_NFLOG_MAINTENANCE__INTERVAL
Default: 15m
Value: 15m

[SigNoz] Alert Notification Log RetentionVariable

Advanced. Retention duration for Alertmanager notification logs.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_NFLOG_RETENTION
Default: 120h
Value: 120h

[Alerts Email] SMTP FromVariable

Advanced. Sender address used by built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__FROM

[Alerts Email] SMTP HelloVariable

Advanced. HELO/EHLO hostname used by built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__HELLO
Default: localhost
Value: localhost

[Alerts Email] SMTP Smart HostVariable

Advanced. SMTP host:port used by built-in Alertmanager email notifications, for example smtp.example.com:587.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__SMARTHOST

[Alerts Email] SMTP UsernameVariable

Advanced. SMTP username used by built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__AUTH__USERNAME

[Alerts Email] SMTP PasswordVariable

Advanced. SMTP password used by built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__AUTH__PASSWORD

[Alerts Email] SMTP Password FileVariable

Advanced. Optional path inside the container to a file containing the SMTP password for built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__AUTH__PASSWORD_FILE

[Alerts Email] SMTP Auth SecretVariable

Advanced. Optional SMTP auth secret used by built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__AUTH__SECRET

[Alerts Email] SMTP Auth IdentityVariable

Advanced. Optional SMTP auth identity used by built-in Alertmanager email notifications.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__AUTH__IDENTITY

[Alerts Email] SMTP Require TLSVariable

Advanced. Requires TLS for built-in Alertmanager SMTP delivery. Set false only for trusted internal relays.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__REQUIRE__TLS
Default: true|false
Value: true

[Alerts Email] SMTP TLS CA FileVariable

Advanced. Optional CA certificate file path inside the container for Alertmanager SMTP TLS.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__CA__FILE

[Alerts Email] SMTP TLS Cert FileVariable

Advanced. Optional client certificate file path inside the container for Alertmanager SMTP TLS.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__CERT__FILE

[Alerts Email] SMTP TLS Key FileVariable

Advanced. Optional client private key file path inside the container for Alertmanager SMTP TLS.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__KEY__FILE

[Alerts Email] SMTP TLS Server NameVariable

Advanced. Optional server name for SNI and SMTP TLS certificate verification.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__SERVER__NAME

[Alerts Email] SMTP TLS Skip VerifyVariable

Advanced. Skips SMTP TLS certificate verification for built-in Alertmanager email notifications. Use only for trusted internal relays.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__CONFIG_INSECURE__SKIP__VERIFY
Default: false|true
Value: false

[Alerts Email] SMTP TLS Min VersionVariable

Advanced. Optional minimum SMTP TLS version for built-in Alertmanager notifications. Leave upstream to keep the SigNoz default.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__MIN__VERSION
Default: upstream|TLS12|TLS13
Value: upstream

[Alerts Email] SMTP TLS Max VersionVariable

Advanced. Optional maximum SMTP TLS version for built-in Alertmanager notifications. Leave upstream to keep the SigNoz default.

Target: SIGNOZ_ALERTMANAGER_SIGNOZ_GLOBAL_SMTP__TLS__MAX__VERSION
Default: upstream|TLS12|TLS13
Value: upstream

[SigNoz] Metrics Explorer ThreadsVariable

Advanced. ClickHouse query threads used by Metrics Explorer.

Target: SIGNOZ_METRICSEXPLORER_TELEMETRYSTORE_THREADS
Default: 8
Value: 8

[SigNoz] Analytics Segment KeyVariable

Advanced. Segment key used only when upstream analytics are enabled.

Target: SIGNOZ_ANALYTICS_SEGMENT_KEY

[SigNoz] Stats Reporter IntervalVariable

Advanced. Interval for upstream stats reporter collection when enabled.

Target: SIGNOZ_STATSREPORTER_INTERVAL
Default: 6h
Value: 6h

[SigNoz] Stats Reporter Collect IdentitiesVariable

Advanced. Privacy default: disabled. Set true only if stats reporting is enabled and you accept upstream identity and trait collection.

Target: SIGNOZ_STATSREPORTER_COLLECT_IDENTITIES
Default: false|true
Value: false

[Email] EnabledVariable

Advanced. Enables SigNoz email delivery through SMTP. When true, set a valid SMTP from address.

Target: SIGNOZ_EMAILING_ENABLED
Default: false|true
Value: false

[Email] SMTP AddressVariable

Advanced. SMTP server host:port for SigNoz emails.

Target: SIGNOZ_EMAILING_SMTP_ADDRESS
Default: localhost:25
Value: localhost:25

[Email] From AddressVariable

Advanced. From address for SigNoz emails.

Target: SIGNOZ_EMAILING_SMTP_FROM

[Email] SMTP HelloVariable

Advanced. Optional SMTP HELO/EHLO hostname sent by SigNoz.

Target: SIGNOZ_EMAILING_SMTP_HELLO

[Email] SMTP UsernameVariable

Advanced. SMTP username.

Target: SIGNOZ_EMAILING_SMTP_AUTH_USERNAME

[Email] SMTP PasswordVariable

Advanced. SMTP password.

Target: SIGNOZ_EMAILING_SMTP_AUTH_PASSWORD

[Email] SMTP Auth SecretVariable

Advanced. Optional SMTP auth secret for mechanisms that require it.

Target: SIGNOZ_EMAILING_SMTP_AUTH_SECRET

[Email] SMTP Auth IdentityVariable

Advanced. Optional SMTP auth identity for mechanisms that require it.

Target: SIGNOZ_EMAILING_SMTP_AUTH_IDENTITY

[Email] SMTP TLS EnabledVariable

Advanced. Enables TLS for SMTP.

Target: SIGNOZ_EMAILING_SMTP_TLS_ENABLED
Default: false|true
Value: false

[Email] SMTP TLS Skip VerifyVariable

Advanced. Skips SMTP TLS certificate verification. Use only for trusted internal mail relays.

Target: SIGNOZ_EMAILING_SMTP_TLS_INSECURE__SKIP__VERIFY
Default: false|true
Value: false

[Email] SMTP TLS CA FileVariable

Advanced. Optional CA certificate path inside the container for SMTP TLS.

Target: SIGNOZ_EMAILING_SMTP_TLS_CA__FILE__PATH

[Email] SMTP TLS Cert FileVariable

Advanced. Optional client certificate path inside the container for SMTP TLS.

Target: SIGNOZ_EMAILING_SMTP_TLS_CERT__FILE__PATH

[Email] SMTP TLS Key FileVariable

Advanced. Optional client private key path inside the container for SMTP TLS.

Target: SIGNOZ_EMAILING_SMTP_TLS_KEY__FILE__PATH

[Email] Template Header EnabledVariable

Advanced. Enables a custom header block in SigNoz email templates.

Target: SIGNOZ_EMAILING_TEMPLATES_FORMAT_HEADER_ENABLED
Default: false|true
Value: false

[Email] Template Header Logo URLVariable

Advanced. Logo URL used in SigNoz email template headers when enabled.

Target: SIGNOZ_EMAILING_TEMPLATES_FORMAT_HEADER_LOGO__URL

[Email] Template Help EnabledVariable

Advanced. Enables help contact text in SigNoz email templates.

Target: SIGNOZ_EMAILING_TEMPLATES_FORMAT_HELP_ENABLED
Default: false|true
Value: false

[Email] Template Help EmailVariable

Advanced. Help email address shown in SigNoz email templates when enabled.

Target: SIGNOZ_EMAILING_TEMPLATES_FORMAT_HELP_EMAIL

[Email] Template Footer EnabledVariable

Advanced. Enables a footer block in SigNoz email templates.

Target: SIGNOZ_EMAILING_TEMPLATES_FORMAT_FOOTER_ENABLED
Default: false|true
Value: false

[Cache] ProviderVariable

Advanced. SigNoz cache provider. Leave memory for the self-contained default; set redis only when using an external Redis cache.

Target: SIGNOZ_CACHE_PROVIDER
Default: memory|redis
Value: memory

[Cache] Memory CountersVariable

Advanced. Number of Ristretto in-memory cache counters.

Target: SIGNOZ_CACHE_MEMORY_NUM__COUNTERS
Default: 100000
Value: 100000

[Cache] Memory Max CostVariable

Advanced. Ristretto in-memory cache max cost in bytes.

Target: SIGNOZ_CACHE_MEMORY_MAX__COST
Default: 134217728
Value: 134217728

[Cache] Redis HostVariable

Advanced. External Redis host when SIGNOZ_CACHE_PROVIDER=redis.

Target: SIGNOZ_CACHE_REDIS_HOST

[Cache] Redis PortVariable

Advanced. External Redis port.

Target: SIGNOZ_CACHE_REDIS_PORT
Default: 6379
Value: 6379

[Cache] Redis DBVariable

Advanced. External Redis database number.

Target: SIGNOZ_CACHE_REDIS_DB
Default: 0
Value: 0

[Cache] Redis PasswordVariable

Advanced. External Redis password.

Target: SIGNOZ_CACHE_REDIS_PASSWORD

[Feature] Use Span MetricsVariable

Advanced. Optional upstream feature flag override for span metrics. Leave upstream to keep the SigNoz default.

Target: SIGNOZ_FLAGGER_CONFIG_BOOLEAN_USE__SPAN__METRICS
Default: upstream|true|false
Value: upstream

[Feature] Kafka Span EvalVariable

Advanced. Optional upstream feature flag override for Kafka span evaluation. Leave upstream to keep the SigNoz default.

Target: SIGNOZ_FLAGGER_CONFIG_BOOLEAN_KAFKA__SPAN__EVAL
Default: upstream|true|false
Value: upstream

[Identity] Tokenizer Auth EnabledVariable

Advanced. Enables tokenizer-based identity resolution for SigNoz requests.

Target: SIGNOZ_IDENTN_TOKENIZER_ENABLED
Default: true|false
Value: true

[Identity] Tokenizer HeadersVariable

Advanced. Comma-separated headers used for tokenizer identity resolution.

Target: SIGNOZ_IDENTN_TOKENIZER_HEADERS
Default: Authorization,Sec-WebSocket-Protocol
Value: Authorization,Sec-WebSocket-Protocol

[Identity] API Key Auth EnabledVariable

Advanced. Enables API-key identity resolution for SigNoz requests.

Target: SIGNOZ_IDENTN_APIKEY_ENABLED
Default: true|false
Value: true

[Identity] API Key HeadersVariable

Advanced. Comma-separated headers used for API-key identity resolution.

Target: SIGNOZ_IDENTN_APIKEY_HEADERS
Default: SIGNOZ-API-KEY
Value: SIGNOZ-API-KEY

[Identity] Root Impersonation EnabledVariable

Advanced and dangerous. Impersonates the root user for all requests when enabled; leave false unless upstream support explicitly directs you to use it.

Target: SIGNOZ_IDENTN_IMPERSONATION_ENABLED
Default: false|true
Value: false

[Service Account] Email DomainVariable

Advanced. Email domain used for SigNoz service account principals.

Target: SIGNOZ_SERVICEACCOUNT_EMAIL_DOMAIN
Default: signozserviceaccount.com
Value: signozserviceaccount.com

[Service Account] Analytics EnabledVariable

Advanced. Privacy default: disabled. Set true only if you want upstream service-account analytics behavior.

Target: SIGNOZ_SERVICEACCOUNT_ANALYTICS_ENABLED
Default: false|true
Value: false

[Gateway] URLVariable

Advanced. SigNoz gateway API URL for deployments that use licensed gateway features.

Target: SIGNOZ_GATEWAY_URL
Default: http://localhost:8080
Value: http://localhost:8080

[Auditor] ProviderVariable

Advanced. Audit event provider. Leave noop for community defaults; otlphttp exports audit events to an OTLP HTTP endpoint.

Target: SIGNOZ_AUDITOR_PROVIDER
Default: noop|otlphttp
Value: noop

[Auditor] Buffer SizeVariable

Advanced. Async audit event channel capacity.

Target: SIGNOZ_AUDITOR_BUFFER__SIZE
Default: 1000
Value: 1000

[Auditor] Batch SizeVariable

Advanced. Maximum audit events per export batch.

Target: SIGNOZ_AUDITOR_BATCH__SIZE
Default: 100
Value: 100

[Auditor] Flush IntervalVariable

Advanced. Maximum time between audit export flushes.

Target: SIGNOZ_AUDITOR_FLUSH__INTERVAL
Default: 1s
Value: 1s

[Auditor] OTLP HTTP EndpointVariable

Advanced. OTLP HTTP log endpoint used when the auditor provider is otlphttp.

Target: SIGNOZ_AUDITOR_OTLPHTTP_ENDPOINT
Default: http://localhost:4318/v1/logs
Value: http://localhost:4318/v1/logs

[Auditor] OTLP HTTP InsecureVariable

Advanced. Uses HTTP instead of HTTPS for auditor OTLP HTTP export.

Target: SIGNOZ_AUDITOR_OTLPHTTP_INSECURE
Default: false|true
Value: false

[Auditor] OTLP HTTP TimeoutVariable

Advanced. Timeout for auditor OTLP HTTP export attempts.

Target: SIGNOZ_AUDITOR_OTLPHTTP_TIMEOUT
Default: 10s
Value: 10s

[Auditor] Retry EnabledVariable

Advanced. Enables retry for transient auditor OTLP HTTP export failures.

Target: SIGNOZ_AUDITOR_OTLPHTTP_RETRY_ENABLED
Default: true|false
Value: true

[Auditor] Retry Initial IntervalVariable

Advanced. Initial auditor retry wait time.

Target: SIGNOZ_AUDITOR_OTLPHTTP_RETRY_INITIAL__INTERVAL
Default: 5s
Value: 5s

[Auditor] Retry Max IntervalVariable

Advanced. Maximum auditor retry backoff interval.

Target: SIGNOZ_AUDITOR_OTLPHTTP_RETRY_MAX__INTERVAL
Default: 30s
Value: 30s

[Auditor] Retry Max Elapsed TimeVariable

Advanced. Maximum total auditor retry time before giving up.

Target: SIGNOZ_AUDITOR_OTLPHTTP_RETRY_MAX__ELAPSED__TIME
Default: 60s
Value: 60s

[Cloud Integration] Agent VersionVariable

Advanced. Upstream cloud integration agent version used by SigNoz-managed cloud integration flows.

Target: SIGNOZ_CLOUDINTEGRATION_AGENT_VERSION
Default: v0.0.8
Value: v0.0.8

[ZooKeeper] Auto-Purge IntervalVariable

Advanced internal housekeeping interval in hours for ZooKeeper snapshot and log cleanup. The default matches the official SigNoz Docker deployment.

Target: ZOO_AUTOPURGE_INTERVAL
Default: 1
Value: 1

[ZooKeeper] Prometheus Metrics EnabledVariable

Advanced. Enables ZooKeeper Prometheus metrics inside the container.

Target: ZOO_ENABLE_PROMETHEUS_METRICS
Default: yes|no
Value: yes

[ZooKeeper] Prometheus Metrics PortVariable

Advanced. Internal ZooKeeper Prometheus metrics port. This port is not published by the Unraid template.

Target: ZOO_PROMETHEUS_METRICS_PORT_NUMBER
Default: 9141
Value: 9141

Links

Template Support Docker Hub Project

Details

Repository

jsonbored/signoz-aio:latest

Registry

https://hub.docker.com/r/jsonbored/signoz-aio

Last Updated2026-05-28

First Seen2026-05-01

Run signoz-aio on Unraid.

signoz-aio is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS