Skip to content

Commit 1ae9329

Browse files
committed
docs: mention super-install AppArmor auto-fix in troubleshooting
1 parent 765b502 commit 1ae9329

2 files changed

Lines changed: 27 additions & 2 deletions

File tree

README.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -348,9 +348,9 @@ If you see an error like:
348348
- `AppArmor enabled on system but the docker-default profile could not be loaded`
349349
- `apparmor_parser ... Lexer found unexpected character: '' (0x0)`
350350

351-
It usually means an AppArmor profile file contains **NUL bytes**. A known offender is:
351+
It usually means an AppArmor profile file contains **NUL bytes** (0x00), often under:
352352

353-
- `/etc/apparmor.d/tunables/home.d/ubuntu`
353+
- `/etc/apparmor.d/tunables/home.d/`
354354

355355
Fix (backup + remove NULs), then restart AppArmor and Docker:
356356

@@ -361,6 +361,8 @@ sudo systemctl restart apparmor
361361
sudo systemctl restart docker
362362
```
363363

364+
Note: `super-install.sh` includes an automatic check for this issue and tries to repair AppArmor/Docker if NUL bytes are detected.
365+
364366
### Bot won’t start
365367

366368
Most common cause: missing required env vars (Telegram token, SMTP, LDAP).

README_RU.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -341,6 +341,29 @@ Register-ScheduledTask -TaskName "Set-Ziti-DNS-On-Start" -Action $action -Trigge
341341
> Поменяй `$primary/$secondary` и `$pattern`, если у адаптера другое имя/описание.
342342
343343

344+
### Docker не запускает контейнеры: AppArmor docker-default profile could not be loaded
345+
346+
Если видишь ошибку вида:
347+
348+
- `AppArmor enabled on system but the docker-default profile could not be loaded`
349+
- `apparmor_parser ... Lexer found unexpected character: '' (0x0)`
350+
351+
Чаще всего это означает, что в одном из файлов AppArmor есть **NUL байты** (0x00), обычно в:
352+
353+
- `/etc/apparmor.d/tunables/home.d/`
354+
355+
Фикс (бэкап + убрать NUL), затем перезапустить AppArmor и Docker:
356+
357+
```bash
358+
sudo cp -a /etc/apparmor.d/tunables/home.d/ubuntu /etc/apparmor.d/tunables/home.d/ubuntu.bak.$(date +%F_%H%M%S)
359+
sudo perl -i -pe 's/\x00//g' /etc/apparmor.d/tunables/home.d/ubuntu
360+
sudo systemctl restart apparmor
361+
sudo systemctl restart docker
362+
```
363+
364+
Примечание: `super-install.sh` содержит автоматическую проверку этой проблемы и пытается починить AppArmor/Docker, если найдены NUL-байты.
365+
366+
344367
### Бот не стартует
345368

346369
Обычно причина — не заполнены обязательные переменные (`TELEGRAM_BOT_TOKEN`, SMTP, LDAP).

0 commit comments

Comments
 (0)