Skip to content

Commit

Permalink
docs: add security limits to node-running guide (#4700)
Browse files Browse the repository at this point in the history
## Describe your changes

## Issue ticket number and link

## Checklist before requesting a review

- [x] If this code contains consensus-breaking changes, I have added the
"consensus-breaking" label. Otherwise, I declare my belief that there
are not consensus-breaking changes, for the following reason:

  > docs-only

Co-authored-by: Conor Schaefer <[email protected]>
Co-authored-by: Erwan Or <[email protected]>
  • Loading branch information
3 people authored Jul 5, 2024
1 parent ceae1e0 commit be7adec
Showing 1 changed file with 38 additions and 0 deletions.
38 changes: 38 additions & 0 deletions docs/guide/src/node/pd/requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,44 @@ the `--grpc-auto-https <DOMAIN>` option. See `pd start --help` for more info.
Validators should review the [pcli key custody](../../pcli/wallet.md#validator-custody) recommendations
for protecting the validator identity.

## CometBFT settings

When bootstrapping a new network connection via [`pd network join`](join-network.md),
`pd` will create initial CometBFT settings for the node. Node operators
should review that configuration, stored at `~/.penumbra/network_data/node0/cometbft/config/config.toml`
by default, and adapt it to their needs.

In particular, node operators should ensure that the following values are set:

```toml
[mempool]
broadcast = true
keep-invalid-txs-in-cache = false
max_tx_bytes = 98304
max_txs_bytes = 10485760
recheck = true
size = 5000

[consensus]
timeout_propose = "3000ms"
timeout_propose_delta = "500ms"
timeout_prevote = "1000ms"
timeout_prevote_delta = "500ms"
timeout_precommit = "1000ms"
timeout_precommit_delta = "500ms"
timeout_commit = "5000ms"
create_empty_blocks = true
create_empty_blocks_interval = "0ms"
```

The `mempool` settings are consensus-critical, and should not be changed without coordination.

## Security limits

The OS defaults for maximum number of open file descriptors is typically `1024`, which is too low
for running a Penumbra node. The example systemd configs raise this value to `65536` via the `LimitNOFILE`
declaration. Node operators should set this value system-wide, by editing `/etc/security/limits.conf`.

## Deployment strategies

We expect node operators to manage the lifecycle of their Penumbra deployments.
Expand Down

0 comments on commit be7adec

Please sign in to comment.