Initial homelab docs

Co-authored-by: Cursor <cursoragent@cursor.com>

homelab/gitea/README.md

@@ -0,0 +1,138 @@
+# Gitea + Gitea Actions на CT 103
+
+LXC 103: 192.168.1.103, 1 core, 2 GB RAM, 15 GB диск (local-lvm).  
+Доступ: только LAN, без домена.
+
+## 1. Создание LXC 103 на Proxmox
+
+Выполнять на хосте **192.168.1.150** (ssh root@192.168.1.150).
+
+### 1.1. Шаблон (если ещё нет)
+
+Проверить доступные шаблоны и при необходимости скачать Debian 12:
+
+```bash
+pveam available | grep debian-12
+pveam download local debian-12-standard_12.7-1_amd64.tar.zst
+# или актуальный из списка pveam available
+pveam list local
+```
+
+Имя шаблона для `pct create` — как в `pveam list local`, например: `local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst`.
+
+### 1.2. Создать контейнер
+
+**Важно:** шлюз `gw=192.168.1.1` — поправь, если у тебя другой (например роутер на .1).
+
+```bash
+pct create 103 local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst \
+  --hostname gitea \
+  --cores 1 \
+  --memory 2048 \
+  --swap 512 \
+  --rootfs local-lvm:15 \
+  --net0 name=eth0,bridge=vmbr0,ip=192.168.1.103/24,gw=192.168.1.1 \
+  --features nesting=1 \
+  --onboot 1 \
+  --start 1
+```
+
+`nesting=1` нужен для Docker внутри LXC.
+
+### 1.3. Проверить хранилище
+
+Если твоё хранилище называется иначе (не `local-lvm`):
+
+```bash
+pvesm status
+```
+
+Если корневой диск на другом storage — замени в команде `--rootfs local-lvm:15` на свой, например `--rootfs SSD:15`.
+
+---
+
+## 2. В контейнере 103: Docker и Gitea
+
+### 2.1. Войти в контейнер
+
+```bash
+pct enter 103
+```
+
+### 2.2. Установить Docker
+
+```bash
+apt update && apt install -y ca-certificates curl
+install -m 0755 -d /etc/apt/keyrings
+curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
+chmod a+r /etc/apt/keyrings/docker.asc
+echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian bookworm stable" > /etc/apt/sources.list.d/docker.list
+apt update && apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
+```
+
+### 2.3. Развернуть Gitea
+
+Файлы из репозитория (`homelab/gitea/`) нужно положить в контейнер в `/opt/gitea/`. С хоста Proxmox, если репо уже есть на хосте:
+
+```bash
+pct exec 103 -- mkdir -p /opt/gitea
+pct push 103 /path/на/хосте/к/homelab/gitea/docker-compose-103.yml /opt/gitea/docker-compose.yml
+pct push 103 /path/на/хосте/к/homelab/gitea/.env.example /opt/gitea/.env.example
+```
+
+В контейнере:
+
+```bash
+mkdir -p /opt/gitea
+cd /opt/gitea
+# положить docker-compose-103.yml как docker-compose.yml и .env.example как .env
+cp .env.example .env
+# пока токен пустой — раннер не зарегистрируется, это нормально
+docker compose up -d
+```
+
+### 2.4. Первый запуск Gitea
+
+1. В браузере: **http://192.168.1.103:3000**
+2. Пройти установку (админ, пароль, остальное по желанию).
+3. После входа: **Администрирование** → **Actions** → **Runners** → скопировать **Registration token**.
+4. В контейнере в `/opt/gitea/.env` прописать:
+   ```bash
+   GITEA_RUNNER_REGISTRATION_TOKEN=вставь_токен_сюда
+   ```
+5. Перезапустить раннер:
+   ```bash
+   cd /opt/gitea && docker compose up -d runner
+   ```
+
+Раннер должен появиться в **Actions → Runners** со статусом «Online».
+
+---
+
+## 3. Полезные команды (с хоста 192.168.1.150)
+
+```bash
+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 server'
+```
+
+---
+
+## 4. Homepage (контейнер 100)
+
+Добавить в `/opt/docker/homepage/config/services.yaml` запись для Gitea (в нужную группу), например:
+
+```yaml
+- Gitea:
+    icon: gitea.png
+    href: http://192.168.1.103:3000
+    description: Git-сервер (LAN)
+    widget:
+      type: iframe
+      url: http://192.168.1.103:3000
+```
+
+Иконку `gitea.png` при необходимости положить в каталог иконок Homepage.
+
+Готовый фрагмент для вставки: [homepage-services-snippet.yaml](homepage-services-snippet.yaml).