# Unishift Ollama — runtime model sync

Образ на базе `ollama/ollama`. **Моделей в стартовом образе нет.** Entrypoint
ничего не скачивает, пока список не задан через env.

Уже установленные модели (старый volume) entrypoint не удаляет. Чтобы перекачать
заданный список: `OLLAMA_FORCE_UPDATE=true`.

## Как добавить новую модель без пересборки образа

1. **Удалённый манифест** (предпочтительно для prod):
   ```bash
   # в .env / compose
   OLLAMA_MODELS_MANIFEST_URL=https://storage.unishift.ru/models/models.manifest
   ```
   Обновили файл на storage — при следующем рестарте `ollama` подтянет новые строки.

2. **Список в env:**
   ```bash
   OLLAMA_MODELS=my-model=pull,foo=https://example.com/model.gguf
   # или GGUF:
   OLLAMA_MODELS=foo=https://example.com/model.gguf
   ```

3. Свой файл: `OLLAMA_MODELS_MANIFEST=/path/inside/container` и mount в compose.

## Переменные

| Env | Default | Смысл |
|---|---|---|
| `OLLAMA_MODELS_MANIFEST` | — | Путь к локальному файлу внутри контейнера |
| `OLLAMA_MODELS_MANIFEST_URL` | — | Remote манифест (имеет приоритет над файлом, если нет `OLLAMA_MODELS`) |
| `OLLAMA_MODELS` | — | CSV-список (высший приоритет) |
| `OLLAMA_MODEL_BASE_URL` | `https://storage.unishift.ru/models` | База для относительных `.gguf` |
| `OLLAMA_FORCE_UPDATE` | `false` | Переустановить даже если модель есть |
| `OLLAMA_SKIP_SYNC` | `false` | Не синхронизировать (только serve) |
| `OLLAMA_READY_TIMEOUT` | `120` | Секунд ждать готовности API |

Приоритет: `OLLAMA_MODELS` → `OLLAMA_MODELS_MANIFEST_URL` → `OLLAMA_MODELS_MANIFEST`. Если ничего не задано, синхронизации нет.

## Сборка и публикация

Prod-серверы — **linux/amd64**. На Apple Silicon обычный `docker build` + push
даёт только `arm64` → на Debian: `no matching manifest for linux/amd64`.

```bash
# buildx linux/amd64 + push :latest (нужен docker login)
./publish.sh

# multi-arch (amd64 + arm64)
PLATFORMS=linux/amd64,linux/arm64 ./publish.sh

# только локально (один platform)
./publish.sh --build-only

TAG=0.5.7 ./publish.sh
```

Первый старт без моделей быстрый. Если задан большой `OLLAMA_MODELS`,
скачивание идёт после `serve` и healthcheck его не ждёт.

## Эндпоинты

- OpenAI-compatible: `http://localhost:18084/v1`
- Ollama native: `http://localhost:18084/api`
