Run Milvus in Docker (Linux)

This page illustrates how to launch a Milvus instance in Docker.

Prerequisites

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

Install Milvus in Docker

Milvus provides an installation script to install it as a docker container. The script is available in the Milvus repository. To install Milvus in Docker, just run

# Download the installation script
$ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh

# Start the Docker container
$ bash standalone_embed.sh start

After running the installation script:

• A docker container named milvus has been started at port 19530.
• An embed etcd is installed along with Milvus in the same container and serves at port 2379. Its configuration file is mapped to embedEtcd.yaml in the current folder.
• To change the default Milvus configuration, add your settings to the user.yaml file in the current folder and then restart the service.
• The Milvus data volume is mapped to volumes/milvus in the current folder.

You can 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.

(Optional) Update Milvus configurations

You can modify the Milvus configurations in the user.yaml file in the current folder. For example, to change the proxy.healthCheckTimeout to 1000 ms, you can modify the file as follows:

cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
  healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF

Then restart the service as follows:

$ bash standalone_embed.sh restart

For applicable configuration items, refer to System Configuration.

Upgrade Milvus

You can upgrade to the latest version of Milvus using the built-in upgrade command. This automatically downloads the latest configuration and Milvus image:

# Upgrade Milvus to the latest version
$ bash standalone_embed.sh upgrade

Stop and delete Milvus

You can stop and delete this container as follows

# Stop Milvus
$ bash standalone_embed.sh stop

# Delete Milvus data
$ bash standalone_embed.sh delete

What’s next

Having installed Milvus in Docker, you can:

• Check Quickstart to see what Milvus can do.

• Learn the basic operations of Milvus:

  • Manage Databases
  • Manage Collections
  • Manage Partitions
  • Insert, Upsert & Delete
  • Single-Vector Search
  • Hybrid Search

• Upgrade Milvus Using Helm Chart.

• Scale your Milvus cluster.

• Deploy your Milvu cluster on clouds:

  • Amazon EKS
  • Google Cloud
  • Microsoft Azure

• Explore Milvus WebUI, an intuitive web interface for Milvus observability and management.

• Explore Milvus Backup, an open-source tool for Milvus data backups.

• Explore Birdwatcher, an open-source tool for debugging Milvus and dynamic configuration updates.

• Explore Attu, an open-source GUI tool for intuitive Milvus management.

• Monitor Milvus with Prometheus.