Skip to content

Commit 6f66bce

Browse files
Milvus-doc-botMilvus-doc-bot
authored andcommitted
Release new docs to preview
1 parent ce93bb4 commit 6f66bce

1 file changed

Lines changed: 34 additions & 11 deletions

File tree

v3.0.x/site/en/getstarted/run-milvus-docker/install_standalone-docker-compose.md

Lines changed: 34 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,11 @@ Creating milvus-standalone ... done
3333

3434
<div class="alert note">
3535

36-
**What's new in v3.0-beta:**
37-
- **Enhanced Architecture**: Features the new Streaming Node and optimized components
38-
- **Updated Dependencies**: Includes the latest MinIO and etcd versions
39-
- **Improved Configuration**: Optimized settings for better performance
36+
**Default deployment (v3.0-beta):** `docker compose up -d` starts three containers — `milvus-etcd` (metadata), `milvus-minio` (object storage), and `milvus-standalone`. The message queue is **Woodpecker (embedded, with MinIO / object storage as its WAL backend)**, so no separate message-queue container is required.
37+
38+
**Message-queue default by version:**
39+
- **2.5.x** — default message queue is **RocksMQ**.
40+
- **2.6.x and later** — default message queue is **Woodpecker (embedded)**.
4041

4142
Always download the latest Docker Compose configuration to ensure compatibility with v3.0-beta features.
4243

@@ -50,19 +51,18 @@ After starting up Milvus,
5051

5152
- Containers named **milvus-standalone**, **milvus-minio**, and **milvus-etcd** are up.
5253
- The **milvus-etcd** container does not expose any ports to the host and maps its data to **volumes/etcd** in the current folder.
53-
- The **milvus-minio** container serves ports **9090** and **9091** locally with the default authentication credentials and maps its data to **volumes/minio** in the current folder.
54+
- The **milvus-minio** container serves ports **9000** and **9001** locally with the default authentication credentials and maps its data to **volumes/minio** in the current folder.
5455
- The **milvus-standalone** container serves ports **19530** locally with the default settings and maps its data to **volumes/milvus** in the current folder.
5556

5657
You can check if the containers are up and running using the following command:
5758

5859
```shell
59-
$ sudo docker-compose ps
60+
$ docker compose ps
6061

61-
Name Command State Ports
62-
--------------------------------------------------------------------------------------------------------------------
63-
milvus-etcd etcd -advertise-client-url ... Up 2379/tcp, 2380/tcp
64-
milvus-minio /usr/bin/docker-entrypoint ... Up (healthy) 9000/tcp
65-
milvus-standalone /tini -- milvus run standalone Up 0.0.0.0:19530->19530/tcp, 0.0.0.0:9091->9091/tcp
62+
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
63+
milvus-etcd … "etcd -advertise-cli…" etcd 2 minutes ago Up 2 minutes (healthy) 2379-2380/tcp
64+
milvus-minio … "/usr/bin/docker-ent…" minio 2 minutes ago Up 2 minutes (healthy) 9000-9001/tcp
65+
milvus-standalone … "/tini -- milvus run…" standalone 2 minutes ago Up 2 minutes (healthy) 0.0.0.0:9091->9091/tcp, 0.0.0.0:19530->19530/tcp
6666
```
6767

6868
You can also access Milvus WebUI at `http://127.0.0.1:9091/webui/` to learn more about the your Milvus instance. For details, refer to [Milvus WebUI](milvus-webui.md).
@@ -106,6 +106,29 @@ $ sudo docker compose down
106106
$ sudo rm -rf volumes
107107
```
108108
109+
## Upgrading from Milvus 2.5.x to 2.6.x
110+
111+
**Message Queue limitations**: When upgrading to Milvus v3.0-beta, you must maintain your current message queue choice. Switching between different message queue systems during the upgrade is not supported. Support for changing message queue systems will be available in future versions.
112+
113+
114+
Because 2.6.x changes the default message queue to Woodpecker, an instance running **RocksMQ** on 2.5.x must **explicitly pin RocksMQ before upgrading** — otherwise the upgrade would attempt to change the message queue, which is not supported. After downloading the 2.6.x Docker Compose file, set the message-queue type back to `rocksmq` in your `user.yaml` override, then upgrade:
115+
116+
```yaml
117+
# user.yaml — keep RocksMQ across the 2.5.x → 2.6.x upgrade
118+
mq:
119+
type: rocksmq
120+
```
121+
122+
To switch the message queue *after* upgrading, see the Switch MQ Type guide.
123+
124+
## Optional dependencies
125+
126+
This deployment runs **Woodpecker** (embedded, MinIO WAL backend) for messaging, **etcd** for metadata, and **MinIO** for object storage. To use a different message queue or connect external object storage / metadata, see:
127+
128+
- Message queue: [Woodpecker](woodpecker.md) (default) · [Pulsar](mq_pulsar.md) · [Kafka](mq_kafka.md) · [RocksMQ](mq_rocksmq.md)
129+
- Object storage: [MinIO](deploy_s3.md) (default) · [AWS S3](deploy_s3.md) · [Azure Blob](abs.md) · [GCP Cloud Storage](gcs.md) · [Aliyun OSS](deploy_s3.md) · [Tencent COS](deploy_s3.md) · [Huawei OBS](deploy_s3.md) · [S3-compatible](deploy_s3.md)
130+
- Metadata: [etcd](deploy_etcd.md)
131+
109132
## What's next
110133
111134
Having installed Milvus in Docker, you can:

0 commit comments

Comments
 (0)