Install Milvus Standalone

This topic describes how to install Milvus standalone with Docker Compose or on Kubernetes.

Check the requirements for hardware and software prior to your installation.

If you run into image loading errors while installing, you can Install Milvus Offline.

You can also build Milvus from source code at GitHub.

Download an installation file

Download milvus-standalone-docker-compose.yml directly or with the following command, and save it as docker-compose.yml.

$ wget https://github.com/milvus-io/milvus/releases/download/v2.0.0-pre-ga/milvus-standalone-docker-compose.yml -O docker-compose.yml

Configure Milvus (optional)

Download milvus.yaml directly or with the following command.

$ wget https://raw.githubusercontent.com/milvus-io/milvus/v2.0.0-pre-ga/configs/milvus.yaml

Modify the configurations to suit your needs. See Milvus Standalone System Configurations for more information.

In docker-compose.yml, map the local path to your milvus.yaml file onto the corresponding docker container path to the configuration file /milvus/configs/milvus.yaml under the volumes section.

    volumes:
      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/milvus:/var/lib/milvus
      - /local/path/to/your/file:/milvus/configs/milvus.yaml     # Map the local path to the container path

Start Milvus

$ sudo docker-compose up -d

Docker Compose is now in the Docker CLI, try `docker compose up`
Creating milvus-etcd  ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done

Check the status of the containers.

$ sudo docker-compose ps

After Milvus standalone starts, three running docker containers appear including two dependencies and one Milvus service.

      Name                     Command                  State                          Ports
----------------------------------------------------------------------------------------------------------------
milvus-etcd         etcd -listen-peer-urls=htt ...   Up (healthy)   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,:::19530->19530/tcp

Stop Milvus

To stop Milvus standalone, run $ sudo docker-compose down.

To delete data after stopping Milvus, run $ sudo rm -rf volumes.

What's next

Having installed Milvus, you can:

• Check Hello Milvus to run an example code with different SDKs to see what Milvus can do.

• Learn the basic operations of Milvus:

  • Connect to Milvus server
  • Conduct a vector search
  • Conduct a hybrid search

• Explore MilvusDM, an open-source tool designed for importing and exporting data in Milvus.

• Monitor Milvus with Prometheus.