Skip to content

Commit 69621cc

Browse files
chore: update release version numbers (#1953)
1 parent 757e37d commit 69621cc

File tree

5 files changed

+334
-298
lines changed

5 files changed

+334
-298
lines changed

docs/install/command-line.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Kubo
33
description: Using IPFS Kubo through the command-line allows you to do everything that IPFS Desktop can do, but at a more granular level, since you can specify which commands to run. Learn how to install it here.
4-
current-ipfs-version: v0.31.0
4+
current-ipfs-version: v0.32.0
55
---
66

77
# Install IPFS Kubo
@@ -31,7 +31,7 @@ Kubo runs on most Windows, MacOS, Linux, FreeBSD and OpenBSD systems that meet t
3131

3232
Note the following:
3333
- The amount of disk space your IPFS installation uses depends on how much data you're sharing. A base installation uses around 12MB of disk space.
34-
- You can enable automatic garbage collection via [--enable-gc](../reference/kubo/cli.md#ipfs-daemon) and adjust using [default maximum disk storage](https://github.com/ipfs/kubo/blob/v0.31.0/docs/config.md#datastorestoragemax) for data retrieved from other peers.
34+
- You can enable automatic garbage collection via [--enable-gc](../reference/kubo/cli.md#ipfs-daemon) and adjust using [default maximum disk storage](https://github.com/ipfs/kubo/blob/v0.32.0/docs/config.md#datastorestoragemax) for data retrieved from other peers.
3535

3636

3737
<!-- TODO: hide this footgun until https://github.com/ipfs/kubo/pull/10524 is merged and released in stable kubo
@@ -76,27 +76,27 @@ For installation instructions for your operating system, select the appropriate
7676
1. Download the Windows binary from [`dist.ipfs.tech`](https://dist.ipfs.tech/#kubo).
7777

7878
```powershell
79-
wget https://dist.ipfs.tech/kubo/v0.31.0/kubo_v0.31.0_windows-amd64.zip -Outfile kubo_v0.31.0.zip
79+
wget https://dist.ipfs.tech/kubo/v0.32.0/kubo_v0.32.0_windows-amd64.zip -Outfile kubo_v0.32.0.zip
8080
```
8181

82-
1. Unzip the file to a sensible location, such as `~\Apps\kubo_v0.31.0`.
82+
1. Unzip the file to a sensible location, such as `~\Apps\kubo_v0.32.0`.
8383

8484
```powershell
85-
Expand-Archive -Path kubo_v0.31.0.zip -DestinationPath ~\Apps\kubo_v0.31.0
85+
Expand-Archive -Path kubo_v0.32.0.zip -DestinationPath ~\Apps\kubo_v0.32.0
8686
```
8787

88-
1. Move into the `kubo_v0.31.0` folder
88+
1. Move into the `kubo_v0.32.0` folder
8989

9090
```powershell
91-
cd ~\Apps\kubo_v0.31.0\kubo
91+
cd ~\Apps\kubo_v0.32.0\kubo
9292
```
9393

9494
1. Check that the `ipfs.exe` works:
9595

9696
```powershell
9797
.\ipfs.exe --version
9898
99-
> ipfs version 0.31.0
99+
> ipfs version 0.32.0
100100
```
101101

102102
At this point, Kubo is usable. However, it's strongly recommended that you first add `ipfs.exe` to your `PATH` using the following steps:
@@ -142,7 +142,7 @@ For installation instructions for your operating system, select the appropriate
142142
```powershell
143143
ipfs --version
144144
145-
> ipfs version 0.31.0
145+
> ipfs version 0.32.0
146146
```
147147

148148
:::
@@ -170,7 +170,7 @@ For installation instructions for your operating system, select the appropriate
170170
If Kubo is installed, the version number displays. For example:
171171

172172
```bash
173-
> ipfs version 0.31.0
173+
> ipfs version 0.32.0
174174
```
175175
:::
176176

@@ -181,13 +181,13 @@ For installation instructions for your operating system, select the appropriate
181181
1. Download the Linux binary from [`dist.ipfs.tech`](https://dist.ipfs.tech/#kubo).
182182

183183
```bash
184-
wget https://dist.ipfs.tech/kubo/v0.31.0/kubo_v0.31.0_linux-amd64.tar.gz
184+
wget https://dist.ipfs.tech/kubo/v0.32.0/kubo_v0.32.0_linux-amd64.tar.gz
185185
```
186186

187187
1. Unzip the file:
188188

189189
```bash
190-
tar -xvzf kubo_v0.31.0_linux-amd64.tar.gz
190+
tar -xvzf kubo_v0.32.0_linux-amd64.tar.gz
191191

192192
> x kubo/install.sh
193193
> x kubo/ipfs
@@ -216,7 +216,7 @@ For installation instructions for your operating system, select the appropriate
216216
```bash
217217
ipfs --version
218218

219-
> ipfs version 0.31.0
219+
> ipfs version 0.32.0
220220
```
221221

222222
:::
@@ -228,13 +228,13 @@ For installation instructions for your operating system, select the appropriate
228228
1. Download the FreeBSD binary from [`dist.ipfs.tech`](https://dist.ipfs.tech/#kubo).
229229

230230
```bash
231-
wget https://dist.ipfs.tech/kubo/v0.31.0/kubo_v0.31.0_freebsd-amd64.tar.gz
231+
wget https://dist.ipfs.tech/kubo/v0.32.0/kubo_v0.32.0_freebsd-amd64.tar.gz
232232
```
233233

234234
1. Unzip the file:
235235

236236
```bash
237-
tar -xvzf kubo_v0.31.0_freebsd-amd64.tar.gz
237+
tar -xvzf kubo_v0.32.0_freebsd-amd64.tar.gz
238238

239239
> x kubo/install.sh
240240
> x kubo/ipfs
@@ -263,7 +263,7 @@ For installation instructions for your operating system, select the appropriate
263263
```bash
264264
ipfs --version
265265

266-
> ipfs version 0.31.0
266+
> ipfs version 0.32.0
267267
```
268268

269269
:::
@@ -275,13 +275,13 @@ For installation instructions for your operating system, select the appropriate
275275
1. Download the OpenBSD binary from [`dist.ipfs.tech`](https://dist.ipfs.tech/#kubo).
276276

277277
```bash
278-
wget https://dist.ipfs.tech/kubo/v0.31.0/kubo_v0.31.0_openbsd-amd64.tar.gz
278+
wget https://dist.ipfs.tech/kubo/v0.32.0/kubo_v0.32.0_openbsd-amd64.tar.gz
279279
```
280280

281281
1. Unzip the file:
282282

283283
```bash
284-
tar -xvzf kubo_v0.31.0_openbsd-amd64.tar.gz
284+
tar -xvzf kubo_v0.32.0_openbsd-amd64.tar.gz
285285

286286
> x kubo/install.sh
287287
> x kubo/ipfs
@@ -310,7 +310,7 @@ For installation instructions for your operating system, select the appropriate
310310
```bash
311311
ipfs --version
312312

313-
> ipfs version 0.31.0
313+
> ipfs version 0.32.0
314314
```
315315

316316
:::
@@ -322,7 +322,7 @@ For installation instructions for your operating system, select the appropriate
322322

323323
## Build Kubo from source
324324

325-
For the current instructions on how to manually download, compile and build Kubo from source, see the [Build from Source](https://github.com/ipfs/kubo/blob/v0.31.0/README.md#build-from-source) section in the Kubo repository.
325+
For the current instructions on how to manually download, compile and build Kubo from source, see the [Build from Source](https://github.com/ipfs/kubo/blob/v0.32.0/README.md#build-from-source) section in the Kubo repository.
326326

327327
## Determining which node to use with the command line
328328

docs/reference/kubo/cli.md

Lines changed: 54 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ description: API documentation for the Kubo command-line executable.
55

66
# Kubo command-line
77

8-
::: tip Generated on 2024-10-17 13:53:14, from kubo 0.31.0
9-
This document was autogenerated from CLI help text in [kubo 0.31.0](https://github.com/ipfs/kubo/releases/tag/v0.31.0)
8+
::: tip Generated on 2024-11-14 02:07:48, from kubo 0.32.0
9+
This document was autogenerated from CLI help text in [kubo 0.32.0](https://github.com/ipfs/kubo/releases/tag/v0.32.0)
1010
For issues and support, check out the [generate-cli-docs.sh](https://github.com/ipfs/ipfs-docs/blob/main/docs/reference/kubo/generate-cli-docs.sh) script on GitHub.
1111
:::
1212

@@ -1087,12 +1087,25 @@ SYNOPSIS
10871087
DESCRIPTION
10881088
10891089
Available profiles:
1090-
'announce-on':
1091-
Re-enables Reprovide system (reverts announce-off profile).
1092-
'randomports':
1093-
Use a random port number for swarm.
1094-
'legacy-cid-v0':
1095-
Makes UnixFS import produce legacy CIDv0 with no raw leaves, sha2-256 and 256 KiB chunks.
1090+
'test':
1091+
Reduces external interference of IPFS daemon, this
1092+
is useful when using the daemon in test environments.
1093+
'announce-off':
1094+
Disables Reprovide system (and announcing to Amino DHT).
1095+
1096+
USE WITH CAUTION:
1097+
The main use case for this is setups with manual Peering.Peers config.
1098+
Data from this node will not be announced on the DHT. This will make
1099+
DHT-based routing an data retrieval impossible if this node is the only
1100+
one hosting it, and other peers are not already connected to it.
1101+
1102+
'default-datastore':
1103+
Configures the node to use the default datastore (flatfs).
1104+
1105+
Read the "flatfs" profile description for more information on this datastore.
1106+
1107+
This profile may only be applied when first initializing the node.
1108+
10961109
'pebbleds':
10971110
Configures the node to use the pebble high-performance datastore.
10981111
@@ -1112,49 +1125,28 @@ DESCRIPTION
11121125
NOTE: This profile may only be applied when first initializing node at IPFS_PATH
11131126
via 'ipfs init --profile pebbleds'
11141127
1128+
'lowpower':
1129+
Reduces daemon overhead on the system. May affect node
1130+
functionality - performance of content discovery and data
1131+
fetching may be degraded.
1132+
11151133
'test-cid-v1':
11161134
Makes UnixFS import produce modern CIDv1 with raw leaves, sha2-256 and 1 MiB chunks.
11171135
'server':
11181136
Disables local host discovery, recommended when
11191137
running IPFS on machines with public IPv4 addresses.
1120-
'test':
1121-
Reduces external interference of IPFS daemon, this
1122-
is useful when using the daemon in test environments.
1123-
'default-datastore':
1124-
Configures the node to use the default datastore (flatfs).
1125-
1126-
Read the "flatfs" profile description for more information on this datastore.
1127-
1128-
This profile may only be applied when first initializing the node.
1129-
1130-
'badgerds':
1131-
Configures the node to use the legacy badgerv1 datastore.
1132-
1133-
NOTE: this is badger 1.x, which has known bugs and is no longer supported by the upstream team.
1134-
It is provided here only for pre-existing users, allowing them to migrate away to more modern datastore.
1135-
1136-
Other caveats:
1137-
1138-
* This datastore will not properly reclaim space when your datastore is
1139-
smaller than several gigabytes. If you run IPFS with --enable-gc, you plan
1140-
on storing very little data in your IPFS node, and disk usage is more
1141-
critical than performance, consider using flatfs.
1142-
* This datastore uses up to several gigabytes of memory.
1143-
* Good for medium-size datastores, but may run into performance issues
1144-
if your dataset is bigger than a terabyte.
1145-
1146-
See configuration documentation at:
1147-
https://github.com/ipfs/kubo/blob/master/docs/datastores.md#badgerds
1148-
1149-
NOTE: This profile may only be applied when first initializing node at IPFS_PATH
1150-
via 'ipfs init --profile badgerds'
1151-
1152-
'local-discovery':
1153-
Sets default values to fields affected by the server
1154-
profile, enables discovery in local networks.
11551138
'default-networking':
11561139
Restores default network settings.
11571140
Inverse profile of the test profile.
1141+
'announce-on':
1142+
Re-enables Reprovide system (reverts announce-off profile).
1143+
'randomports':
1144+
Use a random port number for swarm.
1145+
'legacy-cid-v0':
1146+
Makes UnixFS import produce legacy CIDv0 with no raw leaves, sha2-256 and 256 KiB chunks.
1147+
'local-discovery':
1148+
Sets default values to fields affected by the server
1149+
profile, enables discovery in local networks.
11581150
'flatfs':
11591151
Configures the node to use the flatfs datastore.
11601152
@@ -1175,19 +1167,27 @@ DESCRIPTION
11751167
NOTE: This profile may only be applied when first initializing node at IPFS_PATH
11761168
via 'ipfs init --profile flatfs'
11771169
1178-
'lowpower':
1179-
Reduces daemon overhead on the system. May affect node
1180-
functionality - performance of content discovery and data
1181-
fetching may be degraded.
1170+
'badgerds':
1171+
Configures the node to use the legacy badgerv1 datastore.
11821172
1183-
'announce-off':
1184-
Disables Reprovide system (and announcing to Amino DHT).
1173+
NOTE: this is badger 1.x, which has known bugs and is no longer supported by the upstream team.
1174+
It is provided here only for pre-existing users, allowing them to migrate away to more modern datastore.
11851175
1186-
USE WITH CAUTION:
1187-
The main use case for this is setups with manual Peering.Peers config.
1188-
Data from this node will not be announced on the DHT. This will make
1189-
DHT-based routing an data retrieval impossible if this node is the only
1190-
one hosting it, and other peers are not already connected to it.
1176+
Other caveats:
1177+
1178+
* This datastore will not properly reclaim space when your datastore is
1179+
smaller than several gigabytes. If you run IPFS with --enable-gc, you plan
1180+
on storing very little data in your IPFS node, and disk usage is more
1181+
critical than performance, consider using flatfs.
1182+
* This datastore uses up to several gigabytes of memory.
1183+
* Good for medium-size datastores, but may run into performance issues
1184+
if your dataset is bigger than a terabyte.
1185+
1186+
See configuration documentation at:
1187+
https://github.com/ipfs/kubo/blob/master/docs/datastores.md#badgerds
1188+
1189+
NOTE: This profile may only be applied when first initializing node at IPFS_PATH
1190+
via 'ipfs init --profile badgerds'
11911191
11921192
11931193
SUBCOMMANDS

docs/reference/kubo/rpc.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,8 @@ I AM SERIOUS, DO NOT EDIT ANYTHING BELOW ;-D
4747
4848
-->
4949

50-
::: tip Generated on 2024-10-17, from kubo v0.31.0
51-
This document was autogenerated from [v0.31.0](https://github.com/ipfs/kubo/releases/tag/v0.31.0).
50+
::: tip Generated on 2024-11-14, from kubo v0.32.0
51+
This document was autogenerated from [v0.32.0](https://github.com/ipfs/kubo/releases/tag/v0.32.0).
5252
For issues and support, check out the [http-api-docs](https://github.com/ipfs/ipfs-docs/tree/main/tools/http-api-docs) generator on GitHub.
5353
:::
5454

0 commit comments

Comments
 (0)