milvus-logo

Install Milvus Standalone with Docker Compose

This topic describes how to install Milvus standalone using Docker Compose.

Prerequisites

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

Download the YAML file

  • If you want to install Milvus without GPU support, download milvus-standalone-docker-compose.yml and save it as docker-compose.yml manually, or with the following command.

    $ wget https://github.com/milvus-io/milvus/releases/download/v2.3.0-beta/milvus-standalone-docker-compose.yml -O docker-compose.yml
    
  • If you want to install Milvus with GPU support, download milvus-standalone-docker-compose-gpu.yml and save it as docker-compose.yml manually, or with the following command.

    $ wget https://github.com/milvus-io/milvus/releases/download/v2.3.0-beta/milvus-standalone-docker-compose-gpu.yml -O docker-compose.yml
    

To use Milvus with GPU support, ensure that

  • Docker Compose version is v1.28.0 or later.
  • NVIDIA Tesla driver version is 450.80.02 or later.
  • NVIDIA GTX driver version is 510.47.03 or later.
  • NVIDIA Container Toolkit has been installed. For details, refer to Setting up NVIDIA Container Toolkit.
  • NVIDIA CUDA version is 11.6 or later.

Start Milvus

In the same directory as the docker-compose.yml file, start up Milvus by running:

$ sudo docker-compose up -d
If your system has Docker Compose V2 installed instead of V1, use docker compose instead of docker-compose . Check if this is the case with $ docker compose version . Read here for more information.
Creating milvus-etcd  ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done

Now check if the containers are up and running.

$ sudo docker-compose ps

After Milvus standalone starts, there will be three docker containers running, including the Milvus standalone 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

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:

On this page