homelab-docs/homelab/containers-context.md

Контекст по контейнерам (Proxmox LXC)

Общая схема

ID	Назначение	IP	Заметки
100	NPM, Homepage, лог-дашборд	192.168.1.100	Шлюз/дашборды
101	Nextcloud	192.168.1.101	—
103	Gitea	192.168.1.103	Gitea + PostgreSQL + act_runner (Gitea Actions). Порт 3000, SSH 2222.
104	Paperless-ngx	192.168.1.104	docs.katykhin.ru
107	Invidious	192.168.1.107	video.katykhin.ru
108	Galene	192.168.1.108	call.katykhin.ru
200	Immich (VM)	192.168.1.200	KVM, immich.katykhin.ru

Хост Proxmox: 192.168.1.150
Вход на контейнеры — с хоста через pct exec <ID> -- ... или pct enter <ID>.

---

CT 101 — Nextcloud

Как попасть

1. С твоей машины на хост Proxmox:

   ssh root@192.168.1.150
   

   (пароль хоста — у тебя)

2. С хоста — в контейнер 101:

   pct enter 101
   

   Либо выполнить одну команду без входа в shell:

   pct exec 101 -- <команда>
   

   (пароль root в CT 101 — если включён и задан; часто тот же, что на хосте, или без пароля при pct enter с хоста)

3. По сети (веб):

   • Внутри сети: http://192.168.1.101:8080
   • Снаружи: https://cloud.katykhin.ru (прокси через NPM на 100).

Что внутри CT 101

• Docker Compose с тремя сервисами:

  • nextcloud — порт 8080:80
  • db — PostgreSQL 16
  • redis — кэш/очереди

• Рабочая директория Compose: /opt/nextcloud
  Файл в репо: homelab/nextcloud/docker-compose-101.yml — на сервере обычно как docker-compose.yml в /opt/nextcloud.

• Systemd-сервис: docker-nextcloud.service
  Запуск/остановка: из контейнера 101:

   systemctl start docker-nextcloud   # или restart/stop
  

  Либо вручную:

  cd /opt/nextcloud && docker compose up -d
  

Креды (из репозитория)

• PostgreSQL (внутри CT 101):

  • DB: nextcloud
  • User: nextcloud
  • Password: nextcloud
    (из docker-compose-101.yml)

• Nextcloud (приложение):
  Подключается к БД теми же кредыми. Админ-пользователь Nextcloud (логин/пароль веб-интерфейса) задаётся при первом запуске в UI — в репо не хранятся.

• Redis: без пароля (только внутри Docker-сети).

Пути и конфиги внутри CT 101

• Данные PostgreSQL: /mnt/nextcloud-data/pgdata
• Данные Nextcloud (файлы, конфиг): /mnt/nextcloud-data/html
• Доп. том: /mnt/nextcloud-extra
• PHP uploads: /opt/nextcloud/php-uploads.ini (лимиты 64G, 2G memory и т.д. — см. homelab/nextcloud/php-uploads.ini)

Полезные команды (на хосте 192.168.1.150)

# Войти в CT 101
pct enter 101

# Логи Nextcloud
pct exec 101 -- bash -c 'cd /opt/nextcloud && docker compose logs -f nextcloud'

# Статус контейнеров
pct exec 101 -- docker ps

# Перезапуск стека Nextcloud
pct exec 101 -- bash -c 'cd /opt/nextcloud && docker compose restart'

Чего нет в репо (нужны тебе локально)

• Пароль root на Proxmox (192.168.1.150)
• Пароль root в CT 101 (если включён логин по паролю)
• Логин/пароль админа Nextcloud (веб-интерфейс)

---

CT 103 — Gitea

Как попасть

1. С хоста Proxmox: pct enter 103 или pct exec 103 -- <команда>.
2. По сети (веб): http://192.168.1.103:3000 (только LAN, домен не настроен).

Что внутри CT 103

• Docker Compose в /opt/gitea (файл в репо: homelab/gitea/docker-compose-103.yml):

  • server — Gitea, порты 3000 (HTTP), 2222 (SSH)
  • db — PostgreSQL 16 (Alpine)
  • runner — act_runner (Gitea Actions), использует Docker хоста

• Токен регистрации раннера задаётся в .env (см. homelab/gitea/.env.example). Получить: Администрирование → Actions → Runners → Registration token.

Полезные команды (на хосте 192.168.1.150)

pct enter 103
pct exec 103 -- bash -c 'cd /opt/gitea && docker compose ps'
pct exec 103 -- bash -c 'cd /opt/gitea && docker compose logs -f runner'

Создание контейнера 103

Инструкция и параметры (LXC 103, 1 core, 2 GB RAM, 15 GB на local-lvm, IP 192.168.1.103): см. homelab/gitea/README.md.