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
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
fix: use quic.Version instead of the deprecated quic.VersionNumber (#2955) (libp2p/go-libp2p#2955)
libp2p.direct<img src="https://github.com/user-attachments/assets/51af045b-eff7-414f-b52b-0d1f222d74a3" width="300px" />
This release introduces an experimental feature that significantly improves how browsers (Helia, Service Worker) can connect to Kubo node.
Opt-in configuration allows a publicly dialable Kubo nodes (public IP, port forwarding, or NAT with uPnP) to obtain CA-signed TLS certificates for libp2p Secure WebSocket (WSS) connections automatically.
[!TIP] To enable this feature, set
AutoTLS.Enabledtotrueand add a listener for/tls/sni/*.libp2p.direct/wson a separate TCP port:{ + "AutoTLS": { "Enabled": true }, "Addresses": { "Swarm": { "/ip4/0.0.0.0/tcp/4001", + "/ip4/0.0.0.0/tcp/4002/tls/sni/*.libp2p.direct/ws", "/ip6/::/tcp/4001", + "/ip6/::/tcp/4002/tls/sni/*.libp2p.direct/ws",After restarting your node for the first time you may need to wait 5-15 minutes to pass all checks and for the changes to take effect. We are working on sharing the same TCP port with other transports (go-libp2p#2984).
See AutoTLS configuration for more details how to enable it and what to expect.
This is an early preview, we appreciate you testing and filling bug reports or feedback in the tracking issue at kubo#10560.
ipfs-webui to v4.4.0boxo to v0.24.1 + v0.24.2 + v0.24.3
go-libp2p to v0.37.0
Swarm.RelayService.MaxReservationsPerPeer configuration option from Kubo. If you had it set, remove it from your configuration file.go-libp2p-kad-dht to v0.27.0 + v0.28.0 + v0.28.1go-libp2p-pubsub to v0.12.0p2p-forge/client to v0.0.2go-homedir
github.com/mitchellh/go-homedir repo is archived, no longer needed, and no longer maintained.homedir.Dir is replaced by the stdlib os.UserHomeDirhomedir.Expand is replaced by fsutil.ExpandHome in the github.com/ipfs/kubo/misc/fsutil package.github.com/ipfs/kubo/misc/fsutil package contains file utility code previously located elsewhere in kubo.<details><summary>Full Changelog</summary>
queryPeer (#996) (libp2p/go-libp2p-kad-dht#996)Ihave messages (#560) (libp2p/go-libp2p-pubsub#560)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Marco Munizaga | 16 | +4253/-545 | 81 |
| Pop Chunhapanya | 1 | +1423/-137 | 15 |
| sukun | 10 | +752/-425 | 35 |
| Steven Allen | 11 | +518/-541 | 35 |
| Andrew Gillis | 19 | +348/-194 | 50 |
| Marcin Rataj | 26 | +343/-132 | 47 |
| Adin Schmahmann | 4 | +269/-29 | 12 |
| gammazero | 12 | +154/-18 | 13 |
| Josh Klopfenstein | 1 | +90/-35 | 27 |
| galargh | 3 | +42/-44 | 13 |
| Daniel Norman | 2 | +30/-16 | 4 |
| Mikel Cortes | 3 | +25/-4 | 4 |
| gopherfarm | 1 | +14/-14 | 6 |
| Carlos Peliciari | 1 | +12/-12 | 4 |
| Prithvi Shahi | 2 | +5/-11 | 3 |
| web3-bot | 6 | +12/-3 | 6 |
| guillaumemichel | 3 | +7/-6 | 3 |
| Jorropo | 1 | +11/-0 | 1 |
| Sorin Stanculeanu | 1 | +8/-0 | 1 |
| Hlib Kanunnikov | 2 | +6/-2 | 4 |
| André Bierlein | 1 | +4/-3 | 1 |
| bytetigers | 1 | +1/-1 | 1 |
| Wondertan | 2 | +2/-0 | 2 |
| Alexandr Burdiyan | 1 | +1/-1 | 1 |
| Guillaume Michel | 1 | +0/-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
deprecate DumpObject() in favor of better named Encode()
Pebble provides a high-performance alternative to leveldb as the datastore, and provides a modern replacement for legacy badgerv1.
A fresh Kubo node can be initialized with pebbleds profile via ipfs init --profile pebbleds.
There are a number of parameters available for tuning pebble's performance to your specific needs. Default values are used for any parameters that are not configured or are set to their zero-value. For a description of the available tuning parameters, see kubo/docs/datastores.md#pebbleds.
go_gc_gogc_percent, go_gc_gomemlimit_bytes and go_sched_gomaxprocs_threads as those are recommended by the Go teamprocess_network_receive_bytes_total and process_network_transmit_bytes_totalgo_memstat_lookups_total metric which was always 0lowpower profile no longer breaks DHT announcementsWe've notices users were applying lowpower profile, and then reporting content routing issues. This was because lowpower disabled reprovider system and locally hosted data was no longer announced on Amino DHT.
This release changes lowpower profile to not change reprovider settings, ensuring the new users are not sabotaging themselves. It also adds annouce-on and announce-off profiles for controlling announcement settings separately.
[!IMPORTANT] If you've ever applied the
lowpowerprofile before, there is a high chance your node is not announcing to DHT anymore. If you haveReprovider.Intervalset to0you may want to set it to22h(or runipfs config profile apply announce-on) to fix your system.As a convenience,
ipfs daemonwill warn if reprovide system is disabled, creating oportinity to fix configuration if it was not intentional.
Various bugfixes. Please update.
<details><summary>Full Changelog</summary>
car ls --unixfs-blocks to render two-column output (ipld/go-car#514)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Will Scott | 3 | +731/-581 | 14 |
| Daniel N | 17 | +1034/-191 | 33 |
| Marco Munizaga | 5 | +721/-404 | 12 |
| Andrew Gillis | 9 | +765/-266 | 35 |
| Marcin Rataj | 17 | +568/-323 | 41 |
| Daniel Norman | 3 | +232/-111 | 10 |
| sukun | 4 | +93/-8 | 8 |
| Jorropo | 2 | +48/-45 | 5 |
| Marten Seemann | 3 | +19/-47 | 5 |
| fengzie | 1 | +29/-26 | 5 |
| Rod Vagg | 7 | +27/-11 | 9 |
| gopherfarm | 1 | +14/-14 | 6 |
| web3-bot | 3 | +13/-10 | 3 |
| Michael Muré | 2 | +16/-5 | 4 |
| i-norden | 1 | +9/-9 | 1 |
| Elias Rad | 1 | +7/-7 | 4 |
| Prithvi Shahi | 1 | +0/-11 | 2 |
| Lucas Molas | 1 | +5/-4 | 1 |
| elecbug | 1 | +6/-2 | 1 |
| gammazero | 2 | +2/-2 | 2 |
| chris erway | 1 | +2/-2 | 2 |
| Russell Dempsey | 1 | +2/-1 | 1 |
| guillaumemichel | 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
Nothing published for this version
Nothing published for this version
Nothing published for this version
Refactored Bitswap and dag-pb chunker
ipfs version check/unix/ socket support in Addresses.APIipfs daemon Startup LogThis release took longer and is more packed with fixes and features than usual.
[!IMPORTANT] TLDR: update, it contains many, many fixes.
This release comes with significant go-libp2p update from v0.34.1 to v0.36.3 (release notes).
It includes multiple fixes to key protocols: QUIC/Webtransport/WebRTC, Connection Upgrades through Relay (DCUtR), and Secure WebSockets.
Also, peers that are behind certain types of NAT will now be more reachable. For this alone, Kubo users are highly encouraged to upgrade.
Some workloads may experience improved memory profile thanks to optimizations from Boxo SDK v0.23.0.
[!IMPORTANT] Storage providers should upgrade to take advantage of the Bitswap server fix, which resolves the issue of greedy peers depleting available wantlist slots for their PeerID, resulting in stalled downloads.
Kubo now ships with WebRTC Direct listener enabled by default: /udp/4001/webrtc-direct.
WebRTC Direct complements existing /wss (Secure WebSockets) and /webtransport transports. Unlike /wss, which requires a domain name and a CA-issued TLS certificate, WebRTC Direct works with IPs and can be enabled by default on all Kubo nodes.
Learn more: Swarm.Transports.Network.WebRTCDirect
[!NOTE] Kubo 0.30 includes a migration for existing users that adds
/webrtc-directlistener on the same UDP port as/udp/{port}/quic-v1. This supports the WebRTC-Direct rollout by reusing preexisting UDP firewall settings and port mappings created for QUIC.
Kubo now allows users to opt-in to store mode and modification time for files, directories, and symbolic links. By default, if you do not opt-in, the old behavior remains unchanged, and the same CIDs will be generated as before.
The ipfs add CLI options --preserve-mode and --preserve-mtime can be used to store the original mode and last modified time of the file being added, and ipfs files stat /ipfs/CID can be used for inspecting these optional attributes:
$ touch ./file
$ chmod 654 ./file
$ ipfs add --preserve-mode --preserve-mtime -Q ./file
QmczQr4XS1rRnWVopyg5Chr9EQ7JKpbhgnrjpb5kTQ1DKQ
$ ipfs files stat /ipfs/QmczQr4XS1rRnWVopyg5Chr9EQ7JKpbhgnrjpb5kTQ1DKQ
QmczQr4XS1rRnWVopyg5Chr9EQ7JKpbhgnrjpb5kTQ1DKQ
Size: 0
CumulativeSize: 22
ChildBlocks: 0
Type: file
Mode: -rw-r-xr-- (0654)
Mtime: 13 Aug 2024, 21:15:31 UTC
The CLI and HTTP RPC options --mode, --mtime and --mtime-nsecs can be used to set them to arbitrary values.
Opt-in support for mode and mtime was also added to MFS (ipfs files --help). For more information see --help text of ipfs files touch|stat|chmod commands.
Modification time support was also added to the Gateway. If present, value from file's dag-pb is returned in Last-Modified HTTP header and requests made with If-Modified-Since can produce HTTP 304 not modified response.
[!NOTE] Storing
modeandmtimerequires root block to bedag-pband disabledraw-leavessetting to create envelope for storing the metadata.
The AutoNAT service enables nodes to determine their public reachability on the internet. AutoNAT V2 enhances this protocol with improved features. In this release, Kubo will offer both V1 and V2 services to other peers, although it will continue to use only V1 when acting as a client. Future releases will phase out V1, transitioning clients to utilize V2 exclusively.
For more details, see the Deployment Plan for AutoNAT V2 and AutoNAT configuration options.
ipfs version checkKubo now performs privacy-preserving version checks using the libp2p identify protocol on peers detected by the Amino DHT client. If more than 5% of Kubo peers seen by your node are running a newer version, you will receive a log message notification.
ipfs version check --help for details.Version.SwarmCheckEnabled to false.Defining the optional agent version suffix is now simpler. The Version.AgentSuffix value from the Kubo config takes precedence over any value provided via ipfs daemon --agent-version-suffix (which is still supported).
[!NOTE] Setting a custom version suffix helps with ecosystem analysis, such as Amino DHT reports published at https://stats.ipfs.network
/unix/ socket support in Addresses.APIThis release fixes a bug which blocked users from using Unix domain sockets for Kubo's RPC (instead of a local HTTP port).
$ ipfs config Addresses.API "/unix/tmp/kubo.socket"
$ ipfs daemon # start with rpc socket
...
RPC API server listening on /unix/tmp/kubo.socket
$ # cli client, in different terminal can find socket via /api file
$ cat $IPFS_PATH/api
/unix/tmp/kubo.socket
$ # or have it passed via --api
$ ipfs --api=/unix/tmp/kubo.socket id
ipfs daemon Startup LogThe ipfs daemon startup output has been streamlined to enhance clarity and usability:
$ ipfs daemon
Initializing daemon...
Kubo version: 0.30.0
Repo version: 16
System version: amd64/linux
Golang version: go1.22.5
PeerID: 12D3KooWQ73s1CQsm4jWwQvdCAtc5w8LatyQt7QLQARk5xdhK9CE
Swarm listening on 127.0.0.1:4001 (TCP+UDP)
Swarm listening on 192.0.2.10:4001 (TCP+UDP)
Swarm listening on [::1]:4001 (TCP+UDP)
Swarm listening on [2001:0db8::10]:4001 (TCP+UDP)
Run 'ipfs id' to inspect announced and discovered multiaddrs of this node.
RPC API server listening on /ip4/127.0.0.1/tcp/5001
WebUI: http://127.0.0.1:5001/webui
Gateway server listening on /ip4/127.0.0.1/tcp/8080
Daemon is ready
The previous lengthy listing of all listener and announced multiaddrs has been removed due to its complexity, especially with modern libp2p nodes sharing multiple transports and long lists of /webtransport and /webrtc-direct certhashes.
The output now features a simplified list of swarm listeners, displayed in the format host:port (TCP+UDP), which provides essential information for debugging connectivity issues, particularly related to port forwarding.
Announced libp2p addresses are no longer printed on startup, because libp2p may change or augment them based on AutoNAT, relay, and UPnP state. Instead, users are prompted to run ipfs id to obtain up-to-date list of listeners and announced multiaddrs in libp2p format.
When executing a CLI command over Kubo RPC API, if a hostname is specified by --api=/dns4/<domain>/ the resulting HTTP request now contains the hostname, instead of the the IP address that the hostname resolved to, as was the previous behavior. This makes it easier for those trying to run Kubo behind a reverse proxy using hostname-based rules.
When executing a CLI command over Kubo RPC API, if a hostname is specified by --api=/dns4/<domain>/ the resulting HTTP request now contains the hostname, instead of the the IP address that the hostname resolved to, as was the previous behavior. This makes it easier for those trying to run Kubo behind a reverse proxy using hostname-based rules.
<details><summary>Full Changelog</summary>
/http-path (#2850) (libp2p/go-libp2p#2850)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Andrew Gillis | 14 | +4920/-1714 | 145 |
| sukun | 26 | +4402/-448 | 79 |
| Marco Munizaga | 32 | +2287/-536 | 73 |
| Marcin Rataj | 41 | +685/-193 | 86 |
| Patryk | 1 | +312/-10 | 8 |
| guillaumemichel | 7 | +134/-105 | 14 |
| Adin Schmahmann | 5 | +145/-80 | 9 |
| Henrique Dias | 2 | +190/-1 | 6 |
| Josh Klopfenstein | 1 | +90/-35 | 27 |
| gammazero | 5 | +90/-28 | 11 |
| Jeromy Johnson | 1 | +116/-0 | 5 |
| Daniel N | 3 | +27/-25 | 9 |
| Daniel Norman | 2 | +28/-19 | 4 |
| Ivan Shvedunov | 2 | +25/-10 | 2 |
| Michael Muré | 2 | +22/-9 | 4 |
| Dominic Della Valle | 1 | +23/-4 | 1 |
| Andrei Vukolov | 1 | +27/-0 | 1 |
| chris erway | 1 | +9/-9 | 9 |
| Vitaly Zdanevich | 1 | +12/-0 | 1 |
| Guillaume Michel | 1 | +4/-7 | 1 |
| swedneck | 1 | +10/-0 | 1 |
| Jorropo | 2 | +5/-5 | 3 |
| omahs | 1 | +4/-4 | 4 |
| THAT ONE GUY | 1 | +3/-5 | 2 |
| vyzo | 1 | +5/-2 | 1 |
| looklose | 1 | +3/-3 | 2 |
| web3-bot | 2 | +2/-3 | 4 |
| Dave Huseby | 1 | +5/-0 | 1 |
| shenpengfeng | 1 | +1/-1 | 1 |
| bytetigers | 1 | +1/-1 | 1 |
| Sorin Stanculeanu | 1 | +1/-1 | 1 |
| Lukáš Lukáč | 1 | +1/-1 | 1 |
| Gabe | 1 | +1/-1 | 1 |
| Bryan Stenson | 1 | +1/-1 | 1 |
| Samy Fodil | 1 | +1/-0 | 1 |
| Lane Rettig | 1 | +1/-0 | 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
One column per quarter.