Configuration

NodeDB is configured via nodedb.toml. Environment variables take precedence.

[server]
host = "127.0.0.1"
data_dir = "/var/lib/nodedb"
memory_limit = "4GiB"
data_plane_cores = 4
max_connections = 1024
log_format = "text"

[server.ports]
native = 6433
pgwire = 6432
http = 6480
resp = 6381          # optional
ilp = 8086           # optional

[server.tls]
cert_path = "/etc/nodedb/tls/server.crt"
key_path = "/etc/nodedb/tls/server.key"

Environment Variables

Config fieldEnv varDefault
hostNODEDB_HOST127.0.0.1
ports.pgwireNODEDB_PORT_PGWIRE6432
ports.nativeNODEDB_PORT_NATIVE6433
ports.httpNODEDB_PORT_HTTP6480
ports.respNODEDB_PORT_RESPdisabled
ports.ilpNODEDB_PORT_ILPdisabled
data_dirNODEDB_DATA_DIR~/.local/share/nodedb
memory_limitNODEDB_MEMORY_LIMIT1GiB
data_plane_coresNODEDB_DATA_PLANE_CORESCPUs - 1
max_connectionsNODEDB_MAX_CONNECTIONS4096
log_formatNODEDB_LOG_FORMATtext

Audit Configuration

[audit]
level = "standard"   # minimal, standard, full, forensic

Auth Configuration

[auth.jwt]
providers = [
    { issuer = "https://your-domain.auth0.com/", audience = "your-api" },
]

TLS per Protocol

[server.tls]
native = true
pgwire = true
http = true
resp = true
ilp = false
View page sourceLast updated on Apr 18, 2026 by Farhan Syah