milvus/deployments/offline/README.md

# Milvus offline installation

## Manually downloading Docker images

Your 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 procedure:

1. Save Milvus manifest and Docker images

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

- Download Milvus docker-compose.yml
```shell
# Download Milvus standalone docker-compose.yml
wget https://raw.githubusercontent.com/milvus-io/milvus/master/deployments/docker/standalone/docker-compose.yml -O docker-compose.yml
```

or

```shell
# Download Milvus cluster docker-compose.yml
wget https://raw.githubusercontent.com/milvus-io/milvus/master/deployments/docker/cluster/docker-compose.yml -O docker-compose.yml
```

- Pull and save Docker images
```shell
# Pull and save Docker images
pip3 install -r requirements.txt
python3 save_image.py --manifest docker-compose.yml
```

If you install your Milvus with **Helm**, use these command: 
- Update Helm repo
```shell
helm repo add milvus https://milvus-io.github.io/milvus-helm/
helm repo update
```

- Get Kubernetes manifest of Milvus standalone
```shell
# Get Kubernetes manifest of Milvus standalone
helm template my-release milvus/milvus > milvus_manifest.yaml
```

or

```shell
# Get Kubernetes manifest of Milvus cluster
helm template --set cluster.enabled=true my-release milvus/milvus > milvus_manifest.yaml
```

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

2. Enter the following command to load the Docker images:

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

## Install Milvus

- Install Milvus with Docker Compose

```shell
docker-compose -f docker-compose.yml up -d
```

- Install Milvus on Kubernetes

```shell
kubectl apply -f milvus_manifest.yaml
```

## Uninstall Milvus

- Uninstall Milvus with Docker Compose

```shell
docker-compose -f docker-compose.yml down
```

- Uninstall Milvus on Kubernetes

```shell
kubectl delete -f milvus_manifest.yaml
```