Milvus offline installation

Manually downloading Docker images

Milvus installation may fail when images are not properly loaded from public Docker registries. To pull all images and save them into a directory that can be moved to the target host and loaded manually, perform the following procedures:

Step 1: Download files of scripts & requirements

shell

$ wget https://raw.githubusercontent.com/milvus-io/milvus/master/deployments/offline/requirements.txt
$ wget https://raw.githubusercontent.com/milvus-io/milvus/master/deployments/offline/save_image.py

Download requirements.txt and save_image.py, which will be used later.

Step 2: Save Milvus manifests and Docker images

If you install Milvus with the docker-compose.yml file, use these commands:

1. Download Milvus standalone docker-compose.yml

shell

$ wget https://raw.githubusercontent.com/milvus-io/milvus/master/deployments/docker/standalone/docker-compose.yml -O docker-compose.yml

or download Milvus cluster docker-compose.yml

shell

$ wget https://raw.githubusercontent.com/milvus-io/milvus/master/deployments/docker/cluster/docker-compose.yml -O docker-compose.yml

2. Pull and save Docker images

shell

$ pip3 install -r requirements.txt
$ python3 save_image.py --manifest docker-compose.yml

If you install Milvus with Helm, use these commands:

1. Update Helm repo

shell

$ helm repo add milvus https://zilliztech.github.io/milvus-helm/
$ helm repo update

2. Get Kubernetes manifests of Milvus standalone

shell

$ helm template my-release milvus/milvus --set cluster.enabled=false --set pulsar.enabled=false --set minio.mode=standalone --set etcd.replicaCount=1 > milvus_manifest.yaml

or get Kubernetes manifests of Milvus cluster

shell

$ helm template my-release milvus/milvus > milvus_manifest.yaml

3. Pull and save Docker images

shell

$ pip3 install -r requirements.txt
$ python3 save_image.py --manifest milvus_manifest.yaml

The Docker images will be stored under images directory.

Step 3: Load Docker images

Enter the following command to load the Docker images:

shell

$ for image in $(find . -type f -wholename "./images/*.tar.gz") ; do gunzip -c $image | docker load; done;

Install Milvus

With Docker Compose

shell

$ docker compose -f docker-compose.yml up -d

On Kubernetes

shell

$ kubectl apply -f milvus_manifest.yaml

Uninstall Milvus

With Docker Compose

shell

$ docker compose -f docker-compose.yml down

On Kubernetes

shell

$ kubectl delete -f milvus_manifest.yaml