z3/.env.example at dev · ZcashFoundation/z3 · 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
# Z3 Stack — Environment Variable Overrides
#
# All defaults are in docker-compose.yml. This file is OPTIONAL.
# Create .env and uncomment only the variables you want to override.
#
# Quick reference — switching networks:
#
#   Mainnet (default): docker compose up -d
#   Testnet:           create .env with NETWORK_NAME=Testnet
#   Regtest:           docker compose --env-file .env.regtest up -d
#
#   Variable                             Mainnet   Testnet   Regtest
#   ─────────────────────────────────────────────────────────────────
#   NETWORK_NAME                         Mainnet   Testnet   Regtest
#   ENABLE_COOKIE_AUTH                   true      true      false
#   ZEBRA_HEALTH__MIN_CONNECTED_PEERS    1         1         0
#

# =============================================================================
# Network
# =============================================================================
# NETWORK_NAME=Mainnet
# ENABLE_COOKIE_AUTH=true
# ZEBRA_HEALTH__MIN_CONNECTED_PEERS=1

# =============================================================================
# Platform (ARM64 users: uncomment for native builds)
# =============================================================================
# DOCKER_PLATFORM=linux/arm64

# =============================================================================
# Image Overrides (defaults are pinned versions in docker-compose.yml)
# =============================================================================
# ZEBRA_IMAGE=zfnd/zebra:4.3.0
# ZAINO_IMAGE=ghcr.io/zcashfoundation/zaino:sha-83e41d7
# ZALLET_IMAGE=electriccoinco/zallet:v0.1.0-alpha.3
# ZEBRA_BUILD_FEATURES=default-release-binaries

# =============================================================================
# Data Paths (default: Docker named volumes)
# =============================================================================
# Z3_ZEBRA_DATA_PATH=zebra_data
# Z3_ZAINO_DATA_PATH=zaino_data
# Z3_ZALLET_DATA_PATH=zallet_data
# Z3_COOKIE_PATH=shared_cookie_volume

# =============================================================================
# Port Mappings
# =============================================================================
# Z3_ZEBRA_HOST_RPC_PORT=18232
# Z3_ZEBRA_HOST_HEALTH_PORT=8080
# ZAINO_HOST_GRPC_PORT=8137
# ZAINO_HOST_JSONRPC_PORT=8237
# ZALLET_HOST_RPC_PORT=28232

# =============================================================================
# Internal Container Ports (change only for advanced multi-instance setups)
# Note: internal ports must also match bind addresses in config/*.toml files
# =============================================================================
# Z3_ZEBRA_RPC_PORT=18232
# ZAINO_GRPC_PORT=8137
# ZAINO_JSON_RPC_PORT=8237
# ZALLET_RPC_PORT=28232

# =============================================================================
# Log Levels
# =============================================================================
# Z3_ZEBRA_RUST_LOG=info
# ZEBRA_TRACING__FILTER=info
# ZAINO_RUST_LOG=info,reqwest=warn,hyper_util=warn
# ZAINO_RUST_BACKTRACE=full
# ZALLET_RUST_LOG=info,hyper_util=warn,reqwest=warn

# =============================================================================
# Monitoring (enable with: docker compose --profile monitoring up -d)
# =============================================================================
# ZEBRA_METRICS__ENDPOINT_ADDR=0.0.0.0:9999
# GRAFANA_PORT=3000
# GRAFANA_ADMIN_PASSWORD=admin
# PROMETHEUS_PORT=9094
# JAEGER_UI_PORT=16686
# ALERTMANAGER_PORT=9093
# JAEGER_OTLP_GRPC_PORT=4317
# JAEGER_OTLP_HTTP_PORT=4318
# JAEGER_SPANMETRICS_PORT=8889
#
# OpenTelemetry tracing (requires Zebra built with opentelemetry feature):
#   docker compose build --build-arg FEATURES="default-release-binaries opentelemetry" zebra
# ZEBRA_TRACING__OPENTELEMETRY_ENDPOINT=http://jaeger:4318
# ZEBRA_TRACING__OPENTELEMETRY_SERVICE_NAME=zebra
# ZEBRA_TRACING__OPENTELEMETRY_SAMPLE_PERCENT=100