2018-10-30 15:51:59 +00:00
|
|
|
---
|
|
|
|
title: Monero Configuration File | Monero Documentation
|
|
|
|
---
|
|
|
|
# Monero Configuration File
|
|
|
|
|
|
|
|
## Applicability
|
|
|
|
|
2018-10-31 13:48:43 +00:00
|
|
|
By default Monero looks for `bitmonero.conf` in Monero [data directory](/interacting/overview/#data-directory).
|
2018-10-30 15:51:59 +00:00
|
|
|
|
2018-10-31 13:48:43 +00:00
|
|
|
To use a specific config file add `--config-file` option:
|
2018-10-30 15:51:59 +00:00
|
|
|
|
2019-02-21 11:47:22 +00:00
|
|
|
`./monerod --config-file=/etc/monerod.conf`
|
2018-10-30 15:51:59 +00:00
|
|
|
|
|
|
|
The `--config-file` option is available for:
|
|
|
|
|
|
|
|
* `monerod`
|
|
|
|
* `monero-wallet-cli`
|
|
|
|
* `monero-wallet-rpc`
|
|
|
|
* `monero-gen-trusted-multisig`
|
|
|
|
|
|
|
|
## Syntax
|
|
|
|
|
|
|
|
* `option-name=value`
|
|
|
|
* `valueless-option-name=1` for options that don't expect value
|
2019-02-21 11:47:22 +00:00
|
|
|
* `# comment`
|
2018-10-30 15:51:59 +00:00
|
|
|
* whitespace is ignored
|
|
|
|
|
|
|
|
## Reference
|
|
|
|
|
|
|
|
All command line options work as configuration file options. See [monerod reference](/interacting/monerod-reference).
|
|
|
|
|
|
|
|
Skip the `--` from `--option-name`.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
`./monerod --log-level=4 --stagenet`
|
|
|
|
|
|
|
|
translates to:
|
|
|
|
|
|
|
|
log-level=4
|
2019-02-21 11:47:22 +00:00
|
|
|
stagenet=1 # use value "1" to enable the value-less options like --stagenet
|
2018-10-30 15:51:59 +00:00
|
|
|
|
|
|
|
## Example
|
|
|
|
|
2019-02-21 11:47:22 +00:00
|
|
|
# /etc/monerod.conf
|
2018-10-30 15:51:59 +00:00
|
|
|
|
|
|
|
# Data directory (blockchain db and indices)
|
|
|
|
data-dir=/home/monero/.monero
|
|
|
|
|
|
|
|
# Log file
|
2019-02-21 11:47:22 +00:00
|
|
|
log-file=/var/log/monero/monerod.log
|
2018-10-31 20:23:56 +00:00
|
|
|
max-log-file-size=0 # Prevent monerod from managing the log files; we want logrotate to take care of that
|
2018-10-30 15:51:59 +00:00
|
|
|
|
|
|
|
# P2P full node
|
|
|
|
p2p-bind-ip=0.0.0.0 # Bind to all interfaces (the default)
|
|
|
|
p2p-bind-port=18080 # Bind to default port
|
|
|
|
|
|
|
|
# RPC open node
|
|
|
|
rpc-bind-ip=0.0.0.0 # Bind to all interfaces
|
|
|
|
rpc-bind-port=18081 # Bind on default port
|
|
|
|
confirm-external-bind=1 # Open node (confirm)
|
|
|
|
restricted-rpc=1 # Prevent unsafe RPC calls
|
|
|
|
no-igd=1 # Disable UPnP port mapping
|
|
|
|
|
|
|
|
# Slow but reliable db writes
|
|
|
|
db-sync-mode=safe
|
|
|
|
|
|
|
|
# Emergency checkpoints set by MoneroPulse operators will be enforced to workaround potential consensus bugs
|
|
|
|
# Check https://monerodocs.org/infrastructure/monero-pulse/ for explanation and trade-offs
|
|
|
|
enforce-dns-checkpointing=1
|
|
|
|
|
|
|
|
out-peers=64 # This will enable much faster sync and tx awareness; the default 8 is suboptimal nowadays
|
|
|
|
in-peers=1024 # The default is unlimited; we prefer to put a cap on this
|
|
|
|
|
|
|
|
limit-rate-up=1048576 # 1048576 kB/s == 1GB/s; a raise from default 2048 kB/s; contribute more to p2p network
|
|
|
|
limit-rate-down=1048576 # 1048576 kB/s == 1GB/s; a raise from default 8192 kB/s; allow for faster initial sync
|