# Проблемы и решения

#### Ошибка: "Обновление уже запущено"

**Причина**: Предыдущий процесс обновления еще не завершен или завис.

**Решение**:

```bash
# Проверьте статус процесса
cat cache/update.txt

# Если процесс завис (прошло более 30 минут), очистите кеш
rm -f cache/update*
```

***

#### Ошибка: "Недостаточно места на диске"

**Причина**: Не хватает места для создания бекапа или загрузки новой версии.

**Решение**:

```bash
# Проверьте свободное место
df -h

# Очистите старые бекапы (оставьте 2-3 последних)
rm -rf Files/update/старый_код/

# Очистите логи старше 30 дней
find Files/logs/ -name "*.log" -mtime +30 -delete
```

{% hint style="info" %}
Рекомендуется иметь свободного места минимум в 2 раза больше размера вашего проекта.
{% endhint %}

***

#### Ошибка: "Failed to create update process directory"

**Причина**: Недостаточно прав для записи в директорию `Files/`.

**Решение**:

```bash
# Установите правильного владельца
chown -R www-data:www-data /var/www/your-site

# Установите права на директорию Files
chmod 775 Files/
chmod 775 Files/update/
chmod 775 Files/logs/
chmod 775 Files/cache/
```

***

#### Ошибка: "GitHub API rate limit exceeded"

**Причина**: Превышен лимит запросов к GitHub API.

**Решение**:

1. Убедитесь, что используется токен авторизации в `Library/configs/github.json`
2. С токеном лимит: 5000 запросов/час
3. Без токена: только 60 запросов/час
4. Подождите час или используйте токен

**Как создать GitHub токен**:

1. Откройте <https://github.com/settings/tokens>
2. Нажмите "Generate new token (classic)"
3. Выберите scope: `public_repo`
4. Скопируйте токен и добавьте в конфигурацию

***

#### Ошибка: "ZIP file corrupted"

**Причина**: Файл релиза был поврежден при загрузке.

**Решение**:

```bash
# 1. Удалите поврежденный файл
rm Files/update/{код процесса}/*.zip

# 2. Очистите кеш
rm -f cache/update*

# 3. Запустите обновление заново
```

***

#### Ошибка: "PHP version error"

**Причина**: Установлена устаревшая версия PHP.

**Решение**:

```bash
# Проверьте текущую версию
php -v

# Обновите PHP до версии 7.4.33 или выше
# Для Ubuntu/Debian:
sudo apt update
sudo apt install php7.4

# Для CentOS/RHEL:
sudo yum install php74
```

***

#### Ошибка: "PHP version error"

**Причина**: Установлена некорректная версия PHP.

**Решение**: Установите PHP версии 7.4.33
