ollama/examples/kubernetes/README.md

# Deploy Ollama to Kubernetes

## Prerequisites

- Ollama: https://ollama.com/download
- Kubernetes cluster. This example will use Google Kubernetes Engine.

## Steps

1. Create the Ollama namespace, deployment, and service

   ```bash
   kubectl apply -f cpu.yaml
   ```

## (Optional) Hardware Acceleration

Hardware acceleration in Kubernetes requires NVIDIA's [`k8s-device-plugin`](https://github.com/NVIDIA/k8s-device-plugin) which is deployed in Kubernetes in form of daemonset. Follow the link for more details.

Once configured, create a GPU enabled Ollama deployment.

```bash
kubectl apply -f gpu.yaml
```

## Test

1. Port forward the Ollama service to connect and use it locally

   ```bash
   kubectl -n ollama port-forward service/ollama 11434:80
   ```

1. Pull and run a model, for example `orca-mini:3b`

   ```bash
   ollama run orca-mini:3b
   ```