# Nextcloud

Self-hosted файловое облако с веб-интерфейсом, мобильным и десктопным клиентами. Поддерживает интеграцию с PostgreSQL, Redis для кэширования и автоматический cron.

## Быстрый старт

```yaml
# group_vars/all/addons.yml
addon_nextcloud: true
nextcloud_ingress_host: "nextcloud.example.com"
nextcloud_ingress_tls: true
```

Секреты в `vault.yml`:
```yaml
vault_nextcloud_admin_password: "secure-password"
vault_nextcloud_db_password: "db-password"   # если addon_postgresql: true
```

```bash
make addon-nextcloud
```

## Параметры

| Переменная | Умолч. | Описание |
|---|---|---|
| `nextcloud_admin_username` | `admin` | Логин администратора |
| `nextcloud_ingress_host` | `nextcloud.local` | Hostname |
| `nextcloud_storage_size` | `20Gi` | PVC для файлов |
| `nextcloud_redis_enabled` | `true` | Redis для кэша (встроенный) |
| `nextcloud_cronjob_enabled` | `true` | Автоматический cron |

## Интеграция с PostgreSQL

Выбор задаётся переменной `nextcloud_database_mode`:
- `auto` — внешняя PostgreSQL при `addon_postgresql: true`, иначе встроенная SQLite;
- `sqlite` — всегда встроенная SQLite;
- `external_postgresql` — всегда внешняя PostgreSQL (аддон `postgresql` или совместимый внешний сервис).

По умолчанию в аддоне стоит `nextcloud_database_mode: external_postgresql` (приоритет PostgreSQL).

## Подключение клиентов

Настройки для Nextcloud Desktop/Mobile:
- **Сервер:** `https://nextcloud.example.com`
- **Логин:** admin

## WebDAV

```
https://nextcloud.example.com/remote.php/dav/files/USERNAME/
```

## Монтирование через WebDAV (Linux)

```bash
sudo mount -t davfs https://nextcloud.example.com/remote.php/dav/files/admin/ /mnt/nextcloud
```

## Внешние хранилища

В Nextcloud Admin → External Storages можно подключить:
- S3/MinIO
- SFTP
- WebDAV
- NFS

## occ — Nextcloud CLI

```bash
kubectl exec -n nextcloud deployment/nextcloud -- \
  php occ status

kubectl exec -n nextcloud deployment/nextcloud -- \
  php occ user:list

kubectl exec -n nextcloud deployment/nextcloud -- \
  php occ files:scan --all
```

## Диагностика

```bash
kubectl logs -n nextcloud deployment/nextcloud -f
kubectl exec -n nextcloud deployment/nextcloud -- php occ check
```
## Официальные ресурсы

- Официальный сайт: [https://nextcloud.com/](https://nextcloud.com/)
- Официальная документация: [https://docs.nextcloud.com/](https://docs.nextcloud.com/)
- Версии Helm chart / ПО: [https://artifacthub.io/packages/helm/nextcloud/nextcloud](https://artifacthub.io/packages/helm/nextcloud/nextcloud)