Configuration

tidecoind reads tidecoin.conf from the data directory on startup; options there can also be supplied as command-line flags. Typical minimal configuration: pick a chain (mainnet default, testnet, or regtest), set RPC credentials (cookie auth is the default), and enable the V2 post-quantum transport (v2transport=1 is the default).

Scope: This page covers common operator-facing configuration. For the full option catalog, see Reference / Config Reference. For safe RPC exposure, see RPC Security.

Config location

Platform	Default data directory	Config path
Linux	`~/.tidecoin`	`~/.tidecoin/tidecoin.conf`
macOS	`~/Library/Application Support/Tidecoin`	`~/Library/Application Support/Tidecoin/tidecoin.conf`
Windows	`%APPDATA%\Tidecoin`	`%APPDATA%\Tidecoin\tidecoin.conf`

Override the data directory with -datadir=<path>. Override the config path with -conf=<file> on the command line.

Minimal mainnet node


# tidecoin.conf
server=1
daemon=1
 
# Keep JSON-RPC local by default.
rpcbind=127.0.0.1
 
# V2 transport is enabled by default; keep it explicit for operators.
v2transport=1

This uses cookie authentication for local tidecoin-cli access. The cookie is stored in the network-specific data directory and is readable by the node user by default.

Infrastructure node without wallet

Use this for explorers, indexers, monitoring nodes, and service backends that do not need local wallet private keys:


server=1
daemon=1
disablewallet=1
txindex=1
blockfilterindex=basic
coinstatsindex=1
v2transport=1

Do not enable pruning on a node that needs txindex=1.

Pruned personal node

Use pruning only when disk space matters and you do not need full historical block files or txindex:


server=1
daemon=1
prune=550
v2transport=1

Changing from pruned mode back to unpruned mode requires re-downloading the chain.

Testnet and regtest

Run testnet from the command line:


tidecoind -testnet -daemon

Or configure a testnet section:


server=1
daemon=1
 
[test]
rpcport=17585

Run regtest for local application testing:


tidecoind -regtest -daemon
tidecoin-cli -regtest getblockchaininfo

Ports

Network	P2P port	RPC port
Mainnet	8755	7585
Testnet	18755	17585
Regtest	18778	17595

Open the P2P port if you want inbound peers. Do not open the RPC port to the public internet.

Wallet options

Option	Use
`wallet=<path>`	Load an existing wallet on startup. Can be repeated.
`walletdir=<dir>`	Set the wallet directory.
`disablewallet=1`	Disable wallet loading and wallet RPCs.
`walletbroadcast=1`	Let the wallet broadcast transactions. Default is enabled.
`addresstype=bech32`	Default address type. `bech32pq` is also recognized by the node.
`changetype=<type>`	Set change output type when needed.

Check Activation Status before using address or scheme choices that depend on post-AuxPoW activation.

Common pitfalls

rpcbind does not safely expose RPC by itself. Pair any non-local bind with rpcallowip, strong authentication, and firewall rules.
rpcuser / rpcpassword is legacy-style static credential configuration. Prefer cookie auth for local use and rpcauth for service users.
txindex=1 and pruning are incompatible.
settings.json is runtime-managed. Put persistent operator config in tidecoin.conf.
Wallet backups are separate from node data backups. Never delete wallets/ during node maintenance.