Before installing Milvus, check if your hardware and software meet the requirements.
Hardware Requirements
| Component | Requirement | Recommended Configuration | Note |
|---|---|---|---|
| CPU | - Intel Core i5 or higher - Apple Silicon | - Standalone: 4 cores or more - Cluster: 8 cores or more | |
| CPU Instruction Set | - SSE4.2 - AVX - AVX2 - AVX-512 | - SSE4.2 - AVX - AVX2 - AVX-512 | Milvus requires CPU support for Single Instruction, Multiple Data (SIMD) extensions for vector similarity search and index building. Make sure your CPU supports at least one of these SIMD extensions. Refer to AVX-supported CPUs for more information. |
| RAM | Standalone: 8G - Cluster: 32G | Standalone: 16G - Cluster: 128G | The amount of RAM depends on the data volume. |
| Hard Disk | SATA 3.0 SSD or higher | NVMe SSD or higher | The disk size depends on the data volume. |
Software Requirements
| Operating System | Software | Note |
|---|---|---|
| macOS 10.14 or higher | Docker Desktop | Set the Docker VM to use at least 2 virtual CPUs (vCPUs) and 8GB initial memory. Otherwise, the installation may fail. For more information, see Install Docker Desktop on Mac. |
| Linux Platform | - Docker 19.03 or higher - Docker Compose 1.25.1 or higher | For more information, see Install Docker Engine and Install Docker Compose. |
| Windows with WSL 2 enabled | Docker Desktop | We recommend binding source code and other data to the Linux container's file system rather than the Windows file system. For more information, see Install Docker Desktop on Windows with WSL 2 Backend. |
| Software | Version | Note |
|---|---|---|
| etcd | 3.5.0 | Check additional disk requirements. |
| MinIO | RELEASE.2023-03-20T20-16-18Z | |
| Pulsar | 2.8.2 |
Additional Disk Requirements
Disk performance is crucial for etcd. It is strongly recommended to use local NVMe SSD. Slower disk response may lead to frequent cluster elections, ultimately degrading the performance of the etcd service.
Download YAML File
Manually download milvus-standalone-docker-compose.yml and save it as docker-compose.yml, or use the following command.
wget https://github.com/milvus-io/milvus/releases/download/v2.3.0/milvus-standalone-docker-compose.yml -O docker-compose.yml
If the GitHub address cannot be downloaded, click this site's milvus-standalone-docker-compose.yml download address.
Start Milvus
To start Milvus, run the following command in the same directory as the docker-compose.yml file:
sudo docker compose up -d
If the above command cannot be executed, please check if your system has Docker Compose V1 installed. If so, it is recommended to migrate to Docker Compose V2.
Creating milvus-etcd ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done
Now, check if the containers are running:
sudo docker compose ps
After starting Milvus in standalone mode, there will be three Docker containers running, including the Milvus standalone mode service and its two dependencies.
Name Command State Ports
--------------------------------------------------------------------------------------------------------------------
milvus-etcd etcd -advertise-client-url ... Up 2379/tcp, 2380/tcp
milvus-minio /usr/bin/docker-entrypoint ... Up (healthy) 9000/tcp
milvus-standalone /tini -- milvus run standalone Up 0.0.0.0:19530->19530/tcp, 0.0.0.0:9091->9091/tcp
Connect to Milvus
Verify the local port that the Milvus server is listening on. Replace the container name with your own.
docker port milvus-standalone 19530/tcp
You can use the local IP address and port number returned by this command to connect to Milvus.
Stop Milvus
To stop the standalone version of Milvus, run:
sudo docker compose down
To delete the data after stopping Milvus, run:
sudo rm -rf volumes