# local_machine — репозиторий на Gitea

Репозиторий **local_machine** на сервере Gitea (gitea.hunab.app): документация и скрипты для локальной машины.

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

### 1. Создать репозиторий на Gitea (один раз)

**Вариант А — через веб-интерфейс**

1. Открыть: https://gitea.hunab.app  
2. Войти под пользователем `hunabgit` (или своим).  
3. **New Repository** → Name: `local_machine` → Create Repository.  
4. Репо создавать **пустым** (без README / .gitignore).

**Вариант Б — через API (если есть токен)**

```bash
# Токен: Gitea → Settings → Applications → Generate New Token (write:repository, read:repository)
export GITEA_TOKEN="your_token"
bash scripts/deployment/gitea/setup-and-push.sh --create-only
```

### 2. Инициализация и первый пуш

Из корня **local_machine** (не из родительского репо):

```bash
cd /Users/eternal/code/local_machine
bash scripts/deployment/gitea/setup-and-push.sh
```

Скрипт:

- инициализирует git в `local_machine` (если ещё нет `.git`);
- добавляет `origin` (SSH или HTTPS);
- делает первый коммит и `git push -u origin main`.

### 3. Если пуш из РФ зависает

По гайду [GITEA_COMPLETE_GUIDE.md](./GITEA_COMPLETE_GUIDE.md):

- предпочтительно **SSH** (порт 2223):  
  `git remote set-url origin git@gitea.hunab.app:hunabgit/local_machine.git`  
  и снова `git push -u origin main`;
- либо использовать прокси/скрипты пуша из основного репо (bundle-метод), если они у вас настроены.

## .gitignore

В корне проекта настроен `.gitignore`, чтобы не пушить:

- системный мусор: `.DS_Store`, `Thumbs.db`;
- секреты и ключи: `.env`, `*.pem`, `*.key`, конфиги VPN с ключами (`docs/connectivity/vpn/*.conf`);
- артефакты: `node_modules/`, `__pycache__/`, `*.log`, `*.tmp`, кэши и т.п.;
- IDE/редакторы: `.idea/`, `.vscode/`, `.cursor/`.

Конфиги с приватными ключами (WireGuard и т.д.) в репозиторий не попадают.

## Дальнейшая работа

- Клонирование:  
  `git clone https://gitea.hunab.app/hunabgit/local_machine.git`  
  или по SSH:  
  `git clone git@gitea.hunab.app:hunabgit/local_machine.git`
- Обычные коммиты и пуш:  
  `git add ... && git commit -m "..." && git push origin main`

Полный гайд по Gitea (пуши, SSH, bundle, из РФ): [GITEA_COMPLETE_GUIDE.md](./GITEA_COMPLETE_GUIDE.md).