Skip to content

tari config

Manages the project configuration file, tari.config.toml.

Terminal window
tari config <SUBCOMMAND>

Creates a tari.config.toml with defaults in the project root (or the git repository root). Does nothing if the file already exists.

Terminal window
tari config init

Sets a configuration value.

Terminal window
tari config set <KEY> <VALUE>
Terminal window
tari config set default-network localnet
tari config set default-account myaccount
tari config set networks.localnet.metadata-server-url http://localhost:3000/
tari config set networks.esmeralda.metadata-server-url https://ootle.tari.com/community-templates

Prints a single configuration value.

Terminal window
tari config get default-network

Prints the full configuration file.

Terminal window
tari config show

The active network is resolved first, then per-setting values are read from that network’s section.

Active network, highest priority first: --network → project default-network → global default-network → esmeralda.

Per-setting, highest priority first:

SettingCLI flagProject configGlobal configDefault
Wallet daemon URL--wallet-daemon-url or TARI_WALLET_DAEMON_URL— (ignored, with a warning)networks.<active>.wallet-daemon-urlhttp://127.0.0.1:5100/json_rpc
Metadata server URL--metadata-server-urlnetworks.<active>.metadata-server-urlnetworks.<active>.metadata-server-urlesmeralda → https://ootle.tari.com/community-templates, localnet → http://localhost:3000/, others → none
Template address--template-addressnetworks.<active>.template-address——
Account--accountdefault-accountdefault-accountWallet daemon default
Wallet daemon API key--api-key— never stored in config— never stored in configTARI_WALLET_DAEMON_API_KEY