v0.20.4

sleep3r/mtproto.zigv0.20.4May 4, 2026by sleep3r

Upgrading?

AI Summary

v0.20.4 improves the reliability of the `mtbuddy setup tunnel` command by enforcing strict exit code checks during AmneziaWG installation and providing clearer diagnostics for repository connectivity issues.

Key Highlights

  • Enforced strict exit code checks for `apt` commands during AWG installation.
  • Added post-install verification for `awg` and `awg-quick` tools.
  • Improved preflight validation to distinguish missing tools from invalid configs.
  • Added guidance for Launchpad PPA outages.

New Features

  • Fail-fast on AWG install errors and clarify PPA outages

Full Release Notes

<details open>
<summary>🇷🇺 Что нового (RU)</summary>

## Что решает этот релиз

Этот релиз исправляет некорректный UX в `mtbuddy setup tunnel`, когда установка AmneziaWG могла завершаться сообщением об успехе даже при фактическом провале шагов `apt`/PPA.

Раньше ошибки установки (`add-apt-repository`, `apt update`, `apt install`) могли тихо проглатываться, а финальная проверка падала как будто проблема в самом AWG-конфиге. В итоге диагностика уводила в сторону, хотя корень был в недоступности репозитория (`ppa.launchpadcontent.net`) или неполной установке инструментов.

Теперь tunnel setup завершается корректно и с понятной причиной ошибки.

> [!NOTE]
> Изменений в пользовательской конфигурации не требуется.

## Что изменено

### Tunnel setup: fail-fast и точная диагностика установки AWG ([#226](https://github.com/sleep3r/mtproto.zig/pull/226))

- Шаги установки AmneziaWG переведены на строгую проверку exit code вместо «best-effort» выполнения.
- Для `apt update` используется режим, который считает ошибки индексов фатальными (`APT::Update::Error-Mode=any`).
- Добавлена пост-проверка, что после установки реально доступны обе утилиты: `awg` и `awg-quick`.
- Исправлена preflight-валидация: теперь явно различаются случаи «нет `awg-quick`» и «невалидный AWG/WG конфиг».
- При симптомах недоступности Launchpad PPA (`ppa.launchpadcontent.net`) показываются отдельные подсказки по повторной попытке/зеркалу.

</details>

---

<details>
<summary>🇬🇧 Release notes (EN)</summary>

## What this release addresses

This release fixes misleading tunnel setup behavior in `mtbuddy setup tunnel`, where AmneziaWG installation could be reported as successful even when `apt`/PPA steps had actually failed.

Previously, install failures (`add-apt-repository`, `apt update`, `apt install`) could be silently swallowed, and the final preflight error looked like an AWG config problem. In practice, the root cause was often repository reachability (`ppa.launchpadcontent.net`) or a partial tools install.

Tunnel setup now fails correctly with actionable diagnostics.

> [!NOTE]
> No user configuration changes are required.

## What changed

### Tunnel setup: fail-fast AWG install flow and clearer diagnostics ([#226](https://github.com/sleep3r/mtproto.zig/pull/226))

- AmneziaWG install steps now enforce exit-code checks instead of best-effort execution.
- `apt update` now uses strict index error handling (`APT::Update::Error-Mode=any`).
- Added post-install verification that both `awg` and `awg-quick` are actually present.
- Improved preflight validation to distinguish “missing `awg-quick`” from “invalid AWG/WG config”.
- Added dedicated guidance when Launchpad PPA reachability issues are detected (`ppa.launchpadcontent.net`).

</details>

## Changelog

* fix(tunnel): fail fast on AWG install errors and clarify PPA outages ([#226](https://github.com/sleep3r/mtproto.zig/pull/226)) ([a2ad347](https://github.com/sleep3r/mtproto.zig/commit/a2ad3478531bacb4e7cded8bd2dcc73422f57423))

Related Repositories