NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #191 by repository stars
Latest stable
v0.43.1
Last release 1 months ago
27 Sep 2026
Ships on a steady schedule
a new release about every 1 weeks
Some releases are documented
notes for 32 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
1383 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Deprecated the bitswap reprovide command. Make sure to switch to modern routing reprovide.
<a href="http://ipshipyard.com/"><img align="right" src="https://github.com/user-attachments/assets/39ed3504-bb71-47f6-9bf8-cb9a1698f272" /></a>
This release was brought to you by the Shipyard team.
IPFS_LOG_LEVEL deprecatedStarting now, any publicly dialable Kubo node with a /tcp listener that remains online for at least one hour will receive a TLS certificate through the AutoTLS feature.
This occurs automatically, with no need for manual setup.
To bypass the 1-hour delay and enable AutoTLS immediately, users can explicitly opt-in by running the following commands:
$ ipfs config --json AutoTLS.Enabled true
$ ipfs config --json AutoTLS.RegistrationDelay 0
AutoTLS will remain disabled under the following conditions:
/ws (WebSocket) listenerswarm.key/tcp listenerTo troubleshoot, use GOLOG_LOG_LEVEL="error,autotls=info.
For more details, check out the AutoTLS configuration documentation or dive deeper with AutoTLS libp2p blog post.
The WebUI, accessible at http://127.0.0.1:5001/webui/, now includes support for CAR file import and QR code sharing directly from the Files view. Additionally, the Peers screen has been updated with the latest ipfs-geoip dataset.
ipfs config is now validating json fields (#10679).bitswap reprovide command. Make sure to switch to modern routing reprovide. (#10677)stats reprovide command now shows additional stats for Routing.AcceleratedDHTClient, indicating the last and next reprovide times. (#10677)ipfs files cp now performs basic codec check and will error when source is not a valid UnixFS (only dag-pb and raw codecs are allowed in MFS)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, that could previously result in an out of memory condition.
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 during publishing to 5 minutes, matching similar TTL defaults in DNS. This update is now part of boxo/ipfs (GO, boxo#859) and @helia/ipns (JS, helia#749).
[!TIP] IPNS TTL recommendations when even faster update propagation is desired:
- 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.- As a Gateway Operator: Override publisher TTLs for faster updates using configurations like
Ipns.MaxCacheTTLin Kubo orRAINBOW_IPNS_MAX_CACHE_TTLin Rainbow.
IPFS_LOG_LEVEL deprecatedThe variable has been deprecated. Please use GOLOG_LOG_LEVEL instead for configuring logging levels.
If the pebble database format is not explicitly set in the config, then automatically upgrade it to the latest format version supported by the release ob pebble used by kubo. This will ensure that the database format is sufficiently up-to-date to be compatible with a major version upgrade of pebble. This is necessary before upgrading to use pebble v2.
An update was made to the badger v1 datastore that avoids use of mmap in 32-bit environments, which has been seen to cause issues on some platforms. Please be aware that this could lead to a performance regression for users of badger in a 32-bit environment. Badger users are advised to move to the flatds or pebble datastore.
The go-ds-xxx datastore implementations have been updated to support the updated go-datastore v0.8.2 query API. This update removes the datastore implementations' dependency on goprocess and updates the query API.
Kubo previously depended on multiple multi-error packages, github.com/hashicorp/go-multierror and go.uber.org/multierr. These have nearly identical functionality so there was no need to use both. Therefore, go.uber.org/multierr was selected as the package to depend on. Any future code needing multi-error functionality should use go.uber.org/multierr to avoid introducing unneeded dependencies.
The reprovide process can be quite slow. In default settings, the reprovide process will start reading CIDs that belong to the pinset. During this operation, starvation can occur for other operations that need pinset access (see https://github.com/ipfs/kubo/issues/10596).
We have now switch to buffering pinset-related cids that are going to be reprovided in memory, so that we can free pinset mutexes as soon as possible so that pinset-writes and subsequent read operations can proceed. The downside is larger pinsets will need some extra memory, with an estimation of ~1GiB of RAM memory-use per 20 million items to be reprovided.
Use Reprovider.Strategy to balance announcement prioritization, speed, and memory utilization.
go-libp2p to v0.41.0 (incl. v0.40.0)go-libp2p-kad-dht to v0.30.2 (incl. v0.29.0, v0.29.1, v0.29.2, v0.30.0, v0.30.1)boxo to v0.29.1 (incl. v0.28.0 v0.29.0)ipfs-webui to v4.6.0 (incl. v4.5.0)p2p-forge/client to v0.4.0go-datastore to v0.8.2 (incl. v0.7.0, v0.8.0)<details><summary>Full Changelog</summary>
files cp (#10701) (ipfs/kubo#10701)bitswap reprovide (#10699) (ipfs/kubo#10699)DefaultRecordTTL to 5m (#859) (ipfs/boxo#859)ipld/merkledag from gogo protobuf (#841) (ipfs/boxo#841)ipld/unixfs from gogo protobuf (#840) (ipfs/boxo#840)extAddr (#3140) (libp2p/go-libp2p#3140)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Hector Sanjuan | 100 | +4777/-1495 | 200 |
| Marco Munizaga | 22 | +3482/-1632 | 122 |
| Andrew Gillis | 69 | +1628/-1509 | 191 |
| sukun | 13 | +1240/-288 | 67 |
| Simon Menke | 7 | +766/-97 | 16 |
| Guillaume Michel | 33 | +438/-383 | 62 |
| Marcin Rataj | 24 | +494/-266 | 47 |
| Sergey Gorbunov | 4 | +384/-103 | 20 |
| AvyChanna | 1 | +294/-193 | 9 |
| gammazero | 22 | +208/-217 | 28 |
| Dennis Trautwein | 3 | +425/-0 | 8 |
| web3-bot | 18 | +193/-184 | 46 |
| Steven Allen | 8 | +204/-82 | 13 |
| Marten Seemann | 5 | +215/-63 | 11 |
| Daniel Norman | 2 | +225/-0 | 6 |
| Abhinav Prakash | 1 | +190/-2 | 4 |
| guillaumemichel | 3 | +93/-56 | 15 |
| youyyytrok | 1 | +84/-63 | 29 |
| Nishant Das | 2 | +111/-1 | 4 |
| Pop Chunhapanya | 1 | +109/-0 | 2 |
| Michael Muré | 7 | +78/-29 | 15 |
| Jorropo | 4 | +53/-20 | 7 |
| Ryan Skidmore | 1 | +62/-0 | 2 |
| GITSRC | 1 | +44/-0 | 3 |
| Russell Dempsey | 1 | +22/-17 | 10 |
| Adin Schmahmann | 2 | +29/-8 | 3 |
| Gabriel Cruz | 1 | +13/-13 | 1 |
| Wlynxg | 3 | +12/-9 | 3 |
| Khaled Yakdan | 1 | +11/-10 | 1 |
| Yahya Hassanzadeh, Ph.D. | 1 | +17/-0 | 1 |
| Can ZHANG | 2 | +15/-2 | 3 |
| Pavel Zbitskiy | 1 | +13/-1 | 2 |
| Yuttakhan B. | 1 | +6/-6 | 6 |
| Hlib Kanunnikov | 2 | +9/-2 | 4 |
| Petar Maymounkov | 1 | +7/-2 | 1 |
| Prithvi Shahi | 2 | +8/-0 | 2 |
| Piotr Galar | 1 | +4/-4 | 2 |
| Michael Vorburger | 1 | +6/-0 | 1 |
| Gus Eggert | 2 | +6/-0 | 2 |
| Raúl Kripalani | 1 | +4/-0 | 1 |
| linchizhen | 1 | +1/-1 | 1 |
| achingbrain | 1 | +1/-1 | 1 |
| Rod Vagg | 1 | +1/-1 | 1 |
| Ian Davis | 1 | +1/-1 | 1 |
| Fabio Bozzo | 1 | +1/-1 | 1 |
go-libp2p to v0.41.1
quic-go to v0.50.1Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
chore: Update dependencies and fix deprecated function in relay example (#3023) (libp2p/go-libp2p#3023)
libp2p_rcmgr metricssync on each writeipfs add --to-files no longer works with --wrapipfs --api supports HTTPS RPC endpointsWriteThrough, BlockKeyCacheSize, BatchMaxNodes, BatchMaxSizeKubo now supports sharing the same TCP port (4001 by default) by both raw TCP and WebSockets libp2p transports.
This feature is not yet compatible with Private Networks and can be disabled by setting LIBP2P_TCP_MUX=false if causes any issues.
It is no longer necessary to manually add /tcp/../ws listeners to Addresses.Swarm when AutoTLS.Enabled is set to true. Kubo will detect if /ws listener is missing and add one on the same port as pre-existing TCP (e.g. /tcp/4001), removing the need for any extra configuration.
[!TIP] Give it a try:
$ ipfs config --json AutoTLS.Enabled trueAnd restart the node. If you are behind NAT, make sure your node is publicly diallable (uPnP or port forwarding), and wait a few minutes to pass all checks and for the changes to take effect.
See AutoTLS for more information.
This release includes some refactorings and improvements affecting Bitswap which should improve reliability. One of the changes affects blocks providing. Previously, the bitswap layer took care itself of announcing new blocks -added or received- with the configured provider (i.e. DHT). This bypassed the "Reprovider", that is, the system that manages precisely "providing" the blocks stored by Kubo. The Reprovider knows how to take advantage of the AcceleratedDHTClient, is able to handle priorities, logs statistics and is able to resume on daemon reboot where it left off. From now on, Bitswap will not be doing any providing on-the-side and all announcements are managed by the reprovider. In some cases, when the reproviding queue is full with other elements, this may cause additional delays, but more likely this will result in improved block-providing behaviour overall.
libp2p_rcmgr metricsBespoke rcmgr metrics were removed, Kubo now exposes only the default libp2p_rcmgr metrics from go-libp2p.
This makes it easier to compare Kubo with custom implementations based on go-libp2p.
If you depended on removed ones, please fill an issue to add them to the upstream go-libp2p.
sync on each writeNew repositories initialized with flatfs in Datastore.Spec will have sync set to false.
The old default was overly conservative and caused performance issues in big repositories that did a lot of writes. There is usually no need to flush on every block write to disk before continuing. Setting this to false is safe as kubo will automatically flush writes to disk before and after performing critical operations like pinning. However, we still provide users with ability to set this to true to be extra-safe (at the cost of a slowdown when adding files in bulk).
ipfs add --to-files no longer works with --wrapOnboarding files and directories with ipfs add --to-files now requires non-empty names. due to this, The --to-files and --wrap options are now mutually exclusive (#10612).
ipfs --api supports HTTPS RPC endpointsCLI and RPC client now supports accessing Kubo RPC over https:// protocol when multiaddr ending with /https or /tls/http is passed to ipfs --api:
$ ipfs id --api /dns/kubo-rpc.example.net/tcp/5001/tls/http
# → https://kubo-rpc.example.net:5001
WriteThrough, BlockKeyCacheSize, BatchMaxNodes, BatchMaxSizeNow that Kubo supports pebble as an experimental datastore backend, it becomes very useful to expose some additional configuration options for how the blockservice/blockstore/datastore combo behaves.
Usually, LSM-tree based datastore like Pebble or Badger have very fast write performance (blocks are streamed to disk) while incurring in read-amplification penalties (blocks need to be looked up in the index to know where they are on disk), specially noticeable on spinning disks.
Prior to this version, BlockService and Blockstore implementations performed a Has(cid) for every block that was going to be written, skipping the writes altogether if the block was already present in the datastore. The performance impact of this Has() call can vary. The Datastore implementation itself might include block-caching and things like bloom-filters to speed up lookups and mitigate read-penalties. Our Blockstore implementation also supports a bloom-filter (controlled by BloomFilterSize and disabled by default), and a two-queue cache for keys and block sizes. If we assume that most of the blocks added to Kubo are new blocks, not already present in the datastore, or that the datastore itself includes mechanisms to optimize writes and avoid writing the same data twice, the calls to Has() at both BlockService and Blockstore layers seem superfluous to they point they even harm write performance.
For these reasons, from now on, the default is to use a "write-through" mode for the Blockservice and the Blockstore. We have added a new option Datastore.WriteThrough, which defaults to true. Previous behaviour can be obtained by manually setting it to false.
We have also made the size of the two-queue blockstore cache configurable with another option: Datastore.BlockKeyCacheSize, which defaults to 65536 (64KiB). Additionally, this caching layer can be disabled altogether by setting it to 0. In particular, this option controls the size of a blockstore caching layer that records whether the blockstore has certain block and their sizes (but does not cache the contents, so it stays relativey small in general).
Finally, we have added two new options to the Import section to control the maximum size of write-batches: BatchMaxNodes and BatchMaxSize. These are set by default to 128 nodes and 20MiB. Increasing them will batch more items together when importing data with ipfs dag import, which can speed things up. It is importance to find a balance between available memory (used to hold the batch), disk latencies (when writing the batch) and processing power (when preparing the batch, as nodes are sorted and duplicates removed).
As a reminder, details from all the options are explained in the configuration documentation.
We recommend users trying Pebble as a datastore backend to disable both blockstore bloom-filter and key caching layers and enable write through as a way to evaluate the raw performance of the underlying datastore, which includes its own bloom-filter and caching layers (default cache size is 8MiB and can be configured in the options.
We have fixed a number of issues that were triggered by writing or copying many files onto an MFS folder: increased memory usage first, then CPU, disk usage, and eventually a deadlock on write operations. The details of the fixes can be read at #10630 and #10623. The result is that writing large amounts of files to an MFS folder should now be possible without major issues. It is possible, as before, to speed up the operations using the ipfs files --flush=false <op> ... flag, but it is recommended to switch to ipfs files --flush=true <op> ... regularly, or call ipfs files flush on the working directory regularly, as this will flush, clear the directory cache and speed up reads.
.eth TLD DNSLinks are now resolved via DNS-over-HTTPS endpoint at https://dns.eth.limo/dns-query.crypto TLD DNSLinks are now resolved via DoH endpoint at https://resolver.unstoppable.io/dns-queryTwo fixes in go-libp2p improve the reliability of the WebRTC Direct listener in Kubo, and by extension dialability from browsers.
Relevant changes in go-libp2p:
This release includes performance and reliability improvements and fixes for minor resource leaks.
boxo to v0.27.4 (incl. v0.25.0 + v0.26.0 + v0.27.0 + v0.27.1 + v0.27.2 + v0.27.3)go-libp2p to v0.38.2 (incl. v0.37.1 + v0.37.2 + v0.38.0 + v0.38.1)go-libp2p-kad-dht to v0.28.2quic-go to v0.49.0p2p-forge/client to v0.3.0 (incl. v0.1.0, v0.2.0, v0.2.1, v0.2.2)ipfs-webui to v4.4.2 (incl. v4.4.1)When navigating to a subdirectory, served by the Kubo web server, a subdirectory without a trailing slash gets redirected to a URL with a trailing slash. If there are special characters such as "%" in the subdirectory name then these must be escaped in the redirect URL. Previously this was not being done and was preventing navigation to such subdirectories, requiring the user to manually add a trailing slash to the subdirectory URL. This is now fixed to handle the redirect to URLs with characters that must be escaped.
<details><summary>Full Changelog v0.33.0</summary>
go_package for protobuf, rename to a more unique ipns-record.proto (ipfs/boxo#789)WriteThrough(enabled bool) (ipfs/boxo#749)Ls to take results channel instead of returning one (#738) (ipfs/boxo#738)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Andrew Gillis | 57 | +1995/-1718 | 191 |
| Adin Schmahmann | 7 | +2552/-719 | 84 |
| Marco Munizaga | 27 | +1036/-261 | 51 |
| Hector Sanjuan | 21 | +789/-362 | 65 |
| gammazero | 20 | +407/-419 | 40 |
| sukun | 13 | +519/-233 | 30 |
| Marcin Rataj | 34 | +426/-142 | 59 |
| Marten Seemann | 2 | +11/-261 | 5 |
| Dreamacro | 2 | +161/-68 | 5 |
| Hlib Kanunnikov | 1 | +34/-65 | 4 |
| bashkarev | 1 | +78/-5 | 2 |
| Daniel Norman | 4 | +68/-12 | 6 |
| Andi | 1 | +37/-32 | 20 |
| hannahhoward | 1 | +35/-17 | 7 |
| Carlos Peliciari | 2 | +19/-26 | 2 |
| Cole Brown | 1 | +32/-0 | 3 |
| Will Scott | 2 | +19/-7 | 3 |
| Guillaume Michel | 1 | +21/-2 | 4 |
| 7sunarni | 1 | +3/-19 | 1 |
| Srdjan S | 1 | +11/-2 | 2 |
| web3-bot | 2 | +6/-6 | 3 |
| dashangcun | 1 | +2/-10 | 1 |
| John | 3 | +6/-6 | 5 |
| Daniel N | 3 | +8/-3 | 3 |
| Ivan Shvedunov | 1 | +4/-6 | 2 |
| Piotr Galar | 1 | +4/-4 | 2 |
| Derek Nola | 2 | +4/-4 | 4 |
| Bryer | 1 | +4/-4 | 1 |
| Prithvi Shahi | 2 | +6/-1 | 2 |
| Cameron Wood | 1 | +7/-0 | 1 |
| wangjingcun | 1 | +3/-3 | 2 |
| cuibuwei | 1 | +2/-2 | 2 |
| Jorropo | 1 | +1/-3 | 1 |
| 未月 | 1 | +1/-1 | 1 |
| Ubuntu | 1 | +1/-1 | 1 |
| Ryan MacArthur | 1 | +1/-1 | 1 |
| Reymon | 1 | +1/-1 | 1 |
| guillaumemichel | 1 | +1/-0 | 1 |
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, that could previously result in an out of memory condition.
Improved compatibility with third-party IPNS publishers by restoring support for compact binary CIDs in the Value field of IPNS Records (IPNS Specs). As long the signature is valid, Kubo will now resolve such records (likely created by non-Kubo nodes) and convert raw CIDs into valid /ipfs/cid content paths.
Note: This only adds support for resolving externally created records—Kubo’s IPNS record creation remains unchanged. IPNS records with empty Value fields default to zero-length /ipfs/bafkqaaa to maintain backward compatibility with code expecting a valid content path.
<details><summary>Full Changelog v0.33.1</summary>
</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Dreamacro | 1 | +304/-376 | 119 |
| Andrew Gillis | 7 | +306/-200 | 20 |
| Guillaume Michel | 5 | +122/-98 | 14 |
| Marcin Rataj | 2 | +113/-7 | 4 |
| gammazero | 6 | +41/-11 | 6 |
| Sergey Gorbunov | 1 | +14/-2 | 2 |
| Daniel Norman | 1 | +9/-0 | 1 |
go-libp2p to v0.38.3<details><summary>Full Changelog</summary>
</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| sukun | 1 | +122/-23 | 7 |
| Marcin Rataj | 1 | +1/-1 | 1 |
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.