docs: ipns ttl change
Marcin Rataj committed
Mar 14, 2025 at 19:57 UTC
180f6224e341f3e8932d49c9368ef564e64fc411
1 file changed
+10
docs/changelogs/v0.34.md
+10
@@ -10,6 +10,7 @@
10
- [New WebUI features](#new-webui-features)
11
- [RPC and CLI command changes](#rpc-and-cli-command-changes)
12
- [Bitswap improvements from Boxo](#bitswap-improvements-from-boxo)
13
+ - [IPNS publishing TTL change](#ipns-publishing-ttl-change)
14
- [`IPFS_LOG_LEVEL` deprecated](#ipfs_log_level-deprecated)
15
- [Pebble datastore format update](#pebble-datastore-format-update)
16
- [Badger datastore update](#badger-datastore-update)
@@ -60,6 +61,15 @@ The WebUI, accessible at http://127.0.0.1:5001/webui/, now includes support for
61
62
This release includes performance and reliability improvements and fixes for minor resource leaks. One of the performance changes [greatly improves the bitswap clients ability to operate under high load](https://github.com/ipfs/boxo/pull/817#pullrequestreview-2587207745), that could previously result in an out of memory condition.
63
64
+#### IPNS publishing TTL change
65
+
66
+Many complaints about IPNS being slow are tied to the default `--ttl` in `ipfs name publish`, which was set to 1 hour. To address this, we’ve lowered the default [IPNS Record TTL](https://specs.ipfs.tech/ipns/ipns-record/#ttl-uint64) during publishing to 5 minutes, matching similar TTL defaults in DNS. This update is now part of `boxo/ipfs` (GO, [boxo#859](https://github.com/ipfs/boxo/pull/859)) and `@helia/ipns` (JS, [helia#749](https://github.com/ipfs/helia/pull/749)).
67
+
68
+> [!TIP]
69
+> IPNS TTL recommendations when even faster update propagation is desired:
70
+> - **As a Publisher:** Lower the `--ttl` (e.g., `ipfs name publish --ttl=1m`) to further reduce caching delays. If using DNSLink, ensure the DNS TXT record TTL matches the IPNS record TTL.
71
+> - **As a Gateway Operator:** Override publisher TTLs for faster updates using configurations like [`Ipns.MaxCacheTTL`](https://github.com/ipfs/kubo/blob/master/docs/config.md#ipnsmaxcachettl) in Kubo or [`RAINBOW_IPNS_MAX_CACHE_TTL`](https://github.com/ipfs/rainbow/blob/main/docs/environment-variables.md#rainbow_ipns_max_cache_ttl) in [Rainbow](https://github.com/ipfs/rainbow/).
72
+
73
#### `IPFS_LOG_LEVEL` deprecated
74
75
The variable has been deprecated. Please use [`GOLOG_LOG_LEVEL`](https://github.com/ipfs/kubo/blob/master/docs/environment-variables.md#golog_log_level) instead for configuring logging levels.