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
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: revert removal of LevelFromString to avoid breaking change (#174) (ipfs/go-log#174)
<a href="https://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 files write fixesKubo 0.38.0 simplifies content announcement configuration, introduces an experimental sweeping DHT provider for efficient large-scale operations, and includes various performance improvements.
This release migrates the repository from version 17 to version 18, simplifying how you configure content announcements.
The old Provider and Reprovider sections are now combined into a single Provide section. Your existing settings are automatically migrated - no manual changes needed.
Migration happens automatically when you run ipfs daemon --migrate. For manual migration: ipfs repo migrate --to=18.
Read more about the new system below.
A new experimental DHT provider is available as an alternative to both the default provider and the resource-intensive accelerated DHT client. Enable it via Provide.DHT.SweepEnabled.
How it works: Instead of providing keys one-by-one, the sweep provider systematically explores DHT keyspace regions in batches.
<picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/f6e06b08-7fee-490c-a681-1bf440e16e27"> <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/e1662d7c-f1be-4275-a9ed-f2752fcdcabe"> <img alt="Reprovide Cycle Comparison" src="https://github.com/user-attachments/assets/e1662d7c-f1be-4275-a9ed-f2752fcdcabe"> </picture>
The diagram shows how sweep mode avoids the hourly traffic spikes of Accelerated DHT while maintaining similar effectiveness. By grouping CIDs into keyspace regions and processing them in batches, sweep mode reduces memory overhead and creates predictable network patterns.
Benefits for large-scale operations: Handles hundreds of thousands of CIDs with reduced memory and network connections, spreads operations evenly to eliminate resource spikes, maintains state across restarts through persistent keystore, and provides better metrics visibility.
Monitoring and debugging: Legacy mode (SweepEnabled=false) tracks provider_reprovider_provide_count and provider_reprovider_reprovide_count, while sweep mode (SweepEnabled=true) tracks total_provide_count_total. Enable debug logging with GOLOG_LOG_LEVEL=error,provider=debug,dht/provider=debug to see detailed logs from either system.
[!IMPORTANT] The metric
total_provide_count_totalwas renamed toprovider_provides_totalin Kubo v0.39 to follow OpenTelemetry naming conventions. If you have dashboards or alerts monitoring this metric, update them accordingly.
[!NOTE] This feature is experimental and opt-in. In the future, it will become the default and replace the legacy system. Some commands like
ipfs stats provideandipfs routing provideare not yet available with sweep mode. Runipfs provide --helpfor alternatives.
For configuration details, see Provide.DHT. For metrics documentation, see Provide metrics.
Kubo now exposes DHT metrics from go-libp2p-kad-dht, including total_provide_count_total for sweep provider operations and RPC metrics prefixed with rpc_inbound_ and rpc_outbound_ for DHT message traffic. See Kubo metrics documentation for details.
[!IMPORTANT] The metric
total_provide_count_totalwas renamed toprovider_provides_totalin Kubo v0.39 to follow OpenTelemetry naming conventions. If you have dashboards or alerts monitoring this metric, update them accordingly.
Gateway error pages now provide more actionable information during content retrieval failures. When a 504 Gateway Timeout occurs, users see detailed retrieval state information including which phase failed and a sample of providers that were attempted:
Gateway.DiagnosticServiceURL(default:https://check.ipfs.network): Configures the diagnostic service URL. When set, 504 errors show a "Check CID retrievability" button that links to this service with?cid=<failed-cid>for external diagnostics. Set to empty string to disable.- Enhanced error details: Timeout errors now display the retrieval phase where failure occurred (e.g., "connecting to providers", "fetching data") and up to 3 peer IDs that were attempted but couldn't deliver the content, making it easier to diagnose network or provider issues.
- Retry button on all error pages: Every gateway error page now includes a retry button for quick page refresh without manual URL re-entry.
The Web UI has been updated to v4.9 with a new Diagnostics screen for troubleshooting and system monitoring. Access it at http://127.0.0.1:5001/webui when running your local IPFS node.
| Diagnostics: Logs | Files: Check Retrieval | Diagnostics: Retrieval Results |
|---|---|---|
| Debug issues in real-time by adjusting log level without restart (global or per-subsystem like bitswap) | Check if content is available to other peers directly from Files screen | Find out why content won't load or who is providing it to the network |
| Peers: Agent Versions | Files: Custom Sorting |
|---|---|
| Know what software peers run | Find files faster with new sorting |
Additional improvements include a close button in the file viewer, better error handling, and fixed navigation highlighting.
ipfs pin ls <cid> --names now correctly returns pin names for specific CIDs (#10649, boxo#1035), RPC no longer incorrectly returns names from other pins (#10966), and pin names are now limited to 255 bytes for better cross-platform compatibility (#10981).
ipfs files write fixesIdentity CID size limits are now enforced
This release enforces a maximum of 128 bytes for identity CIDs (IPIP-512) - attempting to exceed this limit will return a clear error message.
Identity CIDs use multihash 0x00 to embed data directly in the CID without hashing. This experimental optimization was designed for tiny data where a CID reference would be larger than the data itself, but without size limits it was easy to misuse and could turn into an anti-pattern that wastes resources and enables abuse.
ipfs add --inline-limit and --hash=identity now enforce the 128-byte maximum (error when exceeded)ipfs files write prevents creation of oversized identity CIDsMultiple ipfs files write bugs have been fixed
This release resolves several long-standing MFS issues: raw nodes now preserve their codec instead of being forced to dag-pb, append operations on raw nodes work correctly by converting to UnixFS when needed, and identity CIDs properly inherit the full CID prefix from parent directories.
Improvements to the providing system in the last release (provide blocks according to the configured Strategy) left out Filestore and Urlstore blocks when the "all" strategy was used. They would only be reprovided but not provided on write. This is now fixed, and both Filestore blocks (local file references) and Urlstore blocks (HTTP/HTTPS URL references) will be provided correctly shortly after initial add.
The new Internal.MFSNoFlushLimit configuration option prevents unbounded memory growth when using --flush=false with ipfs files commands. After performing the configured number of operations without flushing (default: 256), further operations will fail with a clear error message instructing users to flush manually.
boxo to v0.35.0go-libp2p-kad-dht to v0.35.0ipfs-webui to v4.9.1 (incl. v4.9.0)<details><summary>Full Changelog</summary>
--flush=false (#10985) (ipfs/kubo#10985)flush=false (#10971) (ipfs/kubo#10971)ipfs pin ls <cid> --names (#10970) (ipfs/kubo#10970)MaxRangeRequestFileSize protection (#1043) (ipfs/boxo#1043)CheckIfPinnedWithType for efficient checks with names (#1035) (ipfs/boxo#1035)time.Duration for rebroadcast delay (#1027) (ipfs/boxo#1027)retrieval.RetrievalState to retrieval.State (#1026) (ipfs/boxo#1026)@masih form CODEOWNERS (ipld/go-car#605)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Guillaume Michel | 62 | +15401/-5657 | 209 |
| Marcin Rataj | 33 | +9540/-1734 | 215 |
| Andrew Gillis | 29 | +771/-1093 | 70 |
| Hlib Kanunnikov | 2 | +350/-0 | 5 |
| Rod Vagg | 3 | +260/-9 | 4 |
| Hector Sanjuan | 4 | +188/-33 | 11 |
| Jakub Sztandera | 1 | +67/-15 | 3 |
| Masih H. Derkani | 1 | +1/-2 | 2 |
| Dominic Della Valle | 1 | +2/-1 | 1 |
Fixes migration panic on Windows when upgrading from v0.37 to v0.38 ("panic: error can't be dealt with transactionally: Access is denied").
Updates go-ds-pebble to v0.5.3 (pebble v2.1.0).
<details><summary>Full Changelog</summary>
</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Marcin Rataj | 2 | +613/-267 | 15 |
| Andrew Gillis | 6 | +148/-22 | 8 |
Provide.DHT.SweepEnabled=true<details><summary>Full Changelog</summary>
GetBlocks (ipfs/boxo#1060)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| rvagg | 1 | +537/-481 | 3 |
| Carlos Hernandez | 9 | +556/-218 | 11 |
| Guillaume Michel | 3 | +139/-105 | 6 |
| gammazero | 8 | +101/-97 | 14 |
| Hector Sanjuan | 1 | +87/-28 | 5 |
| Marcin Rataj | 4 | +57/-9 | 7 |
| Marco Munizaga | 2 | +42/-14 | 7 |
| Dennis Trautwein | 2 | +19/-7 | 7 |
| Andrew Gillis | 3 | +3/-19 | 3 |
| Rod Vagg | 4 | +12/-3 | 4 |
| web3-bot | 1 | +2/-1 | 1 |
| galargh | 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
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 `ipfs stats reprovide`
<a href="https://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 commandipfs add commandipfs name publishReprovider.Strategy is now consistently respectedReprovider.Strategy=all: improved memory efficiencyipfs cidipfs stats reprovideKubo 0.37.0 introduces embedded repository migrations, gateway resource protection, complete AutoConf control, improved reprovider strategies, and anonymous telemetry for better feature prioritization. This release significantly improves memory efficiency, network configuration flexibility, and operational reliability while maintaining full backward compatibility.
This release migrates the Kubo repository from version 16 to version 17. Migrations are now built directly into the binary - completing in milliseconds without internet access or external downloads.
ipfs daemon --migrate performs migrations automatically. Manual migration: ipfs repo migrate --to=17 (or --to=16 --allow-downgrade for compatibility). Embedded migrations apply to v17+; older versions still require external tools.
Legacy migration deprecation: Support for legacy migrations that download binaries from the internet will be removed in a future version. Only embedded migrations for the last 3 releases will be supported. Users with very old repositories should update in stages rather than skipping multiple versions.
New configurable limits protect gateway resources during high load:
Gateway.RetrievalTimeout (default: 30s): Maximum duration for content retrieval. Returns 504 Gateway Timeout when exceeded - applies to both initial retrieval (time to first byte) and between subsequent writes.Gateway.MaxConcurrentRequests (default: 4096): Limits concurrent HTTP requests. Returns 429 Too Many Requests when exceeded. Protects nodes from traffic spikes and resource exhaustion, especially useful behind reverse proxies without rate-limiting.New Prometheus metrics for monitoring:
ipfs_http_gw_concurrent_requests: Current requests being processedipfs_http_gw_responses_total: HTTP responses by status codeipfs_http_gw_retrieval_timeouts_total: Timeouts by status code and truncation statusTuning tips:
ipfs_http_gw_concurrent_requests for saturationipfs_http_gw_retrieval_timeouts_total vs success rates to identify timeout patterns indicating routing or storage provider issuesConfiguration fields now support ["auto"] placeholders that resolve to network defaults from AutoConf.URL. These defaults can be inspected, replaced with custom values, or disabled entirely. Previously, empty configuration fields like Routing.DelegatedRouters: [] would use hardcoded defaults - this system makes those defaults explicit through "auto" values. When upgrading to Kubo 0.37, custom configurations remain unchanged.
New --expand-auto flag shows resolved values for any config field:
ipfs config show --expand-auto # View all resolved endpoints
ipfs config Bootstrap --expand-auto # Check specific values
ipfs config Routing.DelegatedRouters --expand-auto
ipfs config DNS.Resolvers --expand-auto
Configuration can be managed via:
"auto" with custom endpoints or set [] to disable features--profile=autoconf-on|autoconf-offAutoConf.Enabled and custom manifests via AutoConf.URL# Enable automatic configuration
ipfs config profiles apply autoconf-on
# Or manually set specific fields
ipfs config Bootstrap '["auto"]'
ipfs config --json DNS.Resolvers '{".": ["https://dns.example.com/dns-query"], "eth.": ["auto"]}'
Organizations can host custom AutoConf manifests for private networks. See AutoConf documentation and format spec at https://conf.ipfs-mainnet.org/
Changing Reprovider.Strategy and restarting Kubo now automatically clears the provide queue. Only content matching the new strategy will be announced.
Manual queue clearing is also available:
ipfs provide clear - clear all queued content announcements[!NOTE] Upgrading to Kubo 0.37 will automatically clear any preexisting provide queue. The next time
Reprovider.Intervalhits,Reprovider.Strategywill be executed on a clean slate, ensuring consistent behavior with your current configuration.
ipfs log level commandThe ipfs log level command has been completely revamped to support both getting and setting log levels with a unified interface.
New: Getting log levels
ipfs log level - Shows default level onlyipfs log level all - Shows log level for every subsystem, including default levelipfs log level foo - Shows log level for a specific subsystem onlyPOST /api/v0/log/level?arg=<subsystem>Enhanced: Setting log levels
ipfs log level foo debug - Sets "foo" subsystem to "debug" levelipfs log level all info - Sets all subsystems to "info" level (convenient, no escaping)ipfs log level '*' info - Equivalent to above but requires shell escapingipfs log level foo default - Sets "foo" subsystem to current default levelThe command now provides full visibility into your current logging configuration while maintaining full backward compatibility. Both all and * work for specifying all subsystems, with all being more convenient since it doesn't require shell escaping.
ipfs add commandAdded --pin-name flag to ipfs add for assigning names to pins.
$ ipfs add --pin-name=testname cat.jpg
added bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi cat.jpg
$ ipfs pin ls --names
bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi recursive testname
Added support for controlling IPNS record publishing strategies with new command flags and configuration.
New command flags:
# Publish without network connectivity (local datastore only)
ipfs name publish --allow-offline /ipfs/QmHash
# Publish without DHT connectivity (uses local datastore and HTTP delegated publishers)
ipfs name publish --allow-delegated /ipfs/QmHash
Delegated publishers configuration:
Ipns.DelegatedPublishers configures HTTP endpoints for IPNS publishing. Supports "auto" for network defaults or custom HTTP endpoints. The --allow-delegated flag enables publishing through these endpoints without requiring DHT connectivity, useful for nodes behind restrictive networks or during testing.
ipfs name publishAdded --sequence flag to ipfs name publish for setting custom sequence numbers in IPNS records. This enables advanced use cases like manually coordinating updates across multiple nodes. See ipfs name publish --help for details.
Reprovider.Strategy is now consistently respectedPrior to this version, files added, blocks received etc. were "provided" to the network (announced on the DHT) regardless of the "reproviding strategy" setting. For example:
ipfs add --pin=false → file was provided regardlessipfs pin add → all blocks (not only the root) were providedOnly the periodic "reproviding" action (runs every 22h by default) respected the strategy.
This was inefficient as content that should not be provided was getting provided once. Now all operations respect Reprovider.Strategy. If set to "roots", no blocks other than pin roots will be provided regardless of what is fetched, added etc.
[!NOTE] Behavior change: The
--offlineflag no longer affects providing behavior. Bothipfs addandipfs --offline addnow provide blocks according to the reproviding strategy when run against an online daemon (previously--offline adddid not provide). Sinceipfs addhas been nearly as fast as offline mode since v0.35,--offlineis rarely needed. To run truly offline operations, useipfs --offline daemon.
Reprovider.Strategy=all: improved memory efficiencyThe memory cost of Reprovider.Strategy=all no longer grows with the number of pins. The strategy now processes blocks directly from the datastore in undefined order, eliminating the memory pressure tied to the number of pins.
As part of this improvement, the flat reprovider strategy has been renamed to all (the default). This cleanup removes the workaround introduced in v0.28 for pin root prioritization. With the introduction of more granular strategies like pinned+mfs, we can now optimize the default all strategy for lower memory usage without compromising users who need pin root prioritization (rationale).
[!NOTE] Migration guidance: If you experience undesired announcement delays of root CIDs with the new
allstrategy, switch topinned+mfsfor root prioritization.
Kubo has been cleaned up by removing unnecessary dependencies and packages:
thirdparty/assert (replaced by github.com/stretchr/testify/require)thirdparty/dir (replaced by misc/fsutil)thirdparty/notifier (unused)goprocess dependency (replaced with native Go context patterns)These changes reduce the dependency footprint while improving code maintainability and following Go best practices.
ipfs cidCertain ipfs cid commands can now be run without a daemon or repository, and return correct exit code 1 on error, making it easier to perform CID conversion in scripts and CI/CD pipelines.
While at it, we also fixed unicode support in ipfs cid bases --prefix to correctly show base256emoji 🚀 :-)
ipfs stats reprovideThe ipfs stats reprovide command has moved to ipfs provide stat. This was done to organize provider commands in one location.
[!NOTE]
ipfs stats reprovidestill works, but is marked as deprecated and will be removed in a future release.
AutoRelay's relay discovery now includes all connected peers as potential relay candidates, not just peers discovered through the DHT. This allows peers connected via HTTP routing and manual ipfs swarm connect commands to serve as relays, improving connectivity for nodes using non-DHT routing configurations.
Per a suggestion from the IPFS Foundation, Kubo now sends optional anonymized telemetry information to Shipyard maintainers.
Privacy first: The telemetry system collects only anonymous data - no personally identifiable information, file paths, or content data. A random UUID is generated on first run for anonymous identification. Users are notified before any data is sent and have time to opt-out.
Why: We want to better understand Kubo usage across the ecosystem so we can better direct funding and work efforts. For example, we have little insights into how many nodes are NAT'ed and rely on AutoNAT for reachability. Some of the information can be inferred by crawling the network or logging /identify details in the bootstrappers, but users have no way of opting out from that, so we believe it is more transparent to concentrate this functionality in one place.
What: Currently, we send the following anonymous metrics:
<details><summary>Click to see telemetry metrics example</summary>
"uuid": "<unique_uuid>",
"agent_version": "kubo/0.37.0-dev",
"private_network": false,
"bootstrappers_custom": false,
"repo_size_bucket": 1073741824,
"uptime_bucket": 86400000000000,
"reprovider_strategy": "pinned",
"routing_type": "auto",
"routing_accelerated_dht_client": false,
"routing_delegated_count": 0,
"autonat_service_mode": "enabled",
"autonat_reachability": "",
"autoconf": true,
"autoconf_custom": false,
"swarm_enable_hole_punching": true,
"swarm_circuit_addresses": false,
"swarm_ipv4_public_addresses": true,
"swarm_ipv6_public_addresses": true,
"auto_tls_auto_wss": true,
"auto_tls_domain_suffix_custom": false,
"discovery_mdns_enabled": true,
"platform_os": "linux",
"platform_arch": "amd64",
"platform_containerized": false,
"platform_vm": false
</details>
The exact data sent for your node can be inspected by setting GOLOG_LOG_LEVEL="telemetry=debug". Users will see an informative message the first time they launch a telemetry-enabled daemon, with time to opt-out before any data is collected. Telemetry data is sent every 24h, with the first collection starting 15 minutes after daemon launch.
User control: You can opt-out at any time:
IPFS_TELEMETRY=off before starting the daemonipfs config Plugins.Plugins.telemetry.Config.Mode off and restart the daemonThe telemetry plugin code lives in plugin/plugins/telemetry.
Learn more: /kubo/docs/telemetry.md
boxo to v0.34.0 (incl. v0.33.1)go-libp2p to v0.43.0go-libp2p-kad-dht to v0.34.0go-libp2p-pubsub to v0.14.2 (incl. v0.14.1, v0.14.0)ipfs-webui to v4.8.0<details><summary>Full Changelog</summary>
ipfs add --help (#10926) (ipfs/kubo#10926)Gateway.RetrievalTimeout|MaxConcurrentRequests (#10905) (ipfs/kubo#10905)uber-go/multierr with errors.Join (#10912) (ipfs/kubo#10912)ipfs cid without repo (#10897) (ipfs/kubo#10897)ipfs stat provide/reprovide to ipfs provide stat (#10896) (ipfs/kubo#10896)uber-go/multierr with errors.Join (ipfs/boxo#996)uber-go/multierr with errors.Join (#242) (ipfs/go-datastore#242)uber-go/multierr with errors.Join (#168) (ipfs/go-log#168)</details>
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Marcin Rataj | 26 | +16033/-755 | 176 |
| Andrew Gillis | 35 | +2656/-1911 | 142 |
| Hector Sanjuan | 30 | +2638/-760 | 114 |
| Marco Munizaga | 11 | +1244/-362 | 41 |
| Russell Dempsey | 2 | +1031/-33 | 7 |
| Guillaume Michel | 4 | +899/-65 | 15 |
| whyrusleeping | 4 | +448/-177 | 15 |
| sukun | 9 | +312/-191 | 31 |
| gammazero | 23 | +239/-216 | 45 |
| Brian Olson | 5 | +343/-16 | 11 |
| Steven Allen | 3 | +294/-7 | 9 |
| Sergey Gorbunov | 2 | +247/-11 | 9 |
| Kapil Sareen | 1 | +86/-13 | 10 |
| Masih H. Derkani | 1 | +72/-24 | 1 |
| Piotr Galar | 1 | +40/-55 | 23 |
| Rod Vagg | 1 | +13/-11 | 3 |
| Ankita Sahu | 1 | +2/-0 | 1 |
| Štefan Baebler | 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.