# Motrix v2.0.0-beta.21

- Product: Motrix (https://whatsnew.fyi/product/motrix)
- Vendor: agalwood
- Date: 2026-08-22
- Version: v2.0.0-beta.21
- Original notes: https://github.com/agalwood/Motrix/releases/tag/v2.0.0-beta.21
- Permalink: https://whatsnew.fyi/product/motrix/releases/v2.0.0-beta.21
- Labels: Pre-release

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **fixed** — Linux launches aria2 with a fresh CA bundle assembled from the system trust store on every run, falling back to bundled roots when necessary, fixing valid HTTPS downloads on distributions where the static engine's build-time OpenSSL paths do not exist
- **changed** — Desktop, Server, Docker, and Flatpak packages use the Motrix aria2 fork 1.37.0-motrix.6
- **changed** — Server and Docker packages carry the verified Motrix binary instead of depending on a distribution-provided aria2 executable
- **added** — Download settings offer Automatic, Balanced, High speed, Maximum, and Custom performance profiles that coordinate connections, segments, minimum segment size, and disk cache, with support for up to 64 connections per server
- **added** — Automatic performance profile applies disk-aware startup tuning
- **fixed** — Settings are saved before an engine restart is requested, with options that aria2 can apply immediately updated in place and settings requiring a restart kept as a durable reminder
- **fixed** — Connection, allocation, and cache choices remain consistent after saving and relaunching
- **added** — Application and plugin logs share a structured redaction boundary that removes secrets, credentials, cookies, request bodies, storage values, sensitive paths, and URL query data while retaining safe diagnostic context
- **added** — AppImage publishing is restored for Linux x64 and arm64 with user-controlled desktop integration
- **added** — On first AppImage launch, users may opt in to a desktop entry, icon, and motrix:, magnet:, and .torrent handlers under their own XDG data directory
- **added** — AppImage desktop integration can be enabled, repaired, or removed later from Settings
- **fixed** — Release assembly accepts electron-builder's AppImage-first source metadata, validates every referenced Linux asset, and emits DEB-based compatibility fields for the updater
- **fixed** — Tracker state cached before an engine interruption is reapplied after recovery
- **fixed** — Expected engine-shutdown errors are suppressed and NAT mappings retry after discovery
- **fixed** — Download counts follow Motrix task state
- **changed** — Windows and Linux caption controls use consistent 28px targets and align with sidebar and panel actions
- **fixed** — Toast and content safe areas account for the custom window chrome

#### Motrix 2.0.0-beta.21

English | [简体中文](https://github.com/agalwood/Motrix/blob/v2.0.0-beta.21/docs/release-notes/2.0.0-beta.21.zh-CN.md)

Motrix 2.0.0-beta.21 restores verified HTTPS downloads across Linux
distributions, adds performance profiles with up to 64 connections, makes
settings and engine recovery more reliable, redacts sensitive log data, and
returns AppImage packages with user-controlled desktop integration. It is
intended for public distribution only after every protected release gate
passes.

Beta.20 did not reach public distribution because release assembly rejected
electron-builder's valid AppImage-first Linux update metadata. Beta.21 carries
the same user-facing changes and normalizes those compatibility fields to the
DEB updater asset before final verification and publication.

##### Highlights

- Linux launches aria2 with a fresh CA bundle assembled from the system trust
  store on every run, falling back to bundled roots when necessary. This fixes
  valid HTTPS downloads on distributions where the static engine's build-time
  OpenSSL paths do not exist, without disabling certificate verification.
- Desktop, Server, Docker, and Flatpak packages use the Motrix aria2 fork
  `1.37.0-motrix.6`. Server and Docker packages carry the verified Motrix
  binary instead of depending on a distribution-provided aria2 executable.
- Download settings offer Automatic, Balanced, High speed, Maximum, and Custom
  performance profiles. They coordinate connections, segments, minimum
  segment size, and disk cache; the bundled engine supports up to 64
  connections per server and Automatic mode applies disk-aware startup tuning.
- Settings are saved before an engine restart is requested. Options that aria2
  can apply immediately are updated in place, while settings requiring a
  restart keep a durable reminder. Connection, allocation, and cache choices
  remain consistent after saving and relaunching.
- Application and plugin logs share a structured redaction boundary. Secrets,
  credentials, cookies, request bodies, storage values, sensitive paths, and
  URL query data are removed while safe diagnostic context is retained.
- AppImage publishing is restored for Linux `x64` and `arm64`. On first launch,
  users may opt in to a desktop entry, icon, and `motrix:`, `magnet:`, and
  `.torrent` handlers under their own XDG data directory; the integration can
  be enabled, repaired, or removed later from Settings.
- Release assembly accepts electron-builder's AppImage-first source metadata,
  validates every referenced Linux asset, and emits DEB-based compatibility
  fields for the updater. Final release verification remains strict.
- Tracker state cached before an engine interruption is reapplied after
  recovery. Expected engine-shutdown errors are suppressed, NAT mappings retry
  after discovery, and download counts follow Motrix task state.
- Windows and Linux caption controls use consistent 28px targets and align
  with sidebar and panel actions. Toast and content safe areas account for the
  custom window chrome.

##### Before testing

This is prerelease software. Back up existing Motrix application data and
downloads before installing it. Migration from Motrix v1 data has not yet been
validated, so do not use your only copy of v1 data with this beta.

When practical, test v2 in parallel using a separate OS account, machine, or
Docker data directory. Do not rely on this beta for your only copy of important
downloads.

##### Planned downloads after release gates pass

| Distribution | Architectures | Planned output |
|--------------|---------------|----------------|
| macOS 12 or later | `arm64` (Apple Silicon), `x64` (Intel) | DMG and ZIP |
| Windows | `x64` | Unsigned NSIS installer (`.exe`) and ZIP |
| Linux | `x64`, `arm64` | AppImage, DEB, and RPM |
| Flatpak Native Host companion | `linux/x64`, `linux/arm64` | `Motrix-Native-Host-2.0.0-beta.21-linux-<arch>.tar.gz` |
| Docker Hub / GHCR | `linux/amd64`, `linux/arm64` |

_[Truncated at 4000 characters — full notes: https://github.com/agalwood/Motrix/releases/tag/v2.0.0-beta.21]_